DeviceTelemetryRecordUpdated
Parameter N represents name of telemetry measurement and D is type for such measurement defined in common/devices repository.
Payload
| Field | Type | Required | Description |
|---|---|---|---|
deviceIdentityHash | string | ✅ | Server-generated unique identifier of the device, used as the public-facing identifier in the REST API. |
owner | object | ✅ | Ownership envelope identifying the company or organization that owns this event. |
owner.ownershipType | "organization" (literal) | ✅ | Discriminator for the ownership envelope; always organization for these events. |
owner.organizationUid | string | ✅ | UID of the organization that owns the event. |
owner.parentCompanyUid | string | ✅ | UID of the owning organization's parent company. |
type | "Device.Telemetry.DeviceTelemetryRecordUpdated" (literal) | ✅ | Fully-qualified event type discriminator (e.g. Device.DeviceConnectionAdded). |
name | "VOLUME" | "BRIGHTNESS" | "TIMERS" | "PROPRIETARY_TIMERS" | "RESOLUTION" | "ORIENTATION" | "REMOTE_CONTROL" | "APPLICATION_VERSION" | "FIRMWARE_VERSION" | "DEBUG" | "DATETIME" | "POWER_ACTIONS_SCHEDULE" | "TEMPERATURE" | "BUNDLED_APPLET" | "AUTO_RECOVERY" | "PEER_RECOVERY" | "PROXY" | "WIFI_STRENGTH" | "FRONT_CAPABILITIES" | "MANAGEMENT_CAPABILITIES" | "DISPLAY_SETTING" | "INPUT_SOURCE" | "FRONT_DISPLAY_VERSION" | "OFFLINE_RANGE" | "ONLINE_STATUS" | "CONNECTION_METHOD" | "EXTENDED_MANAGEMENT" | "EXTENDED_CONTROL" | "NETWORK_INTERFACES" | "DISPLAY_POWER_ON" | "STORAGE" | "APP_MODULES" | "FEATURE_FLAGS" | "CRYPTOGRAPHIC_KEY" | "APPLET" | "PLUGIN" | "RUNNER" | "RUNNER_CUSTOM" | "CPU_USAGE" | "MEMORY_USAGE" | "INSTALLED_PACKAGES" | "CLIENT_PUBLIC_IP" | "SUPRA" (literal) | ✅ | Telemetry measurement name; determines the shape of data. |
data | object | object[] | "ws" | "http" | null | ✅ | Measurement payload; its shape is determined by name (see MonitoringLogData). |
Example
{
"id": "string",
"kind": "telemetry",
"type": "Device.Telemetry.DeviceTelemetryRecordUpdated",
"payload": {
"deviceIdentityHash": "6a29edcfxxxxxxxxxxxxxxxxf03ddfe5",
"owner": {
"ownershipType": "organization",
"organizationUid": "be06ecdbxxxxxxxxxxxxxxxx34dc89ca",
"parentCompanyUid": "68c78013xxxxxxxxxxxxxxxxbd70e6ba"
},
"type": "Device.Telemetry.DeviceTelemetryRecordUpdated",
"name": "VOLUME",
"data": "string"
}
}
Shape
{
"id": "string",
"kind": "telemetry",
"type": "Device.Telemetry.DeviceTelemetryRecordUpdated",
"payload": {
"deviceIdentityHash": "string",
"owner": {
"ownershipType": "organization",
"organizationUid": "string",
"parentCompanyUid": "string"
},
"type": "Device.Telemetry.DeviceTelemetryRecordUpdated",
"name": "VOLUME | BRIGHTNESS | TIMERS | PROPRIETARY_TIMERS | RESOLUTION | ORIENTATION | REMOTE_CONTROL | APPLICATION_VERSION | FIRMWARE_VERSION | DEBUG | DATETIME | POWER_ACTIONS_SCHEDULE | TEMPERATURE | BUNDLED_APPLET | AUTO_RECOVERY | PEER_RECOVERY | PROXY | WIFI_STRENGTH | FRONT_CAPABILITIES | MANAGEMENT_CAPABILITIES | DISPLAY_SETTING | INPUT_SOURCE | FRONT_DISPLAY_VERSION | OFFLINE_RANGE | ONLINE_STATUS | CONNECTION_METHOD | EXTENDED_MANAGEMENT | EXTENDED_CONTROL | NETWORK_INTERFACES | DISPLAY_POWER_ON | STORAGE | APP_MODULES | FEATURE_FLAGS | CRYPTOGRAPHIC_KEY | APPLET | PLUGIN | RUNNER | RUNNER_CUSTOM | CPU_USAGE | MEMORY_USAGE | INSTALLED_PACKAGES | CLIENT_PUBLIC_IP | SUPRA",
"data": {
"anyOf": [
{
"volume": "number"
},
{
"brightness": "number"
},
[
{
"type": "TIMER_1 | TIMER_2 | TIMER_3 | TIMER_4 | TIMER_5 | TIMER_6 | TIMER_7",
"volume": "number",
"weekdays": [
"SUNDAY | MONDAY | TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY"
],
"timeOn": "string | null",
"timeOff": "string | null"
}
],
[
{
"type": "string",
"weekdays": [
"SUNDAY | MONDAY | TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY"
],
"timeOn": "string | null",
"timeOff": "string | null",
"keepAppletRunning?": "boolean"
}
],
{
"width": "number",
"height": "number",
"framerate?": "number"
},
{
"orientation": "PORTRAIT | LANDSCAPE | PORTRAIT_FLIPPED | LANDSCAPE_FLIPPED | AUTO",
"videoOrientation?": "LANDSCAPE | LANDSCAPE_FLIPPED"
},
{
"enabled": "boolean"
},
{
"version": "string",
"versionNumber?": "number"
},
{
"version": "string"
},
{
"appletEnabled": "boolean",
"nativeEnabled": "boolean"
},
{
"timezone": "string | null",
"ntpServer": "string | null"
},
[
{
"time": "string",
"weekdays": [
"SUNDAY | MONDAY | TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY"
],
"uid": "string",
"powerType": "APP_RESTART | SYSTEM_REBOOT | APPLET_RELOAD | APPLET_REFRESH | DISPLAY_POWER_ON | DISPLAY_POWER_OFF | BACKUP_RESTART | APPLET_ENABLE | APPLET_DISABLE | FILE_SYSTEM_WIPEOUT | REAPPLY_POLICY"
}
],
{
"temperature": "number"
},
{
"appletUid": "string",
"appletVersion": "string",
"config": "object"
},
"null",
{
"enabled": true,
"healthcheckIntervalMs": "number"
},
{
"enabled": false,
"autoEnableTimeoutMs?": "number"
},
{
"enabled": true,
"urlLauncherAddress": "string"
},
{
"enabled": false,
"autoEnableTimeoutMs": "number"
},
{
"enabled": "boolean",
"uri": "string | null"
},
{
"strength": "number"
},
{
"capable": [
"FILE_SYSTEM_INTERNAL_STORAGE | FILE_SYSTEM_EXTERNAL_STORAGE | FILE_SYSTEM_FILE_CHECKSUM | FILE_SYSTEM_LINK | TIMERS_PROPRIETARY | VIDEO_4K | SERIAL | BARCODE_SCANNER | FRONT_OSD | SUPRA | FILE_SYSTEM_CREATE_ARCHIVE | FILE_SYSTEM_ARCHIVE_EXTRACT_INFO | BROWSER | PROXIMITY_SENSOR"
]
},
{
"capable": [
"MODEL | SERIAL_NUMBER | BRAND | OS_VERSION | BATTERY_STATUS | STORAGE_UNITS | TEMPERATURE | SCREENSHOT_UPLOAD | NETWORK_INFO | WIFI | WIFI_SCAN | WIFI_AP | WIFI_STRENGTH | TIMERS_PROPRIETARY | BRIGHTNESS_SCHEDULING | TIMERS_NATIVE | SET_BRIGHTNESS | GET_BRIGHTNESS | SCREEN_RESIZE | SET_TIME | SET_TIMEZONE | GET_TIMEZONE | NTP_TIME | APP_UPGRADE | FIRMWARE_UPGRADE | PACKAGE_INSTALL | NOTIFY_INSTALLED_PACKAGES | SET_VOLUME | GET_VOLUME | SET_REMOTE_CONTROL_ENABLED | SET_DEBUG | SYSTEM_REBOOT | APP_RESTART | DISPLAY_POWER | SERVLET | HARDWARE_LED_SET_COLOR | PROXIMITY_SENSOR | FACTORY_RESET | ORIENTATION_LANDSCAPE | ORIENTATION_PORTRAIT | ORIENTATION_LANDSCAPE_FLIPPED | ORIENTATION_PORTRAIT_FLIPPED | ORIENTATION_AUTO | SCHEDULE_POWER_ACTION | EXTENDED_MANAGEMENT | SYSTEM_CPU | SYSTEM_MEMORY | PROXY | AUTO_RECOVERY | PEER_RECOVERY | FILE_SYSTEM_WIPEOUT | REMOTE_DESKTOP | HOTEL_MODE | VPN | CUSTOM_SCRIPTS | NATIVE_COMMANDS_MDC | DEVICE_OWNER | ACCESSIBILITY_SERVICE | DISPLAY_MANAGER | SECRETS | HARDWARE_ACCELERATION | WIFI_COUNTRY | STOP_PACKAGE | PLUGINS | RUNNERS | NATIVE_COMMANDS_NMC | ADB_SHELL | ROOT_SHELL | WIFI_ENTERPRISE | CLEAR_PACKAGE_DATA | ANDROID_REMOVE_ACCOUNTS | EXTENDED_CONTROL | SEND_UDP | KEEP_APPLET_RUNNING"
]
},
{
"backlight": "number",
"contrast": "number",
"sharpness": "number",
"maxTemperature": "number"
},
{
"inputSource": "urlLauncher | hdmi1 | hdmi2 | hdmi3 | hdmi4 | string"
},
{
"version": "string",
"versionNumber": "number"
},
{
"since": "string (date-time)",
"until": "string (date-time)"
},
{
"online": "boolean"
},
"ws | http | null",
{
"url": "string | null"
},
{
"configurations": [
{
"brand": "string",
"settings": "object"
}
]
},
[
{
"anyOf": [
{
"type": "wifi",
"name": "string",
"macAddress": "string",
"disabled?": "boolean",
"gateway?": "string",
"localAddress?": "string",
"netmask?": "string",
"dns?": [
"string"
],
"wifiStrength?": "number",
"wifiSsid?": "string"
},
{
"type": "ethernet",
"name": "string",
"macAddress": "string",
"disabled?": "boolean",
"gateway?": "string",
"localAddress?": "string",
"netmask?": "string",
"dns?": [
"string"
]
},
{
"type": "vpn",
"name": "string",
"macAddress": "string",
"disabled?": "boolean",
"gateway?": "string",
"localAddress?": "string",
"netmask?": "string",
"dns?": [
"string"
]
},
{
"type": "mobile",
"name": "string",
"macAddress": "string",
"disabled?": "boolean",
"gateway?": "string",
"localAddress?": "string",
"netmask?": "string",
"dns?": [
"string"
]
}
]
}
],
{
"powerOn": "boolean"
},
{
"storageUnits": [
{
"type": "string",
"capacity": "number",
"freeSpace": "number",
"usableSpace": "number",
"removable": "boolean"
}
]
},
{
"management": "boolean",
"front": "boolean"
},
{
"supported": [
"screenshotCapture | systemLogs | cpuUsage | memoryUsage | plugins | runners | customScripts | screenshotAnalysis"
]
},
{
"algorithm?": "string",
"keySize?": "number",
"publicKey?": {
"spki": "string"
},
"keyValidity?": {
"start?": "string (date-time)",
"forConsumptionEnd?": "string (date-time)",
"forOriginationEnd?": "string (date-time)"
},
"blockModes?": [
"string"
],
"digests?": [
"string"
],
"mgf1Digests?": [
"string"
],
"encryptionPaddings?": [
"string"
],
"signaturePaddings?": [
"string"
]
},
{
"appletUid": "string",
"appletVersion": "string",
"config": "object"
},
[
{
"pluginUid": "string",
"version": "string",
"data": "object"
}
],
[
{
"runnerUid": "string",
"version": "string",
"data": "object"
}
],
[
{
"runnerUid": "string",
"version": "string",
"data": "object"
}
],
{
"usage": "number"
},
{
"usage": "number",
"total": "number"
},
[
{
"buildHash": "string",
"specs": {
"packageName": "string",
"versionCode": "number",
"apkSha256": "string",
"signatureSha256?": "string",
"versionName?": "string",
"flags?": [
"string"
]
}
}
],
[
{
"buildHash": "string",
"specs": {
"version": "string",
"format": "deb | rpm",
"package": "string",
"architecture": "string"
}
}
],
{
"ipAddress": "string"
},
{
"enabled": "boolean",
"hostname?": "string",
"secure?": "boolean",
"appName?": "string",
"extraArgs?": "string",
"supraCoreAppVersion?": "string",
"supraScreenAppletVersion?": "string",
"clientID?": "string",
"servers?": [
{
"hostname": "string",
"secure?": "boolean"
}
],
"connectionStatus?": "connected | disconnected | searching"
}
]
}
}
}