Поделиться через

Add-AzMetricAlertRule

  • Ссылка
Модуль:
Az.Monitor

Добавляет или обновляет правило генерации оповещений на основе метрик claasic (уже прекращено в общедоступном облаке). Чтобы создать новое правило генерации оповещений метрик, используйте командлет Add-AzMetricAlertRuleV2 .

Синтаксис

Add-AzMetricAlertRule
   -WindowSize <TimeSpan>
   -Operator <ConditionOperator>
   -Threshold <Double>
   -TargetResourceId <String>
   -MetricName <String>
   -TimeAggregationOperator <TimeAggregationOperator>
   -Location <String>
   [-Description <String>]
   [-DisableRule]
   -ResourceGroupName <String>
   -Name <String>
   [-Action <System.Collections.Generic.List`1[Microsoft.Azure.Management.Monitor.Management.Models.RuleAction]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Add-AzMetricAlertRule добавляет или обновляет правило генерации оповещений на основе метрик. Добавленное правило связано с группой ресурсов и имеет имя. Этот командлет реализует шаблон ShouldProcess, т. е. может запрашивать подтверждение от пользователя перед фактическим созданием, изменением или удалением ресурса.

Примеры

Пример 1. Добавление правила генерации оповещений метрик на веб-сайт

Add-AzMetricAlertRule -Name "metricRule5" -Location "East US" -ResourceGroup "Default-Web-EastUS" -Operator GreaterThan -Threshold 2 -WindowSize 00:05:00 -MetricName "Requests" -Description "Pura Vida" -TimeAggregationOperator Total

RequestId                                                                                                    StatusCode
---------                                                                                                    ----------
33574ccf-0b01-43b4-aa97-87e6bbcf1c11                                                                         Created

Эта команда создает правило генерации оповещений метрик для веб-сайта.

Пример 2. Отключение правила

Add-AzMetricAlertRule -Name "metricRule5" -Location "East US" -ResourceGroup Default-Web-EastUS -Operator GreaterThan -Threshold 2 -WindowSize 00:05:00 -MetricName "Requests" -TimeAggregationOperator Total

RequestId                                                                                                    StatusCode
---------                                                                                                    ----------
96c489f1-8529-46e1-a76d-2c1463ca3116                                                                                 OK

Эта команда отключает правило. Если правило не существует, он создает его отключено. Если правило существует, он просто отключает его.

Пример 3. Добавление правила с действиями

Add-AzMetricAlertRule -Name "metricRule5" -Location "East US" -ResourceGroup "Default-Web-EastUS" -Operator GreaterThan -Threshold 1 -TargetResourceId "/subscriptions/b93fb07a-6f93-30be-bf3e-4f0deca15f4f/resourceGroups/Default-Web-EastUS/providers/microsoft.web/sites/mywebsite" -MetricName "Requests" -TimeAggregationOperator Total

RequestId                                                                                                    StatusCode
---------                                                                                                    ----------
9a5bc388-c7ac-4dc6-aa70-f4bc29c2c712                                                                                 OK

Эта команда создает правило генерации оповещений метрик для веб-сайта.

Параметры

-Action

Задает разделенный запятыми список действий.

Тип:List<T>[RuleAction]
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Указывает описание правила.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-DisableRule

Отключает проблемное правило. Если этот параметр не указан, правило включено.

Тип:SwitchParameter
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Указывает расположение, в котором определено правило.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-MetricName

Указывает имя метрики, которое правило отслеживает. Укажите этот параметр только для правил на основе метрик.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Указывает имя правила.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-Operator

Указывает реляционный оператор для условия правила. Допустимые значения для этого параметра:

  • GreaterThan
  • GreaterThanOrEqual
  • LessThan;
  • LessThanOrEqual;
Тип:ConditionOperator
допустимые значения:GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Указывает имя группы ресурсов для правила.

Тип:String
Aliases:ResourceGroup
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-TargetResourceId

Указывает идентификатор ресурса, который правило отслеживает. ПРИМЕЧАНИЕ. Это свойство нельзя обновить для существующего правила генерации оповещений.

Тип:String
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-Threshold

Задает пороговое значение правила.

Тип:Double
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-TimeAggregationOperator

Указывает оператор агрегирования, применяемый к окну времени при оценке правила.

Тип:Nullable<T>[TimeAggregationOperator]
допустимые значения:Average, Minimum, Maximum, Total, Last
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
значение по умолчанию:None
Обязательно:False
Accept pipeline input:False
Accept wildcard characters:False

-WindowSize

Задает размер периода времени для вычисления данных правила.

Тип:TimeSpan
Position:Named
значение по умолчанию:None
Обязательно:True
Accept pipeline input:True
Accept wildcard characters:False

Входные данные

TimeSpan

ConditionOperator

Double

String

Nullable<T>[[Microsoft.Azure.Management.Monitor.Management.Models.TimeAggregationOperator, Microsoft.Azure.PowerShell.Cmdlets.Monitor, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

SwitchParameter

List<T>[[Microsoft.Azure.Management.Monitor.Management.Models.RuleAction, Microsoft.Azure.PowerShell.Cmdlets.Monitor, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

Выходные данные

PSAddAlertRuleOperationResponse