udmi

UDMI / Docs / Specs / Onboarding

Onboarding

Onboarding is defined as the overall flow required to have on-prem building devices properly feeding telemetry into a backend data pipeline. This consists of three main separable phases, each with a distinct role and function:

• Discovery: Discovering what devices are actually on-prem, and what capabilities they have.
• Mapping: Figuring out how actual on-prem components should be mapped into higher-level semantic concepts.
• Provisioning: Setting up various system registries and device configuration to operate properly within the target system.

As an analogy, these phases correspond to biological eyes (discovery), brain (mapping), and arms (provisioning), and fall into the simple see, think, do adage: First you see something, then you think about it, and then you do something about it.

Once completed, Onboarding enables the flow of Pointset data, the ‘phase’ of actually sending pointset telemetry from the on-prem devices to the actual pipeline. The ultimate goal!

Architectural Flow

Each of these steps can be applied individually, and the continuous application of all of them together constitutes automation, which is a key step towards enabling highly maintainable systems. The absence of each is also indicative of certain specific failure modes:

flowchart LR
  D[Devices]
  A[Agent]
  P[Pipeline]
  D -- Pointset --> P
  D -- Discovery --> A
  A -- Provisioning --> P
  A -- Mapping --> A

• Without discovery, the backend system might not actually reflect reality. The on-prem devices and capabilities might be different than what is expected to be there!
• Without mapping, the whole system is formulaic and is only exactly what it’s told to be. This means at some point, somebody needs to type in exactly what everything is.
• Without provisioning, nothing can change in the system, and essentially requires again somebody to go around and manually do things to make it all work.

This site is open source. Improve this page.