zulip/zerver/webhooks/alertmanager/doc.md

Zulip Prometheus Alertmanager integration

Get Zulip notifications from Prometheus Alertmanager!

{start_tabs}

1. {!create-channel.md!}

2. {!create-an-incoming-webhook.md!}

3. {!generate-webhook-url-basic.md!}

4. In your Alertmanager config, set up a new webhook receiver, like so:

   - name: ops-zulip
     webhook_configs:
       - url: "<the URL generated above>"
   

{end_tabs}

{!congrats.md!}

Configuration options

• You can specify a field defined in your alerting rules (for labels and/or annotations) that will be used to group alerts with the same status into a single alert message in Zulip by appending a name parameter to the generated URL, e.g., &name=severity. The default name value used in the integration is instance.

• You can specify a field defined in your alerting rules (for labels and/or annotations) that will be used in the alert message text in Zulip by appending a desc parameter to the generated URL, e.g., &desc=description. The default desc value used in the integration is alertname.

Related documentation

{!webhooks-url-specification.md!}