Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
Configure contact points
Use contact points to define how your contacts are notified when an alert rule fires. You can add, edit, delete, and test a contact point.
Configure contact point integrations in Grafana to select your preferred communication channel for receiving notifications when your alert rules are firing.
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(s) 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.
- To add another contact point integration, click Add contact point integration and repeat steps 6 through 8.
- Save your changes.
Edit a contact point
Complete the following steps to edit 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 edit, and then click Edit.
- Update the contact point and save your changes.
Delete a contact point
Complete the following steps to delete 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 delete, and then click More -> Delete.
- In the confirmation dialog, click Yes, delete.
Note
You cannot delete contact points that are in use by a notification policy. Either delete the notification policy or update it to use another contact point.
Test a contact point
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 modal.
- 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.
Manage contact points
The Contact points list view lists all existing contact points and notification templates.
On the Contact Points tab, you can:
- Search for name and type of contact points and integrations
- View all existing 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 that are not in use by a notification policy
On the Notification templates tab, you can:
- View, edit, copy or delete existing notification templates
Configure contact point 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.
Once configured, you can use integrations as part of your contact points to receive notifications whenever your alert changes its state. In this section, we’ll cover the basic steps to configure your integrations, so you can start receiving real-time alerts and stay on top of your monitoring data.
List of supported integrations
Name | Type |
---|---|
DingDing | dingding |
Discord | discord |
email | |
Discord | discord |
email | |
Google Chat | googlechat |
Grafana Oncall | oncall |
Hipchat | hipchat |
Kafka | kafka |
Line | line |
Microsoft Teams | teams |
Opsgenie | opsgenie |
Pagerduty | pagerduty |
Prometheus Alertmanager | prometheus-alertmanager |
Pushover | pushover |
Sensu | sensu |
Sensu Go | sensugo |
Slack | slack |
Telegram | telegram |
Threema | threema |
VictorOps | victorops |
Webhook | webhook |