View and manage resources in the web UI

You can view and manage Sensu resources in the web UI, including events, entities, silences, checks, handlers, event filters, and mutators.

Use the namespace switcher

Beyond the homepage, the web UI displays events, entities, and resources for a single namespace at a time. By default, the web UI displays the default namespace.

To switch namespaces, select the menu icon in the upper-left corner or press the Ctrl+K keyboard shortcut and choose a namespace from the dropdown.

When you switch to a namespace, the left navigation menu loads so you can select specific pages for events, entities, services, silences, catalog, and configuration, which includes checks, handlers, event filters, and mutators:

Click the ☰ icon at the top of the left-navigation menu to expand the menu and display page labels:

Manage events

The Events page opens by default when you navigate to a namespace, with an automatic filter to show only events with a non-passing status (i.e. event.check.state != passing). The menu bar at the top of the events list includes several other options for filtering and sorting events:

Click the check boxes to select one or more events and resolve, silence, or delete them directly from the Events page:

Click an event name to view details like status, output, number of occurrences, labels and annotations, related check configuration (if the event was produced by a service check), and entity summary, as well as a timeline that displays the event’s last 20 statuses at a glance:

Manage entities

The Entities page provides real-time inventory information for the namespace’s endpoints under Sensu management. The top row of the entities list includes options for filtering and sorting entities on the page:

Click the check boxes to select one or more entities and delete them directly from the Entities page:

Click an entity name to view details about the entity’s creator, agent version (for agent entities), subscriptions, labels and annotations, associated events, and properties:

Manage services

The Services page includes a module to help you build and configure service entities with service components and rule templates for business service monitoring (BSM). Read Build business service monitoring for details about the web UI BSM module.

Manage silences

Create silences by check or subscription name and clear silences in the web UI Silences page. The Silences page lists all active silences for the namespace. The top row of the silences list includes options for filtering and sorting silences on the page:

Click + NEW to open a dialog window and create silences for individual events, by check or subscription name, or by entity:

You can also silence individual checks and entities from their detail pages in the web UI.

After you create a silence, it will be listed in the web UI Silences page until you clear the silence or the silence expires.

Manage configuration resources

Under the Configuration menu option, you can access assets, checks, event filters, handlers, mutators, pipelines, role-based access control (RBAC) resources, and secrets. Each resource page lists the namespace’s resources. The top row of each page includes options for filtering and sorting the listed resources.

Click a resource name to view the resource’s detail page, where you can review more information about the resource and edit or delete it.

On the Checks page, click the check boxes to select one or more checks to execute, silence, unpublish, or delete them.

Execute checks on demand

You can execute individual checks on demand and on any agent from each check’s detail page to test your observability pipeline.

Click EXECUTE to open the Execute Check dialog window:

In the Execute Check dialog window, you can execute the check according to its existing subscriptions or add and remove subscriptions to execute it on specific agents.

View resource data in the web UI

You can view and copy the YAML or JSON definition for any event, entity, or configuration resource directly in the web UI.

View resource data for an event or entity

To view and copy the YAML and JSON definitions for any event or entity in the web UI:

1. Open the individual resource page for the event or entity.
2. Click ⋮ at the top-right of the page.
3. Select </> Data to open the Resource Data dialog window.
4. In the Resource Data window, click the yaml or json button to select the format.
5. Click the copy button at the top-right of the Resource Data window to copy the resource definition.

This example shows how to view and copy the resource data for an event:

View resource data for a configuration resource

To view and copy the YAML and JSON definitions for any configuration resource in the web UI:

1. Open the individual resource page.
2. Click RAW.
3. In the resource data field, click the yaml or json button to select the format.
4. Click the copy button at the top-right of the resource data field to copy the resource definition.

This example shows how to view and copy the resource data for an event filter: