Gumband OS Monitor

Owned by Luke Derrick
Last updated: Oct 10, 2024
3 min read

Overview

The Gumband OS Monitor is an executable program that runs on a host operating system for high-level system monitoring via Gumband. By launching the OS Monitor upon system boot, various statuses can be tracked and some high level controls can be triggered remotely via the Gumband UI.

Statuses

The OS Monitor tracks several statuses of the host machine, including:

  • OS Monitor Version - The current version of the Gumband OS Monitor running on the host machine.

  • Gumband Exhibit SDK Version - The OS Monitor uses the Gumband SDK to connect to the Gumband cloud service. This is the version of that npm package used.

  • IP Address - The IP address of the host machine.

  • OS Platform - The operating system of the host machine.

  • Last Startup - The last time the host machine was booted.

  • Exhibit Host Uptime - The time that the host machine has been online.

  • CPU Usage

  • Memory Usage - RAM memory usage

  • Disk Usage - Harddrive disk usage

  • Total System Memory - Total RAM available on the host machine

  • Harddrive Capacity - Total harddrive disk capacity

  • Connected Displays - The displays currently connected to the host machine (Currently only available on Linux)

  • Number of Displays - The number of displays connected to the host machine (Currently only available on Linux)

  • Connected USB Devices - The USB devices currently connected to the host machine (Currently only available on Linux)

  • Number of USB Devices - The number of USB devices currently connected to the host machine (Currently only available on Linux)

The exhibit status page in the Gumband UI

 

Controls

The Controls tab for the OS Monitor in the Gumband UI

The OS Monitor also enables a few simple controls that can assist in remote debugging:

  • Reboot PC - Triggers a reboot of the host machine via a terminal command.

  • Take Screenshot - Takes a screenshot of whatever is showing on the host machine displays. These screenshots are uploaded to Gumband and can be seen in the File tab of the UI:

The OS Monitor will save screenshots for 30 screenshot triggers (if there are more than one display, multiple images are saved for Windows and MacOS), after which it will begin to overwrite old screenshots.

Settings

Settings allow the user to configure how the OS Monitor interacts with the host machine. These settings include:

  • Status Update Interval - This is how often the OS Monitor queries the host machine for its statuses. Default is 15 seconds.

  • Take Screenshot Interval - This is how often the OS Monitor triggers a screenshot to be taken. Default is never.

Local Logging

The OS Monitor stores up to 14 days of log files in a folder called logs/ next to the OS Monitor executable. When there are 14 days of logs, it automatically deletes the oldest day's file and starts a new one, when the day starts.

Supported Operating Systems