Monitoring

From SpinetiX Wiki

Introduction

The time spent on maintenance is rather insignificant, as the SpinetiX players are designed to run continuously and reliably for 24/7. Nevertheless, there could be times when a player might not be running properly or running in a reduced-functionality state.

  • If the player gets stuck rendering content for 60 seconds, then it will automatically reboot. If this happens various times in quick succession, then the player will enter Safe mode, allowing you to query the logs to find the content that is causing this.
  • If the problem is more serious (storage/firmware corruption, hardware issue etc.), the player will enter into Recovery mode.
  • It is extremely rare for the player to freeze and require manual intervention.

The health of your players can be monitored in different ways depending on the deployment type, as detailed below.

DSaaS deployments

Players status icons in SpinetiX ARYA™
Players status icons in SpinetiX ARYA™

SpinetiX ARYA™ provides an overview of the players' status on the Players → Setup page, where:

  • Green checkmark icon indicates that the player is online.
  • Orange checkmark icon indicates that the player is in Slow Sync mode or its firmware is being updating.
  • Red exclamation point icon indicates that the player is offline.

With ARYA ENTERPRISE/PREMIUM plan, you also have access to these pages:

  • Players → Monitoring page shows the players' position and status on a map, and along with their status and snapshot (if online). Click a player status icon to get its name, serial number, firmware version, and address.
  • Players → Reporting page shows the players' statistics for the past three months: uptime and online percentage, the number of restarts, as well as details about the displayed content (number of days and the average number of appearances per day).

Self-Manage deployments

Devices - Icon View
Devices - Icon View

Elementi software can be used to quickly assess the status of the players.

  • Simply click on the "Devices" tab in Browse panel to get an overview of all your players; those that are automatically discovered within the same LAN as the PC running Elementi present a device status icon, and you can easily spot the ones having problems (e.g., orange and red icons).
  • If you want to find more details about an online player, right-click on its icon and select the "Control Center" option. This opens the Control Center web interface, where you can find the player status summary and the content snapshot; you can also check the player's logs for more insights.

Advanced methods

More ways to monitor your players are presented below, but these require the involvement of your IT team and/or setup development.

  • SNMP is supported on the players – this can be used to monitor basic player data, such as: uptime, turned on/off status, detection of loss of networks, detection of player reboots, detection of player power downs, etc. See the SNMP monitoring page for more details.
  • ICMP ping utility can be used to test the reachability of a player.
  • Player APIs:
    • The XML-based Status API offers details about the player, such as uptime, device stats, storage, firmware version, temperature, etc. The player snapshot can also be obtained.
    • The JSON-based RPC API allows sending different RPC commands to the player, amongst which the get_info command which returns the device info in JSON format, such as: serial number, name, model, operation mode, firmware version, firmware status, uptime, temperature, storage, etc.
    • You can also implement an RPC Concentrator application to listen for notifications sent by the player, like "Ready" (the heartbeat) or "Restart". This requires significant setup development, as well as running and maintaining a web server. Some RPC Server-side application samples are provided as examples of RPC-based monitoring using PHP, however no further support is provided by SpinetiX in filling your skill gaps on RPC setup and maintenance.

Cockpit monitoring discontinuation

The Cockpit player monitoring service, which offers the possibility to remotely monitor various player parameters, will be discontinued during 2025. This transition is necessary due to the obsolescence of the underlying technology.

Key points: