Set up monitoring notifications with Azure Alerts

After setting up Azure Monitor integration, you can start setting up monitoring notifications with Azure Alerts.

Azure Alerts is a unified notification hub for all types of important conditions found in Azure monitoring data. The integration of Azure Alerts enables you to consume alerts, which are automatically transformed into events that are leveraged by Davis AI for deeper insights.

To set up monitoring notifications with Azure Alerts you need to do the following steps.

1. Create an API token

To generate an API token

  1. In the Dynatrace menu, go to Settings > Integration > Dynatrace API and select Generate token.
  2. Enter a name for your token.
  3. Select API v1.
  4. Enable Data ingest, e.g.: metrics and events.
  5. Select Generate.

Note: You can assign multiple permissions to a single token, or you can generate several tokens, each with different access levels, and use them accordingly. Check your organization's security policies for best practices.

2. Configure one or more designated ActiveGates

Note: The ActiveGate designated to consume Azure Alerts doesn't have to be the same ActiveGate that runs the Azure Monitor integration.

To configure a designated ActiveGate to consume Azure Alerts

  1. Configure a valid TLS certificate (not a self-signed certificate) for the ActiveGate to communicate via HTTPS. Ensure that root certificate is accepted by Azure. For details, see how to configure custom SSL certificate for an ActiveGate.

  2. Add the following lines to your ActiveGate custom.properties file and restart the ActiveGate after applying the configuration.

    [azure_monitoring]
    event_servlet = true
    
  3. Give access to ActiveGate for Azure Alerts source IP addresses.

For more details, see source IP address ranges in Azure documentation.

3. Configure Azure Alerts via webhook

Azure Alerts consumed via webhooks are configured in your Azure Alert Rules. The alerts are mapped to the closest known matching entity. This means that they either map to their related Azure resource entity or, as a fallback, to the Azure subscription of the resource.

To configure Azure Alerts via webhook

  1. In Azure Portal, go to Home > Monitor > Manage actions.

  2. Go to Actions > Action type and select Webhook.

  3. Give a name to the action.

  4. For the URI field, enter https://<YOUR_ACTIVEGATE_ADDRESS>:9999/modules/azure_monitoring/alerts_webhook?token=<YOUR_API_TOKEN>.

    Note: Be sure to replace <YOUR_ACTIVEGATE_ADDRESS> and <YOUR_API_TOKEN> with your own values.

  5. For Enable the common alert schema, select No.

For more information, see Webhook rules in Azure documentation.

Azure Alert types

The following alert types are supported.

Metric alerts

Metric alerts are complementary to Dynatrace integration of Azure Monitor metrics.

Metric alerts enable you to retrieve metric-based events without the need to push the metrics to Dynatrace. This is helpful in reducing API and network pressure, especially in cases where you might not need the metric (for example, for charting purposes).

The event type is defined based on alert Severity:

  • Sev-0 (Critical): ERROR_EVENT
  • Sev-1 (Error): PERFORMANCE_EVENT
  • Sev-2 (Warning): RESOURCE_CONTENTION_EVENT
  • Default (Informational): CUSTOM_ANNOTATION

Activity alerts

Dynatrace supports three types of activity notifications.

Activity Log Resource Health

The event type is defined based on severity Level:

  • Critical: AVAILABILITY_EVENT
  • Error: AVAILABILITY_EVENT
  • Default: CUSTOM_ANNOTATION

See Configure resource health alerts using Azure portal in Azure documentation for more information.

Activity Log Service Health

The event type is defined based on IncidentType:

  • ActionRequired: ERROR_EVENT
  • Incident or Security + Error: ERROR_EVENT
  • Default: CUSTOM_ANNOTATION

See Create activity log alerts on service notifications using the Azure portal in Azure documentation for more information.

Activity Log Administrative

  • Default: CUSTOM_ANNOTATION