Alert sources
Route: /sources (sidebar: Alerts → Alert Sources)
An alert source labels where alerts originate in ToBeAlert (monitoring system, integration, team, environment, etc.). Sources appear in the UI with a name, icon, and description, helping operators recognize alert provenance on the dashboard and in reports.
See also: Alerts dashboard · TQL search and filters · List tables and bulk actions · Custom webhooks
Where to find it
In the sidebar under Alerts:
- Alert Sources →
/sources
Header actions:
| Button | Description |
|---|---|
| Webhook Configurations | Jump to inbound webhook setup (requires webhook read permission) |
| Refresh | Reload the list |
| Create alert source | Open the create drawer (requires write permission) |
The page description reads "Create or delete alert sources used to manage alerts".
Creating, editing, and deleting alert sources require the appropriate permissions. If Create alert source is missing, contact your administrator.
Table columns
| Column | Description |
|---|---|
| Name | Source identifier (click to edit). Shown with its icon in the name cell |
| Icon | Icon key or Custom svg icon for SVG sources |
| Description | Human-readable description |
| Creation date | When the source was created |
The table supports Enter the name plain search and Toggle TQL filter mode for structured filters — see TQL search and filters. Double-click a row to edit.
Row actions (with permission): blue Edit, red Delete.
Create an alert source
- Open Alerts → Alert Sources.
- Click Create alert source.
- Fill in the form (see below).
- Click Create.
Form fields
| Field | Description |
|---|---|
| Name (without special characters) | Required. Alphanumeric, hyphen, underscore, and slash only |
| Description | Required. Explain what this source represents |
| Icon | Choose icon type, then pick or paste an icon |
Icon types
| Type | Description |
|---|---|
| Dashboard icons | Built-in SVG icons from the ToBeAlert icon set — search with Search for an icon |
| FontAwesome icons | Font Awesome solid icons — searchable list with preview |
| Custom icons | Paste SVG markup in Place the svg icon here; live Preview below |
Switching icon type clears the current icon selection.
Edit and delete
- Click a Name or the blue Edit button to open Edit alert source.
- Footer button: Update.
- Delete one or more sources via row action or bulk Delete (confirmation dialog).
Closing the drawer with unsaved changes triggers the standard unsaved-changes prompt.
Bulk actions
Select rows with checkboxes or use the context menu — see List tables and bulk actions. Alert-source actions:
| Action | Scope |
|---|---|
| Edit | Exactly 1 selected row |
| Delete | ≥ 1 selected row |
Relationship to webhooks and integrations
Alert sources are metadata labels in the UI — they identify and visually distinguish origins. Inbound alert ingestion typically uses:
- Custom webhooks — Webhook Configurations button on this page
- Standard alert API endpoints (see API documentation)
Assign or map sources according to your integration design so operators can filter and recognize alerts by origin on the dashboard.
Best practices
- One source per integration or team — e.g.
prometheus-prod,datadog-staging,manual-ops. - Use recognizable icons — speeds up visual scanning on dense dashboards.
- Write clear descriptions — document which system or pipeline feeds this source.
- Keep names stable — changing source names may affect bookmarks and automation that reference them.
- Review periodically — remove unused sources to keep the catalog manageable.