Skip to main content

Alerta Blackout enhancement plugin

Project description

Alerta plugin to enhance the blackout management, by matching the alerts against blackouts with PCRE (Perl Compatible Regular Expression) on attributes.

A blackout is considered matched when all its attributes are matched.

Once an alert is identified as matching a blackout, a special label is applied, with the format: regex_blackout=<blackout id>, where blackout id is the ID of the matched blackout, e.g., regex_blackout=d8ba1d3b-dbfd-4677-ab00-e7f8469d7ad3. This way, when the alert is fired again, there’s no need to verify the matching again, but simply verify whether the blackout referenced is still active.


This shouldn’t normally affect the existing blackouts you may have in place, as the regex matching should only kick in after the native blackout matching mechanism in Alerta.


This plugin is designed to be installed on the Alerta server; the package is available on PyPI so you can install as:

pip install alerta-blackout-regex


Add blackout_regex to the list of enabled PLUGINS in alertad.conf server configuration file and set plugin-specific variables either in the server configuration file or as environment variables.

PLUGINS = ['blackout_regex']


Copyright (c) 2020 Mircea Ulinic. Available under the Apache License 2.0.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for alerta-blackout-regex, version 1.0.5
Filename, size File type Python version Upload date Hashes
Filename, size alerta_blackout_regex-1.0.5-py2.py3-none-any.whl (8.6 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size alerta-blackout-regex-1.0.5.tar.gz (8.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page