mqtt-alerts 0.4.1

MQTT alert daemon with pluggable notification backends

mqtt-alerts

mqtt-alerts is a general-purpose MQTT alerting service. It subscribes to MQTT topics, evaluates threshold rules with hold times and hysteresis, persists alert state, and sends notifications through pluggable backends.

It works with mtr2mqtt, but it is not tied to mtr2mqtt. Any publisher that sends JSON payloads to MQTT can use this service.

Key Features

• Multiple independent rules per sensor topic
• Rule hold durations (for) and hysteresis support
• Persistent alert lifecycle: pending, firing, acknowledged, resolved
• SQLite-backed state and restart-safe acknowledgement tracking
• Pluggable notification backends: telegram, ntfy, pushover
• Automatic recovery notifications
• Outbound-only acknowledgement polling (no public webhook required)

Supported Backends

• telegram: push notifications with acknowledgement buttons (polled via Bot API)
• ntfy: outbound push notifications
• pushover: push notifications with emergency receipt acknowledgement support

Documentation

• Documentation index
• Configuration guide
• Notification backends
• Examples
• Deployment
• Development

Quick Start

Install:

pip install mqtt-alerts

Run:

mqtt-alerts --config sample_config.yml

Container:

docker run --rm \
  -v "$(pwd)/sample_config.yml:/config/config.yml:ro" \
  -v "$(pwd)/state:/state" \
  tvallas/mqtt-alerts:latest \
  --config /config/config.yml