PagerDuty Integration

Cloudhouse Guardian (Guardian) offers several integrations that let you build on the application's core functionality by connecting to external services. One integration available in Guardian is with PagerDuty, an IT incident response service. With this integration, you can connect to your existing PagerDuty account and then configure Guardian actions that automatically log incidents related to your Guardian inventory within PagerDuty.

Note: This topic focuses on setting up the PagerDuty integration. If you've already set up the integration and want to configure PagerDuty actions, see Action: Trigger a PagerDuty Service

Dependencies

To add a PagerDuty integration, you need:

  • A PagerDuty account in which you have one of the following roles: Manager, Administrator, Global Administrator, or Account Owner.

  • A PagerDuty integration key.

Add a PagerDuty Integration

Integrating PagerDuty withGuardianestablishes a seamless connection to configureGuardianactions that automatically log incidents in PagerDuty.

To add a PagerDuty integration, complete the following steps:

  1. In the Guardian web application, navigate to the Integrations tab (Control > Integrations) and click Add Integration. The Add Integration page is displayed.

  2. Select PagerDuty from the list of available integrations. Here, you are required to complete the following options:

    Screenshot of the Guardian Add Integrations page with a highlight box around the PagerDuty button.

    Option

    Description

    Name field

    		 The display name for the integration within Guardian. This name is how you will identify the integration among all others configured in your Guardian instance, so ensure it is descriptive.

    PagerDuty Endpoint field

    This integration relies on PagerDuty's events API, which uses the endpoint https://events.pagerduty.com/generic/2010-04-15/create_event.json. Enter this endpoint in this field.

    Integration Key field

    To connect Guardian to your PagerDuty instance, you need a PagerDuty integration key. This key can be obtained by configuring a new service within PagerDuty. For more information, refer to PagerDuty's Create a Generic Events API Integration article.

  3. Once you have set the correct values for each of the options displayed, click Done to create the PagerDuty integration.

If successful, a confirmation message is displayed and the PagerDuty integration is added to the Integrations tab of your Guardian instance. You can also confirm the integration is successful within PagerDuty. On the PagerDuty Services page, you will see an incident triggered by Guardian. This is a handshake message, indicating that the connection has been made.

If unsuccessful, an error message is displayed in Guardian. Use the information displayed in the error message(s) to troubleshoot the values in your PagerDuty Integration options.