Skip to main content

Telemetry

Devices may emit events which are then processed and stored by Nexigon Hub.

Emit an events

Usage: nexigon-agent events emit [OPTIONS] <BODY>

Arguments:
  <BODY>  Event body

Options:
      --severity <SEVERITY>     Event severity [default: info]
      --category <CATEGORY>     Event category
      --attribute <ATTRIBUTES>  Event attribute
  -h, --help                    Print help

The body of an event is an arbitrary JSON object.

Each event has one of the following severities:

  • Trace: For low-level tracing events.
  • Debug: For debugging events.
  • Info: For informational events.
  • Warning: For events that indicate a potential problem.
  • Error: For events that indicate a problem.
  • Critical: For events that indicate a critical problem.

The event category is a low-cardinality string that can be used to group and classify events.

info

Events are currently immediately sent to Nexigon and are not subject to buffering, e.g., when the device is offline. In the future, we plan to introduce a buffering mechanism to ensure that events are delivered exactly once.