Skip to content
logiccloud orchestrate

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.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string format: uuid

Device UUID

Header Parameters

Section titled “Header Parameters”
x-organization-id
string format: uuid

UUID of the organization (tenant) the request acts in. It selects the tenant and grants nothing: the server checks membership or an open tenant switch. Not needed for global operations. A malformed value returns 400. API keys are fixed to their own organization; another organization returns 403. The x-organization-source header grants nothing.

Responses

Section titled “Responses”

200

Section titled “200”

Latest telemetry retrieved successfully

Media typeapplication/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
agentUptimeSeconds

Agent process uptime in seconds (absent for agents that do not report it)

object
restartCount

Number of restarts

object
containersRunning

Running containers count

object
containersFailed

Failed containers count

object
errorCount

Error count in the aggregation window

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

403

Section titled “403”

Forbidden — caller lacks required permission

404

Section titled “404”

Device not found or no telemetry data