Alerts

Monitor and manage alerts from the Alertmanager integration.

Overview

Umoo integrates with Prometheus Alertmanager to surface infrastructure and device alerts. The alerts section has three views:

View	Purpose
Active Alerts	Currently firing alerts requiring attention
Alert Rules	Alertmanager rule groups and individual rule definitions
Alert History	Resolved and expired alert records

Active Alerts

Navigate to Alerts → Active Alerts to see all currently firing alerts.

Each alert row shows:

• Resource — affected resource name or label
• Level — severity (critical, warning, info)
• Duration — how long the alert has been firing
• Alert Conditions — summary of why the alert fired
• Start–End Time — when the alert started (end is empty if still active)
• Count — number of occurrences

Filtering Active Alerts

Filter by:

• Search — free-text search across alert labels
• Severity — critical / warning / info / all
• Status — firing / resolved / all

Viewing Occurrences

Click an alert row to open the Occurrences modal, which lists every instance of that alert firing with timestamps and status.

Alertmanager Unavailable

If Alertmanager is unreachable, a warning banner appears: "Alertmanager is unavailable. Alert data may be stale." Check the Alertmanager service and the alertmanager.url server configuration.

Alert Rules

Navigate to Alerts → Alerts (Management tab) to see and manage Alertmanager rule groups.

Each rule group shows:

• Group name
• Data source
• Number of rules

Click a rule group to see the individual alert rules with their PromQL expressions, duration, severity labels, and annotations.

Creating an Alert Rule

1. Click Create Rule.
2. Fill in:
   • Rule Name — unique identifier
   • PromQL Expression — the metric query that triggers the alert
   • Duration — how long the condition must be true before alerting
   • Severity — critical, warning, or info
   • Summary / Description — human-readable annotation
3. Click Save.

The rule is written to Alertmanager and takes effect within the next evaluation cycle (typically 1 minute).

Alert History

Navigate to Alerts → History to browse resolved and expired alerts.

Filter by:

• Search — alert name or label value
• Severity — filter by level
• Time Range — from/to date pickers

Alert history is retained according to the retention policy configured in your Alertmanager instance.

Notification Channels

Notification channels control where alert notifications are delivered when rules fire.

Creating a Notification Channel

1. Navigate to Alerts → Notification Channels.
2. Click + Create Channel.
3. Select a Type (e.g. Email/SMTP).
4. Fill in the channel configuration (recipients, etc.).
5. Click Create.

Assigning Channels to Rule Groups

Each alert rule group can have one or more notification channels assigned:

1. Open an alert rule group.
2. Click Manage Channels.
3. Select the channels that should receive notifications when rules in this group fire.

Testing a Channel

Click Test on any notification channel to send a test notification and verify the configuration works.

Platform Notification Channels

Super admins can create platform-level notification channels under Platform → Alerts that operate outside of tenant scope and are used for platform-wide alert rules.

Webhook Integration

Umoo exposes an Alertmanager webhook endpoint at:

POST /api/v1/alerts/webhook

This endpoint is unauthenticated and intended to receive alert notifications from Alertmanager. Configure your Alertmanager receiver to POST to this URL.

Alerts received via webhook are stored in the Umoo event log under the configured default tenant.

Configuration

Server Config Key	Description
alertmanager.url	Alertmanager base URL (e.g. http://alertmanager:9093)
prometheus.url	Prometheus base URL for rule evaluation
alerts.default_tenant_id	Tenant UUID for webhook-received alerts
smtp.host	SMTP server host for email notifications
smtp.port	SMTP server port (default: 587)
smtp.username	SMTP authentication username
smtp.password	SMTP authentication password
smtp.from	Sender email address for alert notifications