Skip to main content

Telemetry

Client devices running in Supra mode automatically report connection telemetry to the signageOS cloud. This gives you visibility into which devices are connected to a Supra Server, their connection status, and the Supra software versions in use — all from Box.

note

This article covers cloud-based telemetry for Supra client devices. For server-side monitoring with Grafana dashboards (framerate, bitrate, CPU usage), see Monitoring.

What Is Reported​

When Supra mode is enabled on a device, the device periodically reports the following information:

FieldDescription
Connection StatusWhether the device is connected, disconnected, or searching
Supra Server HostnameThe hostname of the currently connected Supra Server
Security (TLS)Whether the connection uses TLS/WSS encryption
Supra Core App VersionVersion of the Supra core application running on the server
Supra Screen VersionVersion of the Supra screen applet running on the client device
Configured ServersList of all Supra Servers the device is configured to connect to

Connection Status​

The connection status indicates the current state of the device's connection to a Supra Server:

StatusMeaning
🟢 ConnectedDevice is actively connected to a Supra Server and receiving rendered content
🔴 DisconnectedSupra mode is enabled but the device is not connected (e.g., the server is unreachable)
🟠 SearchingDevice is actively looking for an available Supra Server in the Location

Viewing Telemetry in Box​

On a client device's detail page, Box displays a Supra Mode card when Supra telemetry data is available. The card shows:

  • The current connection status with a color-coded indicator
  • The connected Supra Server hostname
  • Supra software versions (core app and screen applet)
  • Whether TLS is enabled
  • The list of configured Supra Servers
tip

The Supra Mode card appears automatically on client devices that have reported Supra telemetry. No additional configuration is needed to enable it.

Collection Interval​

Supra telemetry is collected every 10 minutes by default. The device compares the current values with previously reported values and only sends an update when something changes (e.g., connection status changes from searching to connected).

The collection interval can be adjusted per device through the signageOS platform configuration, following the same mechanism as all other device telemetry types.

Troubleshooting​

Supra Mode Card Not Visible​

If the Supra Mode card does not appear on a client device's detail page:

  1. Verify that Supra mode is enabled for at least one applet on the device (check the Supra column in the Applets table).
  2. Wait up to 10 minutes for the first telemetry report to arrive.
  3. Ensure the device is online and communicating with the signageOS cloud.

Status Shows "Disconnected"​

If a device reports disconnected status:

  1. Verify the Supra Server is running — check the Supra Server device's Supra tab.
  2. Ensure both the client device and Supra Server are in the same Location.
  3. Check network connectivity between the devices — see Network Requirements.
  4. If TLS is enabled, verify the certificate configuration — see TLS Setup.

Status Shows "Searching"​

If a device remains in searching status:

  1. A Supra Server must be installed and running in the same Location.
  2. Verify the Supra Server device reports supra-server-daemon in its installed packages.
  3. Check that no firewall rules block communication between the devices.