Alertmonitor

Alertmonitor for Prometheus

Monitor Prometheus alerts with Alertmonitor

Alertmonitor is a graphical web interface for displaying alerts from Prometheus.

Alert rules in Prometheus should be enriched with additional labels to get most info about alerting state. Alertmonitor automatically correlates clear events with raised alerts and always displays currently active alerts.

Periodic synchronisation assures that no alert is ever lost. After a broken connection or a service failure, the alerts will be automatically synchronised with Prometheus and Alertmonitor will always display updated state of monitored instances.

Alertmonitor is easy to run

The easiest way to run Alertmonitor is to deploy it in Docker container:

$ docker run -d -p 8080:8080 matjaz99/alertmonitor

Open in browser: http://localhost:8080/alertmonitor

Note: You need to configure alert rules in Prometheus to see any alerts!

Features

➤ Web Graphical User Interface
➤ Automatic alarm-clear correlation
➤ Periodic synchronisation of active alerts
➤ POST webhook endpoint
➤ Supporting additional labels on alerts
➤ Filtering alerts by tags
➤ Aggregating alerts by targets
➤ Active alerts view
➤ Journal of events (history)
➤ Metrics

Alertmonitor is open source and opened to community

Github

https://github.com/matjaz99/alertmonitor

Docker image

https://hub.docker.com/r/matjaz99/alertmonitor

Google groups

https://groups.google.com/g/alertmonitor-users

Quick start

First you need to properly configure alert rules in Prometheus and second, configure Alertmonitor receiver in Alertmanager.

Add labels to alert rules:

groups:
- name: my-alerts
  rules:
  - alert: CPU usage
    expr: 100 - (avg(irate(node_cpu_seconds_total{mode="idle"}[1m]) * 100)) > 90
    for: 1m
    labels:
      severity: critical
      priority: low
      info: CPU 1
      tags: hardware, cpu, overload
    annotations:
      description: Node {{ $labels.instance }} CPU usage is at {{ humanize $value}}%.
      summary: CPU alert for Node '{{ $labels.instance }}'

Configure alertmanager to send alerts to webhook receiver in alertmonitor:

route:
  receiver: alertmonitor
  group_by: [alertname]
  group_wait: 10s
  group_interval: 5m
  repeat_interval: 3h

receivers:
- name: alertmonitor
  webhook_configs:
  - url: http://alertmonitor:8080/alertmonitor/webhook
    send_resolved: true

Find more documentation on Github

www.matjazcerkvenik.si

Visitors: 2644