Skip to main content
Version: 1.2

Overview

Views define which alerts a user is allowed to see. Each view includes an Alerts Query that filters the alert dataset; users assigned to that view get a matching tab on the Alerts dashboard. Views are separate from dashboard sidebar filters: views set the access boundary; filters narrow results within the active view tab.

StepWhat you configureMenu / routeDocumentation
1Views — name, description, alert query, membersAccess Control → Views → /viewsCreating and managing views
2User membership — which views each account can useAccess Control → Users → /usersAssigning views to users
3Dashboard usage — switch tabs, counts, orderingAlerts → Dashboard → /dashApplying views on the dashboard

Views list — Create view and built-in lock icons

Where to find it in the UI​

In the sidebar under Access Control:

  • Views → /views

The page title is Views. Header actions:

ButtonPurpose
RefreshReload the views table
Create viewOpen the create drawer

Table search, sorting, pagination, and bulk selection follow the shared list pattern — see TQL search and filters and List tables and bulk actions. Double-click a row or use row actions to edit.

Permissions

Managing views requires administrator access. Non-admins do not see Access Control or Views in the sidebar. Assigning views to users is also done under Access Control → Users.

Built-in views​

Three views are Built-in (lock icon in the Name column). They cannot be edited, duplicated, or deleted:

NamePurpose
all eventsAll alerts (SELECT * FROM Alerts)
Production eventsOpen production alerts with severity minor, major, or critical
Events in maintenance modeAlerts in maintenance status

Built-in views still appear in the list for administrators. Assign them to users like any other view when appropriate.

How views fit together​

Typical rollout for a platform team:

  1. Create a view Staging platform with Alerts Query environment = 'Staging'.
  2. Assign that view to staging on-call users under Users.
  3. Those users open Dashboard and select the Staging platform tab; only matching alerts load.
  4. They apply sidebar filters (severity, time range, custom filters) on top of that view.

LDAP and SAML external auth providers can map directory groups to views during sync so new users receive views automatically.

ModuleRelationship
Users, roles, and permissionsAssign views per user; roles control what users can do
RolesPermissions are separate from view visibility
Alerts dashboardOne tab per assigned view
Sidebar filtersFurther filter within the active view
External auth providersGroup mappings can assign views after directory sync
PoliciesPolicies modify alerts; views limit which alerts a user sees

Best practices​

  1. Model teams or environments with views (for example Production NOC, Staging, Security) instead of one view per person.
  2. Keep queries testable — use Easy mode while designing, then switch to Advanced mode only when you need raw query text.
  3. Assign views on the user record and on the view drawer so membership stays consistent.
  4. Avoid giving every user all events unless they need full visibility; prefer scoped views.
  5. Document view purpose in Description so admins know when to assign each view.
  6. Review membership when people change teams; remove old views before adding new ones.