/settings/system-health/alerts.
Overview
The screen lists existing health alert configurations viaAlertConfigList, which supports editing, deleting, and toggling active status. A slide-over sheet opens AlertConfigForm for creating or editing individual alerts. A “View History” link navigates to the Alert History page (/settings/system-health/alerts/history). All operations are managed through the useAlertConfigs hook.
Who it’s for
Required permission:platform.system_health.manage
Before you start
- You must hold the
platform.system_health.managepermission. - System Health must be accessible from the Settings sidebar.
Steps
1
Open Alert Configuration
Navigate to Settings → System Health → Alert Configuration.
2
Review existing alerts
Browse the list of configured alerts and their active/inactive status.
3
Create a new alert
Click “Create Alert” to open the slide-over form and define threshold and target.
4
Edit an alert
Click the edit action on any alert to modify its configuration.
5
Toggle active status
Use the toggle to enable or disable an alert without deleting it.
6
View alert history
Click “View History” to navigate to the triggered alerts log.
Key concepts
- Threshold-based alerts — fire when a monitored metric crosses a configured boundary
- Active/inactive — alerts can be disabled without deletion
- Evaluation window — the rolling time range over which the metric is averaged before comparison
- Cooldown — minimum time between repeat notifications for the same rule
Platform default backend alerts
Encore OS ships with three platform-managed health alerts that watch the backend processing pipeline. A backend health-metric feeder collects the underlying gauges every 5 minutes, the platform evaluates each alert against a 15-minute rolling window, and matches deliver an in-app notification with a 60-minute cooldown.
These defaults appear in the alert list for every organization but are not editable — they are maintained by the platform. Add your own organization-scoped alerts alongside them for application-level metrics.
Related
Platform Foundation
Platform Foundation overview.
Governance & parity
Documentation coverage and governance.
This page documents shipped product behavior. It is not medical, legal, or
billing advice. Verify against your organization’s policies and applicable
regulations before using it for clinical, compliance, or billing decisions.
Protected health information (PHI) shown in the product is governed by your
tenant’s access controls and is never exposed in this documentation.
Documentation sources
Documentation sources
- src/routes/platform.tsx
- src/platform/health/pages/AlertConfigPage.tsx