Overview

When you configure a service account for a Datadog integration, you can incorporate metadata from your integrations into service definitions in the Software Catalog. You can also use autocomplete and validation features when editing a service definition in an integrated development environment (IDE).

PagerDuty integration

You can add PagerDuty metadata to a service so that the Software Catalog displays and links to information such as who is on-call and whether there are active PagerDuty incidents for the service. Because only one on-call can be displayed, Datadog selects the first user by escalation level, then alphabetically by email.

Setup

You can connect any service in your PagerDuty Service Directory. You can map one PagerDuty service for each service in the Software Catalog.

1. If you have not already done so, set up the Datadog PagerDuty integration.

2. Get your PagerDuty API access key as described in their API Access Key documentation.

3. Enter the API Access Key on Pagerduty Integration Setup to finish configuring it.

4. Update the service definition with the PagerDuty information. For example, pass in the following integrations configuration lines within the full service definition:

   ...
   integrations:
     pagerduty: https://www.pagerduty.com/service-directory/shopping-cart
   ...
   

OpsGenie integration

You can add OpsGenie metadata to a service so that the Software Catalog displays and links to information such as who is on-call for the service.

Setup

1. If you have not already done so, set up the Datadog OpsGenie integration.

2. Get your OpsGenie API access key as described in their API Key Management documentation. This API key requires configuration access and read access rights.

3. Add an account in the Accounts section at the bottom of the integration tile, paste your OpsGenie API access key, and select the region for your OpsGenie account.

4. Update the service definition with the OpsGenie information to link your OpsGenie service with your Datadog service. For example, pass in the following integrations configuration lines within the full service definition:

   "integrations": {
     "opsgenie": {
           "service-url": "https://www.opsgenie.com/service/123e4567-x12y-1234-a456-123456789000",
           "region": "US"
     }
   }
   

Once you’ve completed these steps, an On Call information box appears in the Ownership tab of a service in the Software Catalog.

Further reading

Additional helpful documentation, links, and articles:

Learn about the Service Definition APIDOCUMENTATION Learn about the OpsGenie integrationDOCUMENTATION Learn about the PagerDuty integrationDOCUMENTATION