This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.
Configure contact points
Use contact points to specify where to receive alert notifications. Contact points contain the configuration for sending alert notifications, including destinations like email, Slack, OnCall, webhooks, and their notification messages.
A contact point can have one or multiple destinations, known as contact point integrations. Alert notifications are sent to each integration within the chosen contact point.
On the Contact Points tab, you can:
- Add, edit, and view contact points and integrations.
- Search for name and type of contact points and integrations.
- View how many notification policies each contact point is being used for and navigate directly to the linked notification policies.
- View the status of notification deliveries.
- Export individual contact points or all contact points in JSON, YAML, or Terraform format.
- Delete contact points. Note that you cannot delete contact points that are in use by a notification policy. To proceed, either delete the notification policy or update it to use another contact point.
Add a contact point
Complete the following steps to add a contact point.
- In the left-side menu, click Alerts & IRM and then Alerting.
- Click Contact points.
- From the Choose Alertmanager dropdown, select an Alertmanager. By default, Grafana Alertmanager is selected.
- On the Contact Points tab, click + Add contact point.
- Enter a descriptive name for the contact point.
- From Integration, select a type and fill out mandatory fields. For example, if you choose email, enter the email addresses. Or if you choose Slack, enter the Slack channel and users who should be contacted.
- Some contact point integrations, like email or Webhook, have optional settings. In Optional settings, specify additional settings for the selected contact point integration.
- In Notification settings, optionally select Disable resolved message if you do not want to be notified when an alert resolves.
- Save your changes.
Add another contact point integration
A contact point can have multiple integrations, or destinations for sending notifications.
To add another integration to a contact point, complete the following steps.
- Add or edit an existing contact point.
- Click Add contact point integration and repeat the same steps as Add a contact point.
- From Integration, select a type and fill out mandatory fields.
- In Optional settings, specify additional settings for the selected contact point integration.
- Save your changes.
Test a contact point
Testing a contact point is only available for Grafana Alertmanager. Complete the following steps to test a contact point.
- In the left-side menu, click Alerts & IRM and then Alerting.
- Click Contact points to view a list of existing contact points.
- On the Contact Points tab, find the contact point you want to test, then click Edit. You can also create a new contact point if needed.
- Click Test to open the contact point testing dialog box.
- Choose whether to send a predefined test notification or choose custom to add your own custom annotations and labels to include in the notification.
- Click Send test notification to fire the alert.
List of supported integrations
Each contact point integration has its own configuration options and setup process. In most cases, this involves providing an API key or a Webhook URL.
The following table lists the contact point integrations supported by Grafana.
Name | Type |
---|---|
Alertmanager | prometheus-alertmanager |
Amazon SNS | sns |
Cisco Webex Teams | webex |
DingDing | dingding |
Discord | discord |
email | |
Google Chat | googlechat |
Grafana Oncall | oncall |
Kafka REST Proxy | kafka |
Line | line |
Microsoft Teams | teams |
MQTT | mqtt |
Opsgenie | opsgenie |
Pagerduty | pagerduty |
Pushover | pushover |
Sensu Go | sensugo |
Slack | slack |
Telegram | telegram |
Threema Gateway | threema |
VictorOps | victorops |
Webhook | webhook |
WeCom | wecom |
Some of these integrations are not compatible with external Alertmanagers. For the list of Prometheus Alertmanager integrations, refer to the Prometheus Alertmanager receiver settings.
Customize notification messages
In contact points, you can also customize notification messages. For example, when setting up an email contact point integration, click Message or Subject to modify it.
By default, notification messages include common alert details, which are usually sufficient for most cases.
If necessary, you can customize the content and format of notification messages. You can create a custom notification template, which can then be applied to one or more contact points.
On the Notification templates tab, you can view, edit, copy or delete notification templates. Refer to manage notification templates for instructions on selecting or creating a template for a contact point.