Skip to content

Files

Latest commit

johnkemnetzjohnkemnetz
fix a mistake
Sep 8, 2017
5474c71 · Sep 8, 2017

History

History
133 lines (100 loc) · 6.91 KB

insights-alerts-powershell.md

File metadata and controls

133 lines (100 loc) · 6.91 KB
title description author manager editor services documentationcenter ms.assetid ms.service ms.workload ms.tgt_pltfrm ms.devlang ms.topic ms.date ms.author
Create alerts for Azure services - PowerShell | Microsoft Docs
Trigger emails, notifications, call websites URLs (webhooks), or automation when the conditions you specify are met.
rboucher
carmonm
monitoring-and-diagnostics
monitoring-and-diagnostics
d26ab15b-7b7e-42a9-81c8-3ce9ead5d252
monitoring-and-diagnostics
na
na
na
article
10/20/2016
robb

Create metric alerts in Azure Monitor for Azure services - PowerShell

[!div class="op_single_selector"]

Overview

This article shows you how to set up Azure metric alerts using PowerShell.

You can receive an alert based on monitoring metrics for, or events on, your Azure services.

  • Metric values - The alert triggers when the value of a specified metric crosses a threshold you assign in either direction. That is, it triggers both when the condition is first met and then afterwards when that condition is no longer being met.
  • Activity log events - An alert can trigger on every event, or, only when a certain events occurs. To learn more about activity log alerts click here

You can configure a metric alert to do the following when it triggers:

  • send email notifications to the service administrator and co-administrators
  • send email to additional emails that you specify.
  • call a webhook
  • start execution of an Azure runbook (only from the Azure portal)

You can configure and get information about alert rules using

For additional information, you can always type Get-Help and then the PowerShell command you want help on.

Create alert rules in PowerShell

  1. Log in to Azure.

    Login-AzureRmAccount

  2. Get a list of the subscriptions you have available. Verify that you are working with the right subscription. If not, set it to the right one using the output from Get-AzureRmSubscription.

    Get-AzureRmSubscription
Get-AzureRmContext
Set-AzureRmContext -SubscriptionId <subscriptionid>

  3. To list existing rules on a resource group, use the following command:

    Get-AzureRmAlertRule -ResourceGroup <myresourcegroup> -DetailedOutput

  4. To create a rule, you need to have several important pieces of information first.

  • The Resource ID for the resource you want to set an alert for

  • The metric definitions available for that resource

    One way to get the Resource ID is to use the Azure portal. Assuming the resource is already created, select it in the portal. Then in the next blade, select Properties under the Settings section. RESOURCE ID is a field in the next blade. Another way is to use the Azure Resource Explorer.

    An example Resource ID for a web app is

    /subscriptions/dededede-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/myresourcegroupname/providers/Microsoft.Web/sites/mywebsitename

    You can use Get-AzureRmMetricDefinition to view the list of all metric definitions for a specific resource.

    Get-AzureRmMetricDefinition -ResourceId <resource_id>

    The following example generates a table with the metric Name and the Unit for that metric.

    Get-AzureRmMetricDefinition -ResourceId <resource_id> | Format-Table -Property Name,Unit

    A full list of available options for Get-AzureRmMetricDefinition is available by running Get-Help Get-AzureRmMetricDefinition -Detailed.

  1. The following example sets up an alert on a web site resource. The alert triggers whenever it consistently receives any traffic for 5 minutes and again when it receives no traffic for 5 minutes.

    Add-AzureRmMetricAlertRule -Name myMetricRuleWithWebhookAndEmail -Location "East US" -ResourceGroup myresourcegroup -TargetResourceId /subscriptions/dededede-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/myresourcegroupname/providers/Microsoft.Web/sites/mywebsitename -MetricName "BytesReceived" -Operator GreaterThan -Threshold 2 -WindowSize 00:05:00 -TimeAggregationOperator Total -Description "alert on any website activity"

  2. To create webhook or send email when an alert triggers, first create the email and/or webhooks. Then immediately create the rule afterwards with the -Actions tag and as shown in the following example. You cannot associate webhook or emails with already created rules via PowerShell.

    $actionEmail = New-AzureRmAlertRuleEmail -CustomEmail myname@company.com
$actionWebhook = New-AzureRmAlertRuleWebhook -ServiceUri https://www.contoso.com?token=mytoken

Add-AzureRmMetricAlertRule -Name myMetricRuleWithWebhookAndEmail -Location "East US" -ResourceGroup myresourcegroup -TargetResourceId /subscriptions/dededede-7aa0-407d-a6fb-eb20c8bd1192/resourceGroups/myresourcegroupname/providers/Microsoft.Web/sites/mywebsitename -MetricName "BytesReceived" -Operator GreaterThan -Threshold 2 -WindowSize 00:05:00 -TimeAggregationOperator Total -Actions $actionEmail, $actionWebhook -Description "alert on any website activity"

  3. To verify that your alerts have been created properly by looking at the individual rules.

    Get-AzureRmAlertRule -Name myMetricRuleWithWebhookAndEmail -ResourceGroup myresourcegroup -DetailedOutput

Get-AzureRmAlertRule -Name myLogAlertRule -ResourceGroup myresourcegroup -DetailedOutput

  4. Delete your alerts. These commands delete the rules created previously in this article.

    Remove-AzureRmAlertRule -ResourceGroup myresourcegroup -Name myrule
Remove-AzureRmAlertRule -ResourceGroup myresourcegroup -Name myMetricRuleWithWebhookAndEmail
Remove-AzureRmAlertRule -ResourceGroup myresourcegroup -Name myLogAlertRule

Next steps