alertify/README.md

75 lines
1.8 KiB
Markdown
Raw Permalink Normal View History

2020-10-13 17:26:14 +01:00
This application bridges [Prometheus Alertmanager](https://prometheus.io/docs/alerting/latest/alertmanager/) alerts to [Gotify](https://gotify.net/).
# Usage
```
usage: alertify.py [-h] [-c CONFIG] [-H]
2020-10-13 17:26:14 +01:00
Bridge between Prometheus Alertmanager and Gotify
optional arguments:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
path to config YAML. (default: alertify.yaml)
-H, --healthcheck simply exit with 0 for healthy or 1 when unhealthy
2020-10-13 17:26:14 +01:00
The following environment variables will override any config or default:
* LISTEN_PORT (default: 8080)
* GOTIFY_SERVER (default: localhost)
* GOTIFY_PORT (default: 80)
* GOTIFY_KEY (default: None)
* VERBOSE (default: False)
2020-10-13 17:26:14 +01:00
```
2020-10-13 15:31:33 +01:00
# Notes
2020-10-13 15:36:16 +01:00
* Listens on port 8080 by default.
2020-10-13 15:31:33 +01:00
* Forwards `resolved` alerts, if sent.
* Defaults, if not sent:
| Field | Default value |
|-------------|---------------|
| Priority | `5` |
| Description | `...` |
| Severity | `Default` |
# Docker
2020-10-13 15:44:31 +01:00
## Build
```bash
docker build . -t 'alertify:latest'
```
2020-10-13 15:31:33 +01:00
## Run
e.g.
```bash
2020-10-13 15:44:31 +01:00
docker run --name alertify -p 8080:8080 -e TZ=Europe/London -e GOTIFY_KEY=XXXXXXXX -e GOTIFY_SERVER=gotify -e GOTIFY_PORT=80 alertify:latest
2020-10-13 15:31:33 +01:00
```
## Compose:
```yaml
---
version: "2"
services:
gotify:
image: gotify/server:latest
container_name: gotify
environment:
- TZ=Europe/London
volumes:
- config/config.yml:/etc/gotify/config.yml
- data:/app/data
restart: unless-stopped
alertify:
image: alertify:latest
container_name: alertify
2020-10-13 15:36:16 +01:00
ports:
- "8080:8080"
2020-10-13 15:31:33 +01:00
environment:
- TZ=Europe/London
- GOTIFY_KEY=XXXXXXXXXXXX
- GOTIFY_SERVER=gotify
- GOTIFY_PORT=80
restart: unless-stopped
```