README.md

zabbix-alertmanager

Fully automated Zabbix and Prometheus Alertmanager integration.

Tutorials

Introducing ZAL - Zabbix Alertmanager Integration

Setting Up Zabbix Alertmanager integration

Running Zabbix Alertmanager integration

Deployment

Checkout kubernetes-manifests.yaml for deployment in Kubernetes.

Releases page for binaries.

grafana.json for Grafana dashboard.

alerts.yaml for Prometheus alerts.

General Info

Project consists of 2 components:

1. zal send

zal send command, which listens for Alert requests from Alertmanager and sends them to Zabbix.

Run zal send --help to see possible options. Consult Setting Up Zabbix Alertmanager integration for step by step tutorial.

2. zal prov

zal prov command, which reads Prometheus Alerting rules and converts them into Zabbix Triggers.

Run the zal prov --help to get the instructions.

Usage

usage: zal [<flags>] <command> [<args> ...]

Zabbix and Prometheus integration.

Flags:
  -h, --help             Show context-sensitive help (also try --help-long and --help-man).
      --version          Show application version.
      --log.level=info   Log level.
      --log.format=text  Log format.

Commands:
  help [<command>...]
    Show help.

  send --zabbix-addr=ZABBIX-ADDR [<flags>]
    Listens for Alert requests from Alertmanager and sends them to Zabbix.

  prov --config-path=CONFIG-PATH --user=USER --password=PASSWORD [<flags>]
    Reads Prometheus Alerting rules and converts them into Zabbix Triggers.

Zal send

usage: zal send --zabbix-addr=ZABBIX-ADDR [<flags>]

Listens for Alert requests from Alertmanager and sends them to Zabbix.

Flags:
  -h, --help                     Show context-sensitive help (also try --help-long and --help-man).
      --version                  Show application version.
      --log.level=info           Log level.
      --log.format=text          Log format.
      --addr="0.0.0.0:9095"      Server address which will receive alerts from alertmanager.
      --zabbix-addr=ZABBIX-ADDR  Zabbix address.
      --hosts-path=HOSTS-PATH    Path to resolver to host mapping file.
      --key-prefix="prometheus"  Prefix to add to the trapper item key
      --default-host="prometheus"
                                 default host to send alerts to

Zal prov

usage: zal prov --config-path=CONFIG-PATH --user=USER --password=PASSWORD [<flags>]

Reads Prometheus Alerting rules and converts them into Zabbix Triggers.

Flags:
  -h, --help                     Show context-sensitive help (also try --help-long and --help-man).
      --version                  Show application version.
      --log.level=info           Log level.
      --log.format=text          Log format.
      --config-path=CONFIG-PATH  Path to provisioner hosts config file.
      --user=USER                Zabbix json rpc user.
      --password=PASSWORD        Zabbix json rpc password.
      --url="http://127.0.0.1/zabbix/api_jsonrpc.php"
                                 Zabbix json rpc url.
      --key-prefix="prometheus"  Prefix to add to the trapper item key.
      --prometheus-url=""        Prometheus URL.