Telemetry

Telemetry is a time series of numeric samples per device and channel, such as battery.percent or drive.motor_temp_c. Samples are stored as events and can be queried from Analytics alongside everything else.

Channels

A channel name is lower case, dot-separated, and ends with its unit where one applies: _c for Celsius, _v for volts, _a for amps, _mps for metres per second. Units in the name make dashboards readable and prevent mixing units by accident.

Sample rates

The default upload rate is 1 Hz per channel. On Pro and Enterprise you can raise it to 100 Hz for channels that need it, such as vibration. The edge agent downsamples by averaging over each interval, and keeps the minimum and maximum, so short spikes are not lost.

Thresholds

Thresholds are evaluated at the edge on every raw sample, not on the downsampled stream.

channel: drive.motor_temp_c
threshold:
  above: 60.0
  hysteresis: 2.0
  for_seconds: 5

This fires telemetry.threshold_breached when the value stays above 60.0 for five seconds, and telemetry.threshold_cleared only when it falls below 58.0. Hysteresis prevents a value hovering at the limit from producing hundreds of alerts.

Query telemetry

curl "https://api.consciouslab.xyz/v1/robotics/telemetry?device=AMR-0398&channel=drive.motor_temp_c&from=2026-10-17T08:00:00Z&step=60s" \
  -H "Authorization: Bearer $CL_API_KEY"

{
  "device": "AMR-0398",
  "channel": "drive.motor_temp_c",
  "step": "60s",
  "points": [
    { "t": "2026-10-17T08:00:00Z", "avg": 45.8, "min": 45.1, "max": 46.4 },
    { "t": "2026-10-17T08:01:00Z", "avg": 46.0, "min": 45.3, "max": 46.9 }
  ]
}

step accepts 1s to 1d. Queries return at most 10,000 points; widen the step for longer ranges.

Retention

Raw samples are kept for 30 days. One-minute aggregates are kept for 13 months on Pro and indefinitely on Enterprise. Live streams over WebSocket are available at wss://api.consciouslab.xyz/v1/robotics/telemetry/stream.