🚧

Integration Restriction

A Jeli account can only have an Opsgenie or PagerDuty integration configured, not both.

Add the Opsgenie | Jeli Integration

🚧

Required User Permissions

• In Opsgenie: Admin rights are required to create Opsgenie API keys.
• In Jeli: Admin permissions are required to manage Jeli Integrations.

In Opsgenie

Create an Opsgenie API Key

1. Navigate to Settings and select API key management in the left navigation menu.

2. On the page that appears, click Add new API key.

   

3. In the modal, enter a Name for your account key. It’s helpful to name it with something related to Jeli.

4. Under Access rights, make sure to check all four boxes:

   1. Read
   2. Create and update
   3. Delete
   4. Configuration access

5. Copy the generated key to your clipboard.

6. Click Add API key.

In Jeli

Add an Opsgenie API Key for Jeli Incident Analysis

7. Navigate to Settings Integrations Opsgenie.
8. Click Connect Opsgenie.
9. In the Account API key field, paste the Opsgenie-generated API key and click Submit. Opsgenie has now been added to Jeli for Incident Analysis work.

Create an Opsgenie Integration Key for Jeli Incident Response

Integration keys allow you to page to an Opsgenie team through Jeli’s IR bot. If you’re on a non-enterprise tier, Opsgenie requires you to create an integration key for each team.

1. To find your Integrations in Opsgenie, select Teams in the top navigation menu.
2. Select the Team you’d like to create an integration key for.
3. In the left navigation menu, click Integrations.
4. Perform the following based on your use case:
   1. If you have an existing integration: Select the integration from the list, and on the next page copy the API key under the Integration settings section.
   2. If you'd like to add a new integration:
      1. Click Add Integration in the upper right.
      2. Select the API integration in the All Products section.
      3. Enter an Integration name, select an Assignee team and click Continue.
      4. Find the newly created integration and copy its API key as noted above in 4.i.

Add Opsgenie Integration Keys to Jeli

You can add multiple integration keys from Opsgenie, depending upon the account plan with Opsgenie you have. Specifically, OpsGenie Enterprise plans can use one integration key for all teams, but if you wish to page through /jeli escalate in Slack and are on a lower tier in Opsgenie, they will require a separate integration key per team.

1. In Jeli, navigate to Settings Integrations Opsgenie.
2. Click Connect Opsgenie.
3. Make sure you’ve added your Account API key. Under Account API Key, you should see the domain you’ve connected, a date, and by whom.
4. Under Integration API Key, click Add integration key.
5. In the row that appears, add the Team name associated with the key and paste the integration key in the API key field. If you have multiple integration keys, you can add them all at once by continuing to click Add integration key.
6. Click Connect account to save.

Use the Opsgenie | Jeli Integration

Initiate a Page: /jeli page

Once configured, during an active incident channel you can run either /jeli page or /jeli escalate to initiate a page through Opsgenie.

Select the team in Opsgenie you would like to page, and customize the message being sent with additional context as needed.

An Opsgenie alert will be created, and Jeli will update the incident in Slack.

The links provided will allow you to view the alert in Opsgenie and the team assigned to the alerts.

View Opsgenie Details for an Incident: /jeli escalate info

Jeli will display the details of the page as an ephemeral message within the incident chat.