Telemetry Frame
A Telemetry Frame is one position and sensor sample from an Asset during a Flight Session. Logical identity is (asset_uuid, session_uuid, sequence_number). event_id is for correlation only and is not the deduplication key.
Role in the platform
Frames are ingested over the telemetry wire (MQTT or WebSocket), validated, stored, and fan out to realtime and metrics consumers. Producers authenticate with the asset certificate and session token. See the Telemetry wire contract for transport rules.
Core fields
| Field | Description |
|---|---|
asset_uuid / session_uuid | Asset and session binding |
sequence_number | Per-session sequence; part of logical identity |
event_id | Unique per frame for correlation |
schema_version | Producer schema version |
timestamp | Device capture time |
received_at | Server ingest stamp |
asset_uin | UIN echoed on the frame |
latitude / longitude / altitude_agl | Position and AGL altitude |
absolute_altitude | Optional absolute altitude |
heading | Optional heading |
speeds | Speed group: horizontal/vertical, NED velocities, airspeed, groundspeed, climb |
attitude | Attitude group: roll, pitch, yaw and rates |
battery | Battery group: voltage, current, remaining percent, temperature |
gps | GPS group: fix type and satellites visible |
is_armed / is_in_air | Armed and in-air flags |
flight_mode / status_text | Mode and status text |
Related operational tables
Supporting ingest and consumer state (field names summarised):
- Ingest receipts:
asset_uuid,session_uuid,sequence_number,event_id,schema_version,disposition,resolved_at - Quarantined frames:
asset_uuid,session_uuid,sequence_number,disposition,reason,payload,quarantined_at - Ingest attempts:
asset_uuid,session_uuid,sequence_number,payload,attempt_count,first_attempted_at,last_attempted_at,last_error - Consumer progress:
consumer_family,session_uuid,last_sequence,updated_at - Flight metrics:
session_uuid,total_distance_km,max_altitude_agl,last_latitude,last_longitude,min_recorded_at,max_recorded_at,updated_at - Session acks:
asset_uuid,session_uuid,highest_contiguous_sequence,updated_at
Related APIs
Last updated on