Uchiwa is the dashboard for the Sensu monitoring system, which Cumulus uses to monitor the Cumulus Workbench. This article provides a brief overview of the Uchiwa interface, for first time users of Sensu in Cumulus Linux.
Note: The live monitoring page can be viewed here.
When you first connect to Uchiwa in a browser, you are redirected to the Events page. The Events page displays alerts that trigger the thresholds for Critical (red) and Warning (orange) alerts, which are defined in the Sensu checks documentation. The colored bar to the left of the page indicates the severity.
Note: The Events page does not display Normal (green) status alerts. These are shown on the Clients page, documented below.
The Events page also displays:
The source system for each alert
What systems are being monitored
The number of alerts
The collector supplying the alert data (Cumulus Linux uses only one collector
The time the alert occurred
Click on any event to display more information about the error or alert. In the example below, a command needed for the check is not installed.
Note: You can also run the command itself on the switch to see the error code.
As mentioned previously, orange events indicate warnings, for events such as high disk utilization, while red events are critical in nature. The example alert below indicates that security updates are required for a system.
The Events page also displays grey alerts, indicating that a given check failed.
The Clients page displays all of the machines that have checked in, along with their status (green, orange, or red). Orange and red alerts are described above; green alerts indicate a normal operating system status. The columns can be sorted, and more detail can be seen by clicking on an event.
The Checks page shows all checks that are currently running.
Note: The last three pages are for handlers, and are not used in the Cumulus implementation.