mirror of
https://github.com/grafana/grafana.git
synced 2025-07-30 23:22:16 +08:00
290612e366
* 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>
78 lines
2.7 KiB
Markdown
78 lines
2.7 KiB
Markdown
---
|
||
aliases:
|
||
- ../../../alerting-rules/manage-contact-points/integrations/pager-duty/ # /docs/grafana/<GRAFANA_VERSION>/alerting/alerting-rules/manage-contact-points/integrations/pager-duty/
|
||
canonical: https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/pager-duty/
|
||
description: Configure the PagerDuty integration for Alerting
|
||
keywords:
|
||
- grafana
|
||
- alerting
|
||
- pagerduty
|
||
labels:
|
||
products:
|
||
- cloud
|
||
- enterprise
|
||
- oss
|
||
menuTitle: PagerDuty
|
||
title: Configure PagerDuty for Alerting
|
||
weight: 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](https://www.pagerduty.com/) 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.
|
||
|
||
1. Refer to [PagerDuty’s services and integrations guide](https://support.pagerduty.com/docs/services-and-integrations#create-a-service).
|
||
|
||
1. 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
|
||
|
||
1. Once the service is created, click **Integrations** within the Service options.
|
||
1. Click **+ Add an integration**.
|
||
1. Select **Events API V2**.
|
||
1. Click **Add**.
|
||
1. Click the drop-down arrow to display the integration details.
|
||
1. Copy the **Integration Key**.
|
||
|
||
## Procedure
|
||
|
||
To create your PagerDuty integration in Grafana Alerting, complete the following steps.
|
||
|
||
1. Navigate to **Alerts & IRM** -> **Alerting** -> **Contact points**.
|
||
1. Click **+ Add contact point**.
|
||
1. Enter a contact point name.
|
||
1. From the Integration list, select **PagerDuty**.
|
||
1. In the **Integration Key** field, copy in your integration key.
|
||
1. Click **Test** to check that your integration works.
|
||
|
||
** For Grafana Alertmanager only.**
|
||
|
||
An incident should display in the Service’s Activity tab in PagerDuty.
|
||
|
||
1. 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.
|
||
|
||
1. In Grafana, navigate to **Alerting** > **Alert rules**.
|
||
1. Edit or create a new alert rule.
|
||
1. Scroll down to the **Configure labels and notifications** section.
|
||
1. Under Notifications click **Select contact point**.
|
||
1. From the drop-down menu, select the previously created contact point.
|
||
1. **Click Save rule and exit**.
|