Opsgenie

📘

API integration key with write access required

An API integration key with write permission is required to access various Alert API endpoints. This is essential for creating alerts through the Opsgenie API. For details, please see the Opsgenie Alert API documentation and API Integration documentation.

In Opsgenie

1. First identify or create an Opsgenie team responsible for responding to alerts generated by Monte Carlo.
2. Within that team, go to the Settings tab. Then navigated to Integrations and click the Add Integration button.
3. Search for "API" and choose the API integration.
4. Provide a name for the new integration, e.g. “Monte Carlo”.
5. From the drop down, assign the team responsible for responding to Monte Carlo alerts.
6. Click the Continue button.
7. From here, you will be able to see the API key. Please copy it and save it somewhere for use later. You will need to provide this key to Monte Carlo so that we can create alerts on your behalf.
8. Important: This integration is not active until you click the Turn on integration button. So please click that button now. You can then close the integration details page.

In Monte Carlo

1. From the Settings tab, click on Integrations, then scroll down to the Notifications and collaboration section.
2. In that section, click the Create drop down button and select Opsgenie from the list.
3. From there you can provide the details of your Opsgenie integration. Provide a display name and the copied API key from earlier.
4. Select the correct Opsgenie API URL for your region.
5. By default, bidirectional sync is turned on and a Webhook URL is generated for you. Please copy this URL and save it for later.
6. For additional security you can also specify a header name and secret value. If provided, we will use this information to verify your incoming webhooks. Be sure to copy and save the header name a secret for later.

Back in Opsgenie

1. Return to the Integrations page in Opsgenie.
2. For bidirectional sync between Opsgenie and Monte Carlo, you will need to add a Webhook integration. Click the Add integration button again and this time search for "Webhook". Choose the Webhook integration from the search results. You will again need to provide an integration name and assign a team, then click Continue.
3. Make sure, at the very least, that you've enabled the following Alert actions by checking the checkboxes for:
   1. Alert is created
   2. Alert is acknowledged
   3. Alert is unacknowledged
   4. Note is added
   5. Alert is closed
   6. Alert is assigned
   7. Alert ownership is taken
   8. Alert priority is updated
4. You should now be looking at the integration settings for your new integration. Now click the Edit button to edit the settings for this integration. By default the outgoing authentication is turned off. For this integration to work with Monte Carlo, please choose Authenticate with a Webhook account from the available options.
5. Paste in the generated Webhook URL from Monte Carlo. Then if you have a security header and secret, click the Add extra property link and fill in those details too.
6. Once you're done, click the Save button to save your changes.
7. Important: Now click the Turn on integration button to activate this integration.

Bidirectional Sync

Once configured and activated, bidirectional sync will ensure that the Monte Carlo Alert and the Opsgenie Incident stay in sync.

• Status will sync to and from Opsgenie:
  • Monte Carlo's "No Status" → Opsgenie's "Open"
  • Monte Carlo's "Acknowledged" → Opsgenie's "Acknowledged"
  • Monte Carlo's "Fixed" → Opsgenie's "Closed" or "Deleted"
• Comments made on Monte Carlo with be synced to Opsgenie Notes and vice versa.
• The priority of the Monte Carlo Alert will match the created Opsgenie Incident. Changes to the Opsgenie priority will sync back to Monte Carlo.
• Assigned user ownership will sync as well.