Overview

Create alerts in Opsgenie using @opsgenie-{service-name}:

• By taking a snapshot
• When a metric alert is triggered

Setup

Configuration

Create a Datadog integration in Opsgenie

1. Log in to your Opsgenie account and go to the Opsgenie Integrations page.
2. Search for Datadog and click on the tile.
3. Fill in the Integration Name and, if desired, set the Assignee Team.
4. After clicking Submit, stay on the page and save the API Key of the newly created Integration. You need this to complete the setup.
5. Add more Datadog integrations on Opsgenie by going to the Opsgenie Integrations page and repeating the previous steps.

Register the integration(s) you made in Opsgenie in Datadog

1. In Datadog, go to the Integrations page, then search for and select the Opsgenie tile.
2. Check that you are on the Configuration tab of the dialog box that pops up.
3. Click New Integration Service.
4. Paste the API Key saved earlier from the Datadog integration (created in Opsgenie) in the Opsgenie API Key field, and enter a Service Name.
   1. The Service Name should be descriptive and must be unique. Only alphanumeric values, dashes, underscores, and periods are allowed. Spaces are not allowed.

5. From the Region dropdown, select the United States or Europe depending on where your Opsgenie account operates.
6. Click Save.

Example usage

Route monitor alerts to Opsgenie

1. Create any monitor in the Monitors page.
2. In the monitor body, paste @opsgenie-{service-name} (replace {service-name} with the service name defined in the Opsgenie Integration Tile.)
3. Save the monitor.
4. Go to the Edit Page of the monitor and click “Test Notifications” to issue an example alert using your integration. A corresponding alert should be created in Opsgenie.
5. To notify multiple services, paste @opsgenie-{service-name} @opsgenie-{service-name-2} in the monitor body, and test with the same steps.

Permissions

By default, all users have full access to Opsgenie services.

Use Granular Access Control to limit which roles can edit a specific service:

1. While viewing a service, click the gear icon in the upper-right corner to open the settings menu.
2. Select Set Permissions.
3. Click Restrict Access. The dialog box updates to show that members of your organization have Viewer access by default.
4. Use the dropdown to select one or more roles, teams, or users that can edit the Opsgenie service.
5. Click Add. The dialog box updates to show that the role you selected has the Editor permission.
6. Click Save.

Note: To maintain your edit access to the service, you must include at least one role you belong to before saving.

If you have edit access, you can restore general access to a restricted service by completing the following steps:

1. While viewing the service, click the gear icon in the upper-right corner to open the settings menu.
2. Select Set Permissions.
3. Click Restore Full Access.
4. Click Save.

To edit service permissions through the API:

1. Fetch the Opsgenie service IDs using the Opsgenie Integration API.
2. Use the Restriction Policies API, where the type is integration-service and the id is opsgenie:<service_id>.

Data Collected

Metrics

The Opsgenie integration does not include any metric.

Events

The Opsgenie integration does not include any events.

Service Checks

The Opsgenie integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.

Further Reading

Additional helpful documentation, links, and articles:

Using Integrations with Service CatalogBLOG Create and manage Opsgenie service objects with TerraformTERRAFORM