Microsoft Azure Alerts Integration Guide

Microsoft Azure is a comprehensive collection of integrated cloud services deployed within Microsoft-managed datacenters. Integrating Azure with PagerDuty will allow you to receive alerts for platform-level metrics, Application Insights (for standard and custom metrics), Autoscale Notifications, and Audit Log Events.

In PagerDuty

  1. From the Configuration menu, select Services.
  2. On your Services page:If you are creating a new service for your integration, click +Add New Service.

    If you are adding your integration to an existing service, click the name of the service you want to add the integration to. Then click the Integrations tab and click the +New Integration button.

    RS-Add-New-Service

    RS-Add-Integration-Existing-Service

  3. Select your app from the Integration Type menu and enter an Integration Name.

    If you are creating a new service for your integration, in General Settings, enter a Name for your new service. Then, in Incident Settings, specify the Escalation Policy, Notification Urgency, and Incident Behavior for your new service.

  4. Click the Add Service or Add Integration button to save your new integration. You will be redirected to the Integrations page for your service.RS-Integration-Settings
  5. Copy the Integration URL for your new integration.
    RS-Integration-URL

In Microsoft Azure

  1. Log in to the Azure portal.

    Note: Alert webhooks can only be set in the modern portal, not the classic portal.

  2. Select your desired service type on the left menu, then click the resource you want to receive alerts for. For this example, we’re configuring an alert for a Virtual machine (classic), but you can receive alerts in PagerDuty from any Azure service.

  3. Click on the metric you want to receive alerts for, such as CPU usage or disk I/O, then click Add alert on the window that opens to the right.

  4. Give your alert a Name, choose the Metric, then specify the ConditionThreshold and Period. Finally, paste the URL you copied from PagerDuty earlier in to the Webhook field and click OK.

  5. You’re done! Microsoft Azure alerts will now be able to trigger incidents in PagerDuty, providing a link back to the Azure portal for more details.

FAQ

What types of Azure alerts are supported?

PagerDuty currently supports the following alerts from Microsoft Azure webhooks:

  • Platform-level metrics for Azure services
  • Application Insights (for standard and custom metrics)
  • Autoscale Notifications
  • Audit Log Events

Does this integration support auto-resolution of PagerDuty incidents?

Yes, incidents will be resolved in PagerDuty when an alert clears in Microsoft Azure.

How can I test the integration to make sure incidents will be triggered in PagerDuty?

Simply modify your alert rules in Microsoft Azure to trigger under a condition you know will be met (i.e. CPU usage over 1%) to create a test incident in PagerDuty. You can set the alert threshold back to the level you actually want to be alerted at after you’ve verified the integration works.

Can I point multiple Microsoft Azure alerts at the same PagerDuty service, or multiple PagerDuty services?

Yes, you can use the same Integration URL from a single PagerDuty service for any number of Azure alerts you like, or create multiple PagerDuty services and copy the unique Integration URL from each PagerDuty service in to the desired Azure alert webhook.