OpsGenie Integration

The OpsGenie integration allows Velocity to ingest information for monitoring and insights

Follow these steps in your OpsGenie account to create an API Key, a webhook, extract your OpsGenie region and share the relevant information with us.

Prerequisites

Before you begin, make sure you have the OpsGenie Secret provided by our team. You can get this by contacting us via your dedicated Slack channel or by emailing us at [e-mail].

Webhooks can only be created for accounts with OpsGenie Standard or Enterprise packages.

Step 1 - Generate an API Key

1. Navigate to Settings and then scroll down and select API Key Management from the left menu

1. Click on Add new API key.

1. Choose "Read" and "Create and Update," give the key a name, and click "Add API Key." Be sure to copy the API key—you’ll need to send it to us later.

Step 2 - Create a webhook

1. Navigate to Settings and then scroll down and select Integrations from the left menu.

2. Click on Integrations in the menu on the left.

1. Click Add Integration in the top-right corner and select Webhook.

2. Enter a name for the integration, keep the Assignee Team as None and click Continue.

   
3. Make sure "Post to Webhook URL for Opsgenie alerts" is selected.

4. Click on the Edit button at the top right.

1. Select "Authenticate with a Webhook account" and set the following configurations:

   1. Webhook URL: https://api.velocity.tech/api/v1/webhooks/opsgenie.

   2. Check "Add alert description to payload".

   3. Check "Add alert details to payload".

1. Under the Custom Headers, click on Add extra property, and add:

   1. Key: "X-Velocity-Auth" .

   2. Value: Paste the Webhook Secret Velocity supplied to you.

1. Click the small "V" button next to the custom header (it’s easy to miss!), then hit "Save" at the bottom.

2. This will bring you back to the main integration page. From there, select all the options under "Alert actions".

3. Finally, click the "Turn on Integration" blue button at the top-right corner. An "Integration added" confirmation box should appear at the bottom.

   

Step 3 - Share information with Velocity

Send your Velocity point of contact the following via your dedicated Slack channel or email us at [e-mail].

1. API Key - From Step 1.

2. Opsgenie API URL - Opsgenie can have two different API URLs, and the one you need depends on where your Opgenie instance is located. -- https://api.opsgenie.com (US) or https://api.eu.opsgenie.com (EU).

3. Organization Opsgenie URL - The main URL that leads to the organization Opsgenie account. For example velocity.app.opsgenie.com