Configuring Opsgenie

Opsgenie is fully integrated with Uptime.com to allow you to push alerts to their platform, and we have worked together to make the integration seamless. To get started, you will first need to set up an Opsgenie account at https://www.opsgenie.com/. Uptime.com requires the following:

  • API Endpoint - Uptime.com autofills this field
  • API Key
  • Name for the integration

Integration Functionality

Integration with Opsgenie allows for the following:

  • When an alert is created in Uptime, an alert is created in Opsgenie automatically through the integration.
  • When the alert is cleared on Uptime, the related alert is resolved in Opsgenie.   

Integration Setup

First, login to your Opsgenie account, and visit the Opsgenie Uptime Integration page. Copy the API Key you find there, as depicted below:

finding-api-key.png

For Free and Essentials plans, you can only add the integrations from the Team Dashboards, please use the alternative instructions given below to add this integration.

Next, specify who is notified of Uptime alerts using the Teams field. Auto-complete suggestions are provided as you type.

You can also add the Integration from the Team Dashboard of the team which will own the Uptime Integration. To add an Integration directly to a team, navigate to the Team Dashboard and open Integrations tab. Click Add Integration and select the integration that you would like to add.

Click Save Integration.   

Return to Uptime.com. In order to activate the integration of OpsGenie within your Uptime account, you will go to Notifications>Integrations, then click New Profile. Select  OpsGenie as the Provider Type.

Paste the API Key copied previously into the "API Key" field, Name this Integration, and then click Save.

ops-genie-screen.png

Once you've configured your Opsgenie integration, you will need to assign it to a contact and make sure that contact is notified when a Check fails.

Assign Integration to Existing Contacts

To add your integration to an existing contact, click on or type the name of the contact into the Assign to Contacts field within the integration setup screen.

contacts.png

Create New Contacts for the Integration

Adding a dedicated or new contact cannot be done within the integrations screen. To do so first, click Notifications>Contacts. You can select New Contact, or add your integration to an existing contact.

Select Opsgenie from the Push Notifications field within the New Contact screen.

Assign Integration Contact to a Check

If you have created a new or dedicated contact for your integration, you will need to add it to specific checks. If you have assigned the integration to a contact that is already assigned to one (or more) checks, you may skip this step.

Return to your Check’s Edit screen and assign this contact to the Contacts field to be notified of a downtime event. Alert data will appear in real time.

Test Your Integration

Test your integration with one of the following two options:

  1. Force the Check assigned to your Integration to fail by altering it (HTTPS checks can use a misspelling of the domain, for example)
  2. Click Notifications>Contacts, then click Actions>Test to send a test to the Contact

 

Test.png