Opsmatic Integration Guide

Opsmatic offers configuration monitoring with automatic drift detection and tools to compare host states and visualize activity.  Using Opsmatic means solving problems faster, with shared visibility for your entire team.

You can configure PagerDuty to push your notification, acknowledgement, and resolution alerts into your Opsmatic feed and timeline views.  Additionally, you can also create incidents in PagerDuty based on failed policy checks, saved search results, or manually with a key event as a trigger.

In Opsmatic

1. Navigate to Manage Organizations.
2. Copy your Opsmatic Integration Token.

In PagerDuty

1. In your account, under the Services tab, select Service Directory from the dropdown menu.
2. Choose an existing PagerDuty service using an API integration which you would like to use to send events to OpsMatic. If you don't already have one, you can create a new service.
3. Click on the name of the service, and within the Integrations tab, find Add or manage extensions.
4. Click New Extension, choose the Generic Webhook type, name your extension, and use the following endpoint URL. Make sure to replace [Your Integration Token] with the integration token you copied from Opsmatic:

   https://api.opsmatic.com/webhooks/events/pagerduty?token=[Your Integration Token]

5. Click save and your webhook is added. You will now see PagerDuty updates in your Opsmatic feed and timeline.

Creating Automatic Incidents

1. Visit the Integration Settings page and add the integration API Key for the PagerDuty service you'd like to use. (A "test" button is provided to ensure your credentials are properly configured.)
2. Go to your Notifications Page to configure the Saved Search matches that should trigger a PagerDuty incident.
3. To create automatic incidents for Assertion results, go to the Assertions Overview page. Click on “Notification destinations” and select the checkbox next to “Create PagerDuty Incident”, then click Save.
4. Go back to the Assertions Overview page. Click on the group that contains the Assertion you want to work with. Select the checkbox next to the PagerDuty icon for each assertion that you want to create an incident for.