zulip/zerver/webhooks/alertmanager/doc.md

44 lines
1.2 KiB
Markdown

# Zulip Prometheus Alertmanager integration
Get Zulip notifications from Prometheus Alertmanager!
{start_tabs}
1. {!create-channel.md!}
1. {!create-an-incoming-webhook.md!}
1. {!generate-webhook-url-basic.md!}
1. 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!}
![](/static/images/integrations/alertmanager/001.png)
### 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!}