Opsgenie

Opsgenie is mainly used for on-call, alerting, and incident management.

Opsgenie integration is intended for users who have Opsgenie set up as the primary alerting and on-call management system.

The integration between Spot Connect and Opsgenie enables you to trigger a workflow in Spot Connect, when a specific Opsgenie alert goes into the state of ALERT.

Configure Opsgenie

Step 1: Add Integration

Follow the steps listed below in your Opsgenie Account.

1. In your Opsgenie Account, click Teams and then Select your team.

   

2. Click Integrations and then Add Integration.

   

3. Select API as an integration option.

   

4. Enter a name and assign it to the desired team and provide read-only access.

5. Copy the API Key and click Save Integration.

   

Step 2: Configure the Webhook

1. Select Teams and then Your Team.

2. Click Actions and then Add Action Channel.

   

3. Provide a name for the action channel.

   

4. Select Rest Endpoint as a type for the action channel.

   

5. Enter the following fields in the action channel:

   • URL: Copy Webhook URL from the Workflow Webhook URL in the right side panel of your Spot Connect workflow.
   • Custom Headers:
     • Name: x-api-key
     • Value: add Webhook API Key value from the right side panel.

6. Click Create to add Action Channel.

Step 3: Get Webhook API Key Value

Copy the Webhook API Key Value from the Webhook API Key Value field in the right panel of your Spot Connect workflow.

If you do not already have a Spot Connect API Key, create one in the Settings page. In the Settings page, click Resources and then API Keys.

Step 4: Create a Managed Action

1. Select Teams and Action.

2. Click Add Action.

   

3. Select REST Endpoint and then the previously created Action Channel.

4. Click Next and then Create.

   

Step 5: Create Policy for Created Managed Action

1. Select Teams and then Policies.

2. Click Add Action Policy.

   

3. Give the policy a name and description.

4. Switch ON Enable policy when created, add conditions when you want to trigger Webhooks.

5. Then click Create and enable policy.

Integration Actions

You can add Opsgenie Alert (Trigger) action in the Spot Connect workflow builder as part of your workflow.

• Opsgenie Alert

Opsgenie Alert

You can add this action in the Spot Connect workflow builder, as part of your workflow.

Input

Parameter	Description	Required
service_id	Opsgenie service id	True
alert_body	Alert body from Opsgenie	True

Output

Parameter	Type	Description
Output	Object	JSON of incoming alert body from Opsgenie
execution_status	String	Status of run (ie: S_OK / E_FAIL)

Opsgenie Webhook Trigger

To automatically execute a Spot Connect workflow with an Opsgenie alert in real-time, follow the steps here to set up a webhook integration between Spot Connect and Opsgenie.

In Spot Connect

If you do not already have a Spot Connect API Key, create one by completing the following steps:

1. In the left main menu, click Connect and click Settings.
2. Scroll down and under Resources, click API Keys.
3. Create an API Key and click Save.

Create a New Workflow

1. In the left main menu, click Connect and click Workflows.
2. Click New Workflow and enter a name for the workflow.
3. Scroll down and select Opsgenie.
4. Click Create Workflow.
5. In the center panel of the workflow builder, click the Opsgenie trigger node to open the right panel. Under Webhook API Key Name, select an API Key you created earlier.
6. Compose your workflow and save it.

In the workflow builder, click the Opsgenie trigger node to save the following values from the right panel:

• Webhook API Key Value
• Workflow Webhook URL

Action Example

1. Create a new workflow.

2. Give a name and select Opsgenie as the trigger type.

   

3. Select trigger node.

4. Select Webhook API key name.

   

5. Copy the Workflow Webhook URL and use it to integrate the workflow with your Opsgenie Alert.