Azure integration

Set up Azure integration to generate the alerts you want to send to an Incident Management endpoint.

This integration was validated on January 20, 2022.

Create a new Azure integration in APEX AIOps Incident Management

Log in to your Incident Management instance.
Choose Integrations > Ingestion Services > Azure.
Click Add New Integration.
Name the Incident Management endpoint and enter an API description, then click Save.
The integration is displayed in a new page. Click Save at the bottom of the page.

The Azure integration includes a custom endpoint, a set of default mappings to convert Azure alerts to Incident Management events, and a deduplication key to group similar events into alerts. You can set up Azure to send data to this endpoint, as described in the following section.

(Optional) Once your endpoint starts receiving data from Azure, you can customize how the integration maps and deduplicates this data. To learn more about mapping and deduplication, read Use mapping types in custom integrations and Deduplicate events to reduce noise.

Configure your Azure instance

To set up Azure integration to generate the alerts you want to send to the Incident Management endpoint, perform the following steps:

From the Azure console, click the menu icon in the upper left corner, and go to Monitor > Alerts. Click the Action Groups tab and then click Create.
From the Project Details dropdown menus, select a subscription and select or create a resource group.
Under Instance Details, enter an Action Group Name and a Display Name. Note that the display name is limited to 12 characters. Click Next: Notifications.
In the Actions tab, select Webhook as the action type from the dropdown and enter a webhook name.
When the Webhook type is selected, a webhook configuration panel on the right displays. You will set the Incident Management endpoint in this panel.
Navigate to Incident Management Integrations > Ingestion Services > Azure > your-Integration > Step 1 which contains the Incident Management Endpoint and API Key. Copy the endpoint URL.
Return to the Azure console and paste the Incident Management Endpoint into the webhook panel URI field.
In the Webhook panel, paste your Incident Management API key to the beginning of the URI field, after "https://", and add an "@" symbol between the API Key and the endpoint. The resulting URI should have this format:
```
https://<API Key>@<Incident Management Endpoint URL>
```
To create a new API key to use with your integration, follow the instructions in Manage API keys.
Click Yes to enable the common alert schema, then click OK.
Click Next: Tags; these settings are optional.
Click Test Action Group (Preview). Choose Resource Health Alert from the dropdown and click Test. Wait for a success message in Azure and click Done.
In Incident Management, verify that the test event arrived and has been cached in Integrations > Ingestion Services > Azure > your-integration > Map Your Data. If the integration has been saved, it should change from Provisioned to Active status, and an alert should also appear in the Monitor > Alerts view.
In Azure, click Create, then click Refresh to load the configuration.
Navigate to Monitor > Alerts > Alert Rules. Create or choose the rules you want Incident Management to monitor, and add the newly created action group to each of those rules.

In this section:

Azure integration

Create a new Azure integration in APEX AIOps Incident Management

Configure your Azure instance

Search results