
* Sort list of contact points on the sidebar * Update `Configure contact points` to clarify contact point integrations * Alerting HTTP API: fix `EmbeddedContactPoint` properties table * HTTP Alerting API: clarify how `ContactPoint.name` groups contact points * Update docs/sources/alerting/configure-notifications/manage-contact-points/_index.md Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com> --------- Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
2.7 KiB
aliases | canonical | description | keywords | labels | menuTitle | title | weight | |||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/pager-duty/ | Configure the PagerDuty integration for Alerting |
|
|
PagerDuty | Configure PagerDuty for Alerting | 150 |
Configure PagerDuty for Alerting
Use the Grafana Alerting - PagerDuty integration to receive notifications in PagerDuty when your alerts are firing.
Before you begin
To set up PagerDuty for integration with Grafana Alerting, you need to create a PagerDuty account. There are several set up steps to perform within PagerDuty before you set up the integration in Grafana Alerting.
Create a Service
In PagerDuty, a service represents a component, microservice, or infrastructure element that a team oversees, manages, and monitors.
-
Follow steps 1 to 5 under Create a Service.
{{< admonition type="note" >}} In step 5, choose Create a service without an integration. {{< /admonition >}}
Obtain a PagerDuty integration key
- Once the service is created, click Integrations within the Service options.
- Click + Add an integration.
- Select Events API V2.
- Click Add.
- Click the drop-down arrow to display the integration details.
- Copy the Integration Key.
Procedure
To create your PagerDuty integration in Grafana Alerting, complete the following steps.
-
Navigate to Alerts & IRM -> Alerting -> Contact points.
-
Click + Add contact point.
-
Enter a contact point name.
-
From the Integration list, select PagerDuty.
-
In the Integration Key field, copy in your integration key.
-
Click Test to check that your integration works.
** For Grafana Alertmanager only.**
An incident should display in the Service’s Activity tab in PagerDuty.
-
Click Save contact point.
Next steps
The PagerDuty contact point is ready to receive alert notifications.
To add this contact point to your alert, complete the following steps.
- In Grafana, navigate to Alerting > Alert rules.
- Edit or create a new alert rule.
- Scroll down to the Configure labels and notifications section.
- Under Notifications click Select contact point.
- From the drop-down menu, select the previously created contact point.
- Click Save rule and exit.