Gumband Logs

One of the most powerful features of Gumband is having access to real-time logging of low level hardware events, this can make debugging and monitoring of hardware components at runtime much easier. While it is up to the exhibit developer to determine how best to monitor their physical devices, the Gumband API provides a simple method to share and save that information. Debug logs are rate-limited to prevent spamming the server.

the rate limit is 5 messages every 2 seconds, if this rate is exceeded there is a 5 second holdoff period where no messages will be sent.

Event Logs

Log messages for reporting of exhibit events. These logs are generally reserved for events that are of interest to the exhibit owner or the exhibit maintainer (for lifetime monitoring of hardware for example). Logs such as the total number of user interactions or button presses can be sent to this endpoint. The UI can be used to pull reports or view a plot of real-time activity by day.

Error Logs

Error logs are for monitoring of critical hardware or device errors and failures. Gumband can be configured to send an alert when this error is seen. Error logs are saved indefinitely.

Debug Logs

Debug logs are typically informational messages for routine hardware events. The Gumband service automatically sends some Debug logs for events such as settings updates and reboots, but the user can add more that are relevant to their specific hardware/firmware. Debug log messages are saved for 30 days. 

Notify

Send a notification message to the Cloud. Anyone who is subscribed to notification messages for this hardware will immediately receive an email notification with the message. Once attached to an Exhibit, you can go to the notifications tab to subscribe to hardware notifications.