> ## Documentation Index
> Fetch the complete documentation index at: https://metoro.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# PagerDuty Integration

## PagerDuty + Metoro Integration Benefits

* Notify on-call responders based on alerts sent from Metoro.
* Send event details from Metoro including description of the alert that triggered the event.

## How it Works

* When an alert is created in Metoro, you can select a PagerDuty service as the destination for the alert. If the alert breaches the defined threshold, an event will be sent to the selected PagerDuty service.

## Requirements

* To set up the PagerDuty integration in Metoro, you need to be an Admin user.
  * Admin users are listed as "Admin" as their **Role** in **Settings** > **Users** in Metoro.
  * If you are not an Admin user, you will need to contact an Admin user in your organization to set up the integration for you.

## Support

If you need help with this integration, please email [support@metoro.io](mailto:support@metoro.io) or join our [Community Slack](https://join.slack.com/t/metorocommunity/shared_invite/zt-2makpjl5j-F0WcpGnPcdc8anbNGcewqw).

## Integration Walkthrough

### In PagerDuty

* If you already have a PagerDuty service that you would like to use to receive alert events from Metoro, please skip to the **In Metoro** section.
* If you are creating a new service for your integration:
  * Please read PagerDuty documentation in section [Configuring Services and Integrations](https://support.pagerduty.com/docs/services-and-integrations#section-configuring-services-and-integrations) and follow the steps outlined in the [Create a New Service](https://support.pagerduty.com/docs/services-and-integrations#section-create-a-new-service) section.
  * **Important Note**: **Do not** follow the steps in section [Add Integrations to an Existing Service](https://support.pagerduty.com/main/docs/services-and-integrations#add-integrations-to-an-existing-service) as Metoro will do these steps for you.

 

### In Metoro

#### Select PagerDuty Services to Integrate

1. Navigate to **Settings** from the Metoro sidebar.

2. Under the **Integrations** tab in Settings, find the **PagerDuty** integration and click the **Connect to PagerDuty** button.
   <img src="https://mintcdn.com/metoro/ZLKLeijcjMYiIwum/images/connect_to_pagerduty.png?fit=max&auto=format&n=ZLKLeijcjMYiIwum&q=85&s=adc126410ebeaebed2ef032d60406ee5" alt="Settings Integrations tab showing PagerDuty with Connect to PagerDuty button highlighted" width="3456" height="1982" data-path="images/connect_to_pagerduty.png" />

3. You will be redirected to the PagerDuty login page for authorization. Enter your PagerDuty credentials and click **Sign in**.

4. Once you log in, you will be redirected back to Metoro, where the **Connect Metoro and PagerDuty** page will be displayed.
   <img src="https://mintcdn.com/metoro/WUkDA8ZzUF2HFKec/images/redirect_page_pagerduty_integration.png?fit=max&auto=format&n=WUkDA8ZzUF2HFKec&q=85&s=01a778108fb505100b55efc4ecda0bba" alt="Connect Metoro and PagerDuty page with service selector dropdown and Connect button" width="3448" height="1984" data-path="images/redirect_page_pagerduty_integration.png" />

5. Select the PagerDuty service(s) you want to integrate with Metoro from the dropdown list and click **Connect** when you are done. You will be taken back to the **Settings** page in Metoro if the integration is successful.

* **Note**: If you do not see the PagerDuty service you want to integrate with Metoro in the dropdown list, please make sure you have followed the steps in the **In PagerDuty** section above. If you have followed the steps and still do not see the service, please contact us using one of the support options listed in the **Support** section above.
* **Note**: If the integration is successful for the selected service(s), you will see an Integration named **Metoro - PagerDuty** in your PagerDuty account in **Services** > **Service Directory** > select **your service** > under **Integrations** tab.

6. You can view the PagerDuty services you have integrated with Metoro in the **PagerDuty** section under **Integrations** tab in **Settings** and add and remove services as needed at any time.
   <img src="https://mintcdn.com/metoro/WUkDA8ZzUF2HFKec/images/pagerduty_view_services.png?fit=max&auto=format&n=WUkDA8ZzUF2HFKec&q=85&s=ccd215e758e4d4cb04f42bff52befd3d" alt="Settings Integrations showing connected PagerDuty with View Services and Disconnect buttons" width="3448" height="1984" data-path="images/pagerduty_view_services.png" />

 

#### Select PagerDuty as a Destination in Alert Creation

1. Navigate to **Alerts** from the Metoro sidebar. Click the **Create Alert** button and follow the steps to create an alert.
   <img src="https://mintcdn.com/metoro/ZLKLeijcjMYiIwum/images/create_alert.png?fit=max&auto=format&n=ZLKLeijcjMYiIwum&q=85&s=d911b4481e8bb54522622188e22abfbf" alt="Alerts page with Create Alert button highlighted by arrow in the top right corner" width="3448" height="1984" data-path="images/create_alert.png" />
2. In the **Select Destination** section of the alert creation wizard, select **PagerDuty**.
3. When you select **PagerDuty**, you will see an option to configure a PagerDuty Service to send the alerts to. Click **Select** to see a dropdown list of the PagerDuty services you have integrated with Metoro. Select the service you want to send the alerts to.
   <img src="https://mintcdn.com/metoro/WUkDA8ZzUF2HFKec/images/pagerduty_select_destination.png?fit=max&auto=format&n=WUkDA8ZzUF2HFKec&q=85&s=d92c40d3bf1555f599754bddaec61b12" alt="Create Alert wizard with PagerDuty selected as destination and service selector dropdown" width="3448" height="1984" data-path="images/pagerduty_select_destination.png" />
4. Follow the rest of the steps in the alert creation wizard to complete the alert creation.

### How to Uninstall

* In Metoro, navigate to **Settings** from the Metoro sidebar. Under **Integrations** tab, find **PagerDuty** integration and click **Disconnect** button and confirm deletion by clicking **Delete Integration** on the pop-up dialog.
  <img src="https://mintcdn.com/metoro/WUkDA8ZzUF2HFKec/images/pagerduty_disconnect.png?fit=max&auto=format&n=WUkDA8ZzUF2HFKec&q=85&s=30f30cd594ba731dd1944d8a3d253d09" alt="Settings Integrations showing PagerDuty with Disconnect button highlighted by arrow" width="3448" height="1984" data-path="images/pagerduty_disconnect.png" />
