Web UI

COMMERCIAL FEATURE: Access the Sensu web UI in the packaged Sensu Go distribution. For more information, read Get started with commercial features.

The Sensu backend includes the Sensu web UI: a unified view of your events, entities, and checks with user-friendly tools that provide single-pane-of-glass visibility and reduce alert fatigue.

The web UI homepage provides a high-level overview of the overall health of the systems under Sensu’s management, with a summary of active incidents, the number of incidents by severity, the types of entities under management, and the numbers of entities and incidents per namespace.

Sensu web UI homepage

Access the web UI

After you start the Sensu backend, you can access the web UI in your browser by visiting http://localhost:3000.

NOTE: You may need to replace localhost with the hostname or IP address where the Sensu backend is running.

Sign in to the web UI

Sign in to the web UI with the username and password you used to configure sensuctl.

The web UI uses your username and password to obtain access and refresh tokens via the Sensu /auth API. The access and refresh tokens are JSON Web Tokens (JWTs) that Sensu issues to record the details of users’ authenticated Sensu sessions. The backend digitally signs these tokens, and the tokens can’t be changed without invalidating the signature. The access and refresh tokens are saved in your browser’s local storage.

The web UI complies with Sensu role-based access control (RBAC), so individual users can view information according to their access configurations. Read the RBAC reference for default user credentials and instructions for creating new users.

Backend log messages for web UI sign-in

Upon successful login, Sensu logs an INFO message in the backend log with details about the user and provider. For unsuccessful login attempts, Sensu logs an ERROR message upon authentication failure, along with the username that was tried.

Read Service logging for more information about the backend log and log levels.

View system information

Press CTRL . in the web UI to open the system information modal and view information about your Sensu backend and etcd or PostgreSQL datastore. For users with permission to create or update licenses, the system information modal includes license expiration information.

License expiration banner

A banner appears at the top of the web UI screen when your organization’s license is expiring:

Sensu web UI homepage

The banner is only visible to users who have read access to your organization’s license.

By default, the banner starts appearing when the license expiration is 30 days away. To adjust the number of days before license expiration to begin displaying the banner, use the license_expiry_reminder web UI configuration attribute.

Use the implicit OR operator

On the Sensu web UI homepage, you can use the search function to limit the display by cluster and namespace. If you specify the same attribute twice with different values, Sensu automatically applies a logical OR operator to your search.

For example, suppose you enter two search expressions in the search bar on the web UI homepage: namespace: devel_1 and namespace: devel_2. In this case, the web UI homepage will display all data for both namespaces: devel_1 and devel_2.

Change web UI themes

Use the preferences menu to change the theme or switch to the dark theme.

Troubleshoot web UI errors

Read Troubleshoot Sensu to resolve and investigate web UI errors.