Skip to main content
Version: 0.10

Notifications

The bell in the top bar opens the notification centre: a list of things that happened in your tenants and Organization, newest first. The bell is on the tenant screens and in System management alike.

Notifications are shown in the console only. They are not sent by email.

What produces a notification​

Tenant events​

These go to every user who holds a role in the tenant where the event happened.

EventTitleSeverityThe row links to
A scan run finishedScan completedUpdateThe run
A scan run failed while being processedScan processing failedErrorThe run
A scan run stopped because some changes matched more than one assetVerification requiredWarningThe run
A report was generatedReport completedUpdateReports
A report failedReport failedErrorReports
An integration was connectedIntegration addedUpdateThe integration
An integration was removedIntegration removedUpdateIntegrations

The sentence under the title names what the event is about: the integration the scan ran through, the report or the integration.

Organization events​

These are about the Organization's people rather than a tenant's data. They go only to users who hold a global role with the Roles & user management permission (read or write), because they include other users' email addresses.

EventTitleSeverityThe row links to
A user was invitedNew user invitedUpdateUsers & Roles
A user was suspendedUser account suspendedWarningUsers & Roles
A suspended user was re-enabledUser account restoredUpdateUsers & Roles
An administrator reset a user's two-factor authenticationUser two-factor authentication resetWarningUsers & Roles

A two-factor reset is a warning because the account is less protected until its owner sets up two-factor authentication again, and an unexpected one deserves a look.

Sensor health is not notified

The notification centre has a Sensors filter, but no event currently produces a sensor notification. Watch sensor status on Settings → Sensors. See Sensors.

Reading the list​

The list loads your 25 most recent notifications. Each row shows the title, the sentence, a severity label (Error, Warning or Update) and how long ago it happened. Unread rows are highlighted and carry a dot.

A row can offer:

ControlWhat it does
Open runFor scan notifications: opens the run in the console
Arrow iconOpens the linked screen in a new browser tab
Tick iconMarks the notification read

Opening a notification through Open run or the arrow also marks it read.

The list holds your notifications from every tenant you belong to, not only the one you are in. Links are opened in the tenant you are currently working in, so switch to the right tenant first when a notification is about another one.

Severity floor​

The buttons under the title set the lowest severity shown:

ButtonShows
All (default)Updates, warnings and errors
Warning +Warnings and errors
ErrorsErrors only

Each button shows how many notifications it would list, with a dot when some of them are unread. The floor also applies to the bell's badge, so choosing Errors quiets the badge about warnings and updates.

Source filter​

The tags at the foot of the panel narrow the list by what a notification is about:

TagShows
All sources (default)Everything
ScansEvery notification that is not about a sensor, which includes reports, integrations and users
SensorsSensor notifications (none are produced at present)

Click an active tag again to clear it. Unlike the severity floor, the source filter changes only the list, never the badge, so a forgotten tag cannot hide that something needs attention.

Both filters are remembered in your browser.

Unread count and read state​

The badge on the bell counts your unread notifications across your whole mailbox, not only the 25 loaded, split into a segment per severity at or above your floor. A count over 99 shows as 99+. The badge and the list refresh every minute.

Read state is kept on the server for your account, so a notification you read in one browser is read everywhere.

  • Mark one notification read with its tick, or by opening it.
  • Mark all read marks every notification read when no filter is active. With a filter active, it marks only the rows the list is showing.
  • A read notification cannot be marked unread again.
TODO

Confirm whether old notifications are ever removed, and after how long.