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
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.
COMMERCIAL FEATURE: In the packaged Sensu Go distribution, the namespace switcher will list only the namespaces to which the current user has access. For more information, read Get started with commercial features.
When you switch to a namespace, the left navigation menu loads so you can select specific pages for events, entities, services, silences, 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:
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 top row 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 associated entity, as well as a timeline that displays the event’s last 20 statuses at a glance:
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 silence or delete them directly from the Entities page:
Click an entity name to view details about associated events, system properties, and labels and annotations:
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.
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:
+ NEW to open a modal 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
COMMERCIAL FEATURE: Access check, handler, event filter, and mutator management in the packaged Sensu Go distribution. For more information, read Get started with commercial features.
Under the Configuration menu option, you can access check, handler, event filter, and mutator resources. 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 detailed information 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.
NOTE: Changing the subscriptions for ad hoc execution in the Execute Check dialog window will not make any changes to the existing subscriptions in the check definition.
View resource data in the web UI
You can view the JSON definition for any event or entity and the JSON or YAML definition for any configuration resource directly in the web UI.
View resource data for an event or entity
To view the JSON definition for any event or entity in the web UI:
- Open the individual resource page.
- Click ⋮ at the top-right of the page.
- Select < > View Data to open the Resource Data modal window and view the resource’s definition in JSON format.
This example shows how to view the JSON definition for an event:
View resource data for a configuration resource
To view and copy the JSON or YAML definition for any configuration resource in the web UI:
- Open the individual resource page.
- Click RAW.
- In the Resource Data field, click JSON or YAML to select the format.
- Click at the top-right of the resource data to copy the resource definition.
This example shows how to view and copy the resource data for an event filter: