Notifications
The Notifications page is your in-app inbox for platform alerts and system events. It consolidates alerts generated by edge devices, automated health checks, and orchestrator-level events into a single chronological feed.
Navigate to Notifications from the top navigation bar, or click the bell icon to go directly to /notifications.
Alert Pipeline
Notifications originate from the observability stack and flow through the following pipeline before appearing in the UI:
- vmalert evaluates PromQL alerting rules against metrics collected from edge devices.
- vmalertmanager receives fired alerts, applies grouping and inhibition rules, and routes them to configured receivers.
- Webhook receiver — the orchestrator API exposes a webhook endpoint that vmalertmanager calls when an alert fires or resolves.
- Notifications table — the API persists the incoming alert payload to the database, associating it with the relevant edge device and tenant.
- UI — the Notifications page fetches from the notifications table and displays alerts in real time.
Alert resolution is also tracked: when vmalertmanager sends a resolved event, the corresponding notification is marked with a Resolved badge without being deleted.
Topbar Badge
The bell icon in the top navigation bar displays a count of unread notifications. This count is refreshed automatically every 30 seconds via a background poll, so you will see new alerts appear without needing to reload the page.
Notification Types
Each notification is classified by severity, indicated by a coloured left border and icon.
| Type | Colour | When Used |
|---|---|---|
| Error | Red | Critical failures — edge offline, WireGuard handshake failure, VPP crash. |
| Warning | Amber | Degraded conditions — high CPU, packet loss, link flap. |
| Success | Green | Positive events — edge connected, configuration applied successfully. |
| Info | Blue | Informational events — provisioning started, template applied. |
Filters
Use the filter bar to narrow the notification list without leaving the page.
| Filter | Options | Description |
|---|---|---|
| Type | All Types, Errors, Warnings, Success, Info | Show only notifications of a specific severity. |
| Status | All, Unread, Read | Show only notifications that have or have not been opened. |
| Device | All Devices, System, (edge list) | Scope to a specific edge device, or show only platform-level system notifications that are not associated with any device. |
Filters are applied client-side and reset pagination to page 1 automatically when changed.
Reading Notifications
Expanding Details
Click the chevron icon on any notification card to expand it and view:
- The associated device name with a link to the edge detail page.
- The tenant the device belongs to (visible to Super Admins).
- Raw metadata from the alert payload in JSON format.
- The alert fingerprint — a stable hash used by vmalertmanager to correlate firing and resolved events for the same condition.
Navigating to a Device
Click the device name link inside a notification to jump directly to the edge or MTGE detail page. If you are a Super Admin viewing notifications across all tenants, the platform will automatically switch the tenant context before navigating so the correct edge is visible.
Managing Notifications
Marking as Read
- Click the checkmark icon on an individual notification to mark it as read. The unread indicator (blue dot) disappears and the topbar badge count decreases.
- Click Mark All Read in the page header to mark all notifications as read in a single action.
Deleting Notifications
- Click the trash icon on an individual notification to remove it permanently.
- Click Clear All to delete every notification in your inbox regardless of filters.
Deletion is permanent. Notifications cannot be recovered after they are deleted. Export the activity log from Admin > Audit Log if you need a durable record of alert history.
Pagination
The notification list is paginated. Use the page navigation controls at the bottom of the list to move between pages. The page size can be adjusted using the selector at the bottom right (10, 25, 50, or 100 items per page). Your preferred page size is saved in your user settings and persists across sessions.
Permissions
All authenticated users can view and manage their own notifications. Super Admins see notifications across all tenants and can filter by tenant from the device filter. Tenant Admins see only notifications associated with devices within their tenant.