Unified command-line tool and python SDK for alerta monitoring system.
$ pip install alerta
Options can be set in a configuration file, as environment variables or on the command line. Profiles can be used to easily switch between different configuration settings.
| Option | Config File | Environment Variable | Optional Argument | Default |
|---|---|---|---|---|
| file | n/a | ALERTA_CONF_FILE |
n/a | ~/.alerta.conf |
| profile | profile | ALERTA_DEFAULT_PROFILE |
--profile PROFILE |
None |
| endpoint | endpoint | ALERTA_ENDPOINT |
--endpoint-url URL |
http://localhost:8080 |
| key | key | ALERTA_API_KEY |
n/a | None |
| timezone | timezone | n/a | n/a | Europe/London |
| output | output | n/a | --output OUTPUT, --json |
text |
| color | color | CLICOLOR |
--color, --no-color |
color on |
| debug | debug | DEBUG |
--debug |
no debug |
Configuration file ~/.alerta.conf:
[DEFAULT]
timezone = Australia/Sydney
# output = json
profile = production
[profile production]
endpoint = https://api.alerta.io
key = demo-key
[profile development]
endpoint = http://localhost:8080
debug = yes
Set environment variables:
$ export ALERTA_CONF_FILE=~/.alerta.conf
$ export ALERTA_DEFAULT_PROFILE=production
Use production configuration settings by default:
$ alerta query
Switch to development configuration settings when required:
$ alerta --profile development query
$ alerta -h
usage: alerta [OPTIONS] COMMAND [FILTERS]
Alerta client unified command-line tool
optional arguments:
-h, --help show this help message and exit
--profile PROFILE Profile to apply from /Users/nsatterl/.alerta.conf
--endpoint-url URL API endpoint URL
--output OUTPUT Output format of "text" or "json"
--json, -j Output in JSON format. Shortcut for "--output json"
--color, --colour Color-coded output based on severity
--debug Print debug output
Commands:
COMMAND
send Send alert to server
query List alerts based on query filter
watch Watch alerts based on query filter
top Show top offenders and stats
raw Show alert raw data
history Show alert history
tag Tag alerts
untag Remove tags from alerts
ack Acknowledge alerts
unack Unacknowledge alerts
close Close alerts
delete Delete alerts
heartbeat Send heartbeat to server
status Show status and metrics
uptime Show server uptime
version Show alerta version info
help Show this help
Filters:
Query parameters can be used to filter alerts by any valid alert attribute
resource=web01 Show alerts with resource equal to "web01"
resource!=web01 Show all alerts except those with resource of "web01"
event=~down Show alerts that include "down" in event name
event!=~down Show all alerts that don't have "down" in event name
Special query parameters include "limit", "sort-by", "from-date" and "q" (a
json-compliant mongo query).
The alerta client python package can also be used as a Python SDK.
>>> from alerta.api import ApiClient
>>> from alerta.alert import Alert
>>>
>>> api = ApiClient(endpoint='http://api.alerta.io', key='tiPMW41QA+cVy05E7fQA/roxAAwHqZq/jznh8MOk')
>>> alert = Alert(resource='foo', event='bar')
>>> alert
Alert(id='6e625266-fb7c-4c11-bf95-27a6a0be432b', environment='', resource='foo', event='bar', severity='normal', status='unknown')
>>> api.send(alert)
{u'status': u'ok', u'id': u'5fdb224b-9378-422d-807e-fdf8610416d2'}
>>> api.get_alert('5fdb224b-9378-422d-807e-fdf8610416d2')['alert']['severity']
u'normal'
>>>
>>> api.get_alerts(resource='foo')['alerts'][0]['id']
u'5fdb224b-9378-422d-807e-fdf8610416d2'
>>> from alerta.heartbeat import Heartbeat
>>> hb = Heartbeat(origin='baz')
>>> hb
Heartbeat(id='21d586a6-9bd5-4b18-b0bb-4fb876db4851', origin='baz', create_time=datetime.datetime(2014, 6, 14, 20, 2, 33, 55118), timeout=300)
>>> api.send(hb)
{u'status': u'ok', u'id': u'6bf11e97-9664-4fa3-b830-8e6d0d84b4cc'}
>>>
Copyright (c) 2015 Nick Satterly. Available under the MIT License.