Sensorclouds Docs
Telemetry

Field Discovery

How Sensorclouds automatically discovers and registers telemetry fields

When a device sends telemetry data, the platform automatically discovers and registers the data fields. You don't need to define a schema upfront.

Image placeholder: Screenshot of the discovered fields list with types

How It Works

  1. A new telemetry message arrives with payload: {"temp": 25, "hum": 60}
  2. The platform checks the field registry for temp and hum
  3. If a field doesn't exist, it creates a new entry:
    • Field Name: temp
    • Field Type: number (auto-detected)
    • First Seen: Current timestamp
    • Sample Value: 25
  4. On subsequent messages, the Last Seen timestamp is updated

Field Schema

Each discovered field has the following metadata:

PropertyDescription
Field NameThe key from the JSON payload
Field TypeAuto-detected: number, string, or boolean
UnitOptional unit of measurement (editable)
Display NameHuman-readable name (editable)
Is HiddenCan hide fields from the UI
First SeenWhen the field was first observed
Last SeenWhen the field was most recently received

Use in Widgets

Dashboard widgets use discovered fields for data source selection:

  • When configuring a widget, you select from available fields in a dropdown
  • Only fields that have been received at least once appear in the list
  • Field types help determine appropriate widget types (e.g., numbers for gauges and charts)

If a new field doesn't appear in widget configuration, make sure the device has sent at least one message containing that field.

On this page