Skip to main content
Send alerts to Opsgenie

Send alerts to Opsgenie for incident management and on-call rosters.

Audrey Garcia avatar
Written by Audrey Garcia
Updated over 5 months ago

Beacon is now Guard Detect, which is part of Atlassian Guard. Read the blog

Use webhooks and Jira Automation to send alerts to Opsgenie. About Jira Automation

Step 1: Create a new API integration in Opsgenie

In Opsgenie you can create an API integration either in Settings or in a team. In this example we’ll create the integration for a team. How to create an API integration in Opsgenie

To create a new API integration in Opsgenie:

  1. In Opsgenie, navigate to your team and select Integrations.

  2. Select Add integration.

  3. Search for the API integration.

  4. Name your integration, for example Atlassian Alerts, and assign it to a team.

  5. Select Continue.

  6. Make a note of the API key, you’ll need this in a later step.

Step 2: Create a Jira automation rule and get the webhook URL

You can create the automation rule as a global rule, or in a Jira project if you’re not a Jira administrator. In this example we’ll create the rule in a project.

To create an automation rule in Jira:

  1. In Jira, navigate to a project.

  2. Go to Project settings > Automation.

  3. Select Create rule.

  4. Search for the Incoming webhook component.

  5. Select No issues from the webhook when asked how to execute the automation rule.

  6. Copy the Webhook URL. You’ll need this in the next step.

  7. Save your changes to the Incoming webhook component.

Step 3: Add the webhook URL to Guard Detect

To add the webhook URL:

  1. In Guard Detect, go to Integrations > SIEM forwarding.

  2. Select Add webhook.

  3. Paste the Webhook URL you copied from Jira and Save.

Webhooks screen showing a webhook and add webhook button

Step 4: Configure the automation rule to create an issue

  1. In Jira, go back to your automation rule and select THEN: Add an action.

  2. Search for the Send web request component.

  3. Enter the web request details, including the Opsgenie API URL and API key. Refer to the table below for more information.

  4. Save your changes to the Send web request component.

  5. Name your automation rule and select Turn it on.

Web request details

Use the following information to configure the web request.

Web request URL

https://api.opsgenie.com/v2/alerts

Headers

Add an Authorization header and specify your Opsgenie API key as the value in the format GenieKey <API key> . Learn more about authentication in Opsgenie

HTTP method

POST

Web request body

Custom data

Custom data

You can include data from the webhook payload in the Opsgenie alert. For example, you could include the Guard Detect alert title, as follows.

{ "message":"{{webhookData.alertTitle}}" }

This is a simple example. You can use any of the attributes in the Guard Detect webhook payload and map them to Opsgenie fields.

Step 4: Send a test alert

To send a test alert:

  1. In Guard Detect, go to Integrations > SIEM forwarding.

  2. Select Send test alert.

If the integration is working you should see a new alert for your Opsgenie team.

Opsgenie Alerts list showing an alert from Beacon

Did this answer your question?