This knowledge base has moved to the documentation site. Please visit the knowledge base here for the most up to date content. This site is no longer maintained.

Understanding the Uchiwa Interface


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.


Events Page

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 alert

  • 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.

Clients Page

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.

Checks Page

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.


This support portal has moved

Cumulus Networks is now part of the NVIDIA Networking Business Unit! The NVIDIA Cumulus Global Support Services (GSS) team has merged its operations with the NVIDIA Mellanox support services team.

You can access NVIDIA Cumulus support content from the Mellanox support portal.

You open and update new cases on the Mellanox support portal. Any previous cases that have been closed have been migrated to the Mellanox support portal.

Cases that are still open on the Cumulus portal will continue to be managed on the Cumulus portal. Once these cases close, they will be moved to the Mellanox support portal.

Powered by Zendesk