Skip to content

Get latest device telemetry

GET
/api/v1/devices/{id}/telemetry/latest
curl --request GET \
--url http://localhost:3000/api/v1/devices/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/telemetry/latest \
--header 'X-API-Key: <X-API-Key>'

Retrieves the most recent metric snapshot with computed percentages.

id
required
string format: uuid

Device UUID

Latest telemetry retrieved successfully

Media type application/json
object
id
required

Snapshot ID

string
deviceId
required

Device ID

string
timestamp
required

Timestamp of the snapshot

string
cpuUsagePercent

CPU usage percentage (0-100)

object
memoryUsedBytes

Memory used in bytes

object
memoryTotalBytes

Memory total in bytes

object
memoryUsagePercent

Memory usage percentage (computed)

object
diskUsedBytes

Disk used in bytes

object
diskTotalBytes

Disk total in bytes

object
diskUsagePercent

Disk usage percentage (computed)

object
uptimeSeconds

System uptime in seconds

object
restartCount

Number of restarts

object
containersRunning

Running containers count

object
containersFailed

Failed containers count

object
errorCount

Error count in the aggregation window

number
Example generated
{
"id": "example",
"deviceId": "example",
"timestamp": "example",
"cpuUsagePercent": {},
"memoryUsedBytes": {},
"memoryTotalBytes": {},
"memoryUsagePercent": {},
"diskUsedBytes": {},
"diskTotalBytes": {},
"diskUsagePercent": {},
"uptimeSeconds": {},
"restartCount": {},
"containersRunning": {},
"containersFailed": {},
"errorCount": 1
}

Forbidden — caller lacks required permission

Device not found or no telemetry data