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.

Feature entitlement: supraOnPremise · Plan: 👑 Add-on — not in a standard Device Plan

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:

Field	Description
Connection Status	Whether the device is connected, disconnected, or searching
Supra Server Hostname	The hostname of the currently connected Supra Server
Security (TLS)	Whether the connection uses TLS/WSS encryption
Supra Core App Version	Version of the Supra core application running on the server
Supra Screen Version	Version of the Supra screen applet running on the client device
Configured Servers	List 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:

Status	Meaning
🟢 Connected	Device is actively connected to a Supra Server and receiving rendered content
🔴 Disconnected	Supra mode is enabled but the device is not connected (e.g., the server is unreachable)
🟠 Searching	Device 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.

Related Topics

• Monitoring — Grafana-based server-side monitoring (framerate, bitrate, resources)
• Client Devices — Setting up and managing Supra on client devices
• Network Requirements — Network configuration for Supra
• TLS Setup — Enabling encrypted connections