Get telemetry
get_telemetryRead-onlyIdempotent
Retrieve time-ordered sensor readings for any device over a specified time window, with optional pagination and step size.
Instructions
Return time ordered sensor readings for one device across a time window.
Inputs: device_id (required), start and end (epoch ms, optional, default last 15 minutes), step_ms (default 30000), limit and offset for pagination, response_format. Returns { device_id, start, end, step_ms, total, count, offset, has_more, next_offset?, readings: [{ timestamp, temperature_c, vibration_mm_s, state }] }. Read only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Window end (epoch ms). Defaults to now. | |
| limit | No | Max readings returned (pagination). | |
| start | No | Window start (epoch ms). Defaults to end minus 15 minutes. | |
| offset | No | Readings to skip (pagination). | |
| step_ms | No | Sampling step in milliseconds (1000 to 3600000). | |
| device_id | Yes | Device id, for example 'press-01'. Call list_devices for valid ids. | |
| response_format | No | Text output format: 'markdown' (default, human readable) or 'json'. | markdown |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | ||
| count | Yes | ||
| start | Yes | ||
| total | Yes | ||
| offset | Yes | ||
| step_ms | Yes | ||
| has_more | Yes | ||
| readings | Yes | ||
| device_id | Yes | ||
| next_offset | No |