Scheduled Maintenance

Subscription Feature

This is a feature which is currently only included in the Subscription Edition of Observium.

Scheduled Maintenance suppresses alert notifications for a defined time window.

How It Works

Each maintenance window has:

• maint_name
• maint_descr
• maint_start
• maint_end
• maint_global (0 or 1)

If maint_global=1, all alert notifications are suppressed during the active window.

If maint_global=0, suppression applies only to associated entities:

• group
• device
• alert_checker

UI Workflow

1. Go to Alerting → Scheduled Maintenance.
2. Click Add Schedule Maintenance.
3. Set the name, description, and maintenance period.
4. Choose whether the window is global.
5. Save the entry.
6. For non-global windows, add associations (groups/devices/alert checkers).

Time Validation

Start and end times are validated when creating or updating maintenance entries.

• Invalid dates are rejected.
• End time must be strictly after start time.

Association Behavior

Maintenance associations are idempotent:

• Adding an already-associated entity is treated as already present.
• Removing a non-existent association is treated as already removed.

This avoids misleading duplicate-key errors for normal repeat operations.

API

Maintenance is available in API v0:

• GET /api/v0/maintenance
• GET /api/v0/maintenance/{maint_id}
• POST /api/v0/maintenance
• PUT /api/v0/maintenance/{maint_id}
• DELETE /api/v0/maintenance/{maint_id}
• GET /api/v0/maintenance/{maint_id}/associations
• POST /api/v0/maintenance/{maint_id}/associations
• DELETE /api/v0/maintenance/{maint_id}/associations

See API Documentation for request and response examples.