Understanding the real-time status of your digital signage displays is essential for managing your network efficiently. Portal3 provides a detailed view of each device's current state, helping users quickly identify connectivity issues, screen problems, or content playback interruptions.
This article covers:
All possible device statuses reported by devices in Portal3
How frequently statuses are updated
Notifications and ways to review status information
Types of Device Statuses
In Portal3, each device reports two primary categories of status:
(1) Online Status
Indicates whether a device is currently connected to the network.
Online: The device is actively connected via XMPP.
Offline: The device has disconnected from XMPP.
Presence status is updated in near real-time, directly via XMPP:
If disconnected due to unexpected circumstances, like network or power loss, the "offline" status appears within ~2 minutes.
If the device is programmatically shut down, the status updates immediately.
(2) Display Status
Represents what is currently happening on the device's screen. Portal3 reports the following device statuses:
| Status | Description |
|---|---|
| Unavailable | The device is offline and display status is unknown. |
| Playing | The device is playing content. |
| Showing logo | The device is showing the default logo screen. |
| Brightness off | The display is currently off, either because brightness is set to 0% manually or because of an active brightness schedule. |
| Black screen | The device has a black screen. It is not showing the logo or playing content, and the brightness is not off. This status requires troubleshooting. |
The display status is triggered by device metrics reports every 10 minutes unless the device is disconnected. If offline, the device will send a device metrics report when internet connectivity is restored. Display status will be reported as "Unavailable" until connectivity is restored.
Backend metrics explained
Display status is calculated from several backend metrics, each with it's own expected update delay:
| Status | Description | Updated Delay |
|---|---|---|
presence |
Indicates whether the device is online or offline, as explained above. | Programmatic disconnect: Immediate Unexpected disconnect: ≤ 2 minutes |
|
Indicates if the device is displaying a Videri or other logo screen. | ≤ 30 seconds |
|
Indicates whether the screen itself is powered on. | ≤ 30 seconds |
is_black_screen |
Determines if the screen is on but empty (i.e., showing an entirely black image) | ≤ 10 minutes |
After receiving the device metrics report, display status is calculated as follows:
| Reported Status | Calculation |
|---|---|
| Unavailable | presence=offline |
| Playing |
presence=online AND is_screen_on=true AND is_black_screen=false AND showing_logo=false
|
| Showing logo |
presence=online AND is_screen_on=true AND is_black_screen=false AND showing_logo=true
|
| Brightness off |
presence=online AND is_screen_on=false
|
| Black screen |
presence=online AND is_screen_on=true AND is_black_screen=true
|
Reviewing Device Statuses in Portal
You can view device statuses on the Devices page in Portal3, either by checking the devices list or by opening a drawer for a target device. In the device drawer, statuses will be displayed in the top left corner, under the device name. You can also use filters on the Devices page to quickly identify devices that may need troubleshooting.
- Online status is shown as a circular badge next to the device name in the 'Name' column:
- If the device is online, the badge will be green.
- If the device is offline, the badge will be red.
- Display status is shown as text in the "Display status" column. For guidance configuring the Devices page list, see The Devices Page.
| NOTE: As of September 2025, statuses DO NOT auto-refresh and will only update when the device list is manually reloaded. A frontend fix is planned to improve this behavior. |
Comments
0 comments
Article is closed for comments.