Metric Alerts - List By Resource Group

Получить определения правил оповещений в группе ресурсов.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/metricAlerts?api-version=2024-03-01-preview

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя не зависит от регистра.

subscriptionId
path True

string (uuid)

Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).

api-version
query True

string

minLength: 1

Версия API, используемая для данной операции.

Ответы

Имя Тип Описание
200 OK

MetricAlertResourceCollection

Операция Azure успешно завершена.

Other Status Codes

MetricAlertErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

List metric alert rules

Образец запроса

GET https://management.azure.com/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/Microsoft.Insights/metricAlerts?api-version=2024-03-01-preview

Пример ответа

{
  "value": [
    {
      "type": "Microsoft.Insights/metricAlerts",
      "id": "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/microsoft.insights/metricalerts/highcpu",
      "location": "global",
      "properties": {
        "description": "This is the description of the rule1",
        "actions": [
          {
            "actionGroupId": "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourcegroups/gigtest/providers/microsoft.insights/actiongroups/group2",
            "webHookProperties": {
              "key11": "value11",
              "key12": "value12"
            }
          }
        ],
        "criteria": {
          "allOf": [
            {
              "name": "High_CPU_80",
              "criterionType": "StaticThresholdCriterion",
              "dimensions": [],
              "metricName": "CustomMetric_\\Processor(_Total)\\% Processor Time",
              "operator": "GreaterThan",
              "threshold": 80.5,
              "timeAggregation": "Average"
            }
          ],
          "odata.type": "Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria"
        },
        "enabled": true,
        "evaluationFrequency": "PT1M",
        "scopes": [
          "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/Microsoft.Compute/virtualMachines/gigwadme"
        ],
        "severity": 3,
        "windowSize": "PT15M"
      },
      "tags": {
        "hidden-link:/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/Rac46PostSwapRG/providers/Microsoft.Web/sites/leoalerttest": "Resource"
      }
    },
    {
      "type": "Microsoft.Insights/metricAlerts",
      "id": "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/microsoft.insights/metricalerts/mediumcpu",
      "location": "global",
      "properties": {
        "description": "Med cpu alert",
        "actions": [
          {
            "actionGroupId": "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourcegroups/gigtest/providers/microsoft.insights/actiongroups/group2",
            "webHookProperties": {
              "key11": "value11",
              "key12": "value12"
            }
          }
        ],
        "criteria": {
          "allOf": [
            {
              "name": "Medium_CPU_50",
              "criterionType": "StaticThresholdCriterion",
              "dimensions": [],
              "metricName": "CustomMetric_\\Processor(_Total)\\% Processor Time",
              "operator": "GreaterThan",
              "threshold": 50.5,
              "timeAggregation": "Average"
            }
          ],
          "odata.type": "Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria"
        },
        "enabled": true,
        "evaluationFrequency": "PT1M",
        "scopes": [
          "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/Microsoft.Compute/virtualMachines/gigwadme"
        ],
        "severity": 4,
        "windowSize": "PT15M"
      },
      "tags": {
        "hidden-link:/subscriptions/b67f7fec-69fc-4974-9099-a26bd6ffeda3/resourceGroups/Rac46PostSwapRG/providers/Microsoft.Web/sites/leoalerttest": "Resource"
      }
    }
  ]
}

Определения

Имя Описание
AggregationTypeEnum

Типы агрегации времени по критерию. Ранее недокументированные значения могут быть возвращены

createdByType

Тип удостоверения, создавшего ресурс.

DynamicMetricCriteria

Критерий динамического порога.

DynamicPromQLCriteria

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

DynamicThresholdFailingPeriods

Минимальное количество нарушений, необходимых в выбранном окне времени обратного просмотра, необходимое для создания оповещения.

DynamicThresholdOperator

Оператор, используемый для сравнения значения метрик с пороговым значением. Ранее недокументированные значения могут быть возвращены

DynamicThresholdSensitivity

Степень отклонения, необходимого для активации оповещения. Это повлияет на то, насколько жестко пороговое значение соответствует шаблону ряда метрик. Ранее недокументированные значения могут быть возвращены

IdentityType

Тип управляемого удостоверения службы.

MetricAlertAction

Действие оповещения.

MetricAlertErrorResponse

Описывает формат ответа на ошибку.

MetricAlertMultipleResourceMultipleMetricCriteria

Задаёт критерии оповещения метрик для нескольких ресурсов с несколькими критериями.

MetricAlertResource

Ресурс метрического оповещения.

MetricAlertResourceCollection

Представляет коллекцию ресурсов правила генерации оповещений.

MetricAlertSingleResourceMultipleMetricCriteria

Задаёт критерии оповещения метрик для одного ресурса с несколькими критериями.

MetricCriteria

Criterion для фильтрации метрик.

MetricDimension

Задаёт метрическую размерность.

Microsoft.Common.ErrorDetail

Описывает детали ответа на ошибку.

Microsoft.Common.ErrorDetailAdditionalInfoItem
Microsoft.Common.ErrorResponseError
Microsoft.Common.ErrorResponseErrorAdditionalInfoItem
Microsoft.Common.Identity

Удостоверение ресурса.

Microsoft.Common.UserIdentityProperties

Свойства присвоенной пользователю идентичности.

Odatatype

Указывает тип критерия оповещения. Ранее недокументированные значения могут быть возвращены

Operator

Оператор условий. Ранее недокументированные значения могут быть возвращены

PromQLCriteria

Определяет критерии PromQL для ресурса метрических оповещений.

QueryFailingPeriods

Настройка периодов сбоя в оповещениях на основе запросов.

ResolveConfiguration
StaticPromQLCriteria

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

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

WebtestLocationAvailabilityCriteria

Задаёт критерии правила оповещения метрик для веб-тестового ресурса.

AggregationTypeEnum

Типы агрегации времени по критерию. Ранее недокументированные значения могут быть возвращены

Значение Описание
Average

Среднее значение

Count

Количество

Minimum

Минимум

Maximum

Maximum

Total

Total

createdByType

Тип удостоверения, создавшего ресурс.

Значение Описание
User
Application
ManagedIdentity
Key

DynamicMetricCriteria

Критерий динамического порога.

Имя Тип Описание
alertSensitivity

DynamicThresholdSensitivity

Степень отклонения, необходимого для активации оповещения. Это повлияет на то, насколько жестко пороговое значение соответствует шаблону ряда метрик. Ранее недокументированные значения могут быть возвращены

criterionType string:

DynamicThresholdCriterion

Указывает тип пороговых критериев. Ранее недокументированные значения могут быть возвращены

dimensions

MetricDimension[]

Список условий измерения.

failingPeriods

DynamicThresholdFailingPeriods

Минимальное количество нарушений, необходимых в выбранном окне времени обратного просмотра, необходимое для создания оповещения.

ignoreDataBefore

string (date-time)

Используйте этот параметр, чтобы задать дату, с которой начать обучение исторических данных метрик и вычислить динамические пороговые значения (в формате ISO8601)

metricName

string

Имя метрики.

metricNamespace

string

Пространство имен метрик.

name

string

Имя критерия.

operator

DynamicThresholdOperator

Оператор, используемый для сравнения значения метрик с пороговым значением. Ранее недокументированные значения могут быть возвращены

skipMetricValidation

boolean

Позволяет создавать правило генерации оповещений для пользовательской метрики, которая еще не была вызвана проверкой метрик.

timeAggregation

AggregationTypeEnum

Типы агрегации времени по критерию. Ранее недокументированные значения могут быть возвращены

DynamicPromQLCriteria

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

Имя Тип Описание
alertSensitivity

DynamicThresholdSensitivity

Степень отклонения, необходимого для активации оповещения. Это повлияет на то, насколько жестко пороговое значение соответствует шаблону ряда метрик. Ранее недокументированные значения могут быть возвращены

criterionType string:

DynamicThresholdCriterion

Указывает тип пороговых критериев. Ранее недокументированные значения могут быть возвращены

ignoreDataBefore

string (date-time)

Используйте этот параметр, чтобы задать дату, с которой начать обучение исторических данных метрик и вычислить динамические пороговые значения (в формате ISO8601)

name

string

Имя критерия.

operator

DynamicThresholdOperator

Оператор, используемый для сравнения значения метрик с пороговым значением. Ранее недокументированные значения могут быть возвращены

query

string

Запрос, используемый для оценки правила генерации оповещений

DynamicThresholdFailingPeriods

Минимальное количество нарушений, необходимых в выбранном окне времени обратного просмотра, необходимое для создания оповещения.

Имя Тип Описание
minFailingPeriodsToAlert

number (float)

Количество нарушений для активации оповещения. Должно быть меньше или равно числуOfEvaluationPeriods.

numberOfEvaluationPeriods

number (float)

Количество агрегированных точек обратного просмотра. Окно времени обратного просмотра вычисляется на основе детализации агрегирования (windowSize) и выбранного числа агрегированных точек.

DynamicThresholdOperator

Оператор, используемый для сравнения значения метрик с пороговым значением. Ранее недокументированные значения могут быть возвращены

Значение Описание
GreaterThan

GreaterThan

LessThan

LessThan

GreaterOrLessThan

БольшеИлиМеньшеЧем

DynamicThresholdSensitivity

Степень отклонения, необходимого для активации оповещения. Это повлияет на то, насколько жестко пороговое значение соответствует шаблону ряда метрик. Ранее недокументированные значения могут быть возвращены

Значение Описание
Low

Низкий

Medium

Medium

High

High

IdentityType

Тип управляемого удостоверения службы.

Значение Описание
SystemAssigned

Системное назначение

UserAssigned

UserAssigned

None

None

MetricAlertAction

Действие оповещения.

Имя Тип Описание
actionGroupId

string

Идентификатор используемой группы действий.

webHookProperties

object

Это поле позволяет указывать настраиваемые свойства, которые будут добавлены в полезные данные оповещения, отправленные в качестве входных данных в веб-перехватчик.

MetricAlertErrorResponse

Описывает формат ответа на ошибку.

Имя Тип Описание
error

Microsoft.Common.ErrorResponseError

MetricAlertMultipleResourceMultipleMetricCriteria

Задаёт критерии оповещения метрик для нескольких ресурсов с несколькими критериями.

Имя Тип Описание
allOf MultiMetricCriteria[]:

Список нескольких метрических критериев для этой операции «все».

odata.type string:

Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria

Указывает тип критерия оповещения. Ранее недокументированные значения могут быть возвращены

MetricAlertResource

Ресурс метрического оповещения.

Имя Тип Описание
id

string (arm-id)

Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

Microsoft.Common.Identity

Удостоверение ресурса.

location

string

Географическое расположение, в котором находится ресурс

name

string

Имя ресурса

properties.actionProperties

object

Свойства действия.

properties.actions

MetricAlertAction[]

Массив действий, выполняемых при активации правила генерации оповещений, и при разрешении условия генерации оповещений.

properties.autoMitigate

boolean

Флаг, указывающий, должно ли оповещение быть автоматически устранено или нет. Значение по умолчанию — true.

properties.criteria MetricAlertCriteria:

Определяет конкретные сведения о критериях оповещения.

properties.customProperties

object

Свойства полезных данных оповещения.

properties.description

string

Описание оповещения о метрике, которое будет включено в сообщение электронной почты.

properties.enabled

boolean

Флаг, указывающий, включено ли оповещение о метрике.

properties.evaluationFrequency

string (duration)

Частота оценки оповещения метрики представлена в формате длительности ISO 8601.

properties.isMigrated

boolean

Значение, указывающее, было ли это правило оповещения перенесено.

properties.lastUpdatedTime

string (date-time)

В прошлый раз правило обновлялось в ISO8601 формате.

properties.resolveConfiguration

ResolveConfiguration

Конфигурация для разрешения предупреждения. Применимо для PromQLCriteria.

properties.scopes

string[]

Список идентификаторов ресурсов, к которым относится это оповещение о метрике. Невозможно изменить область правила метрик на основе журналов.

properties.severity

integer (int32)

Уровень серьезности оповещений {0, 1, 2, 3, 4}

properties.targetResourceRegion

string

Регион целевых ресурсов, на которых создается или обновляется оповещение. Обязательно, если область содержит подписку, группу ресурсов или несколько ресурсов.

properties.targetResourceType

string

Тип целевого ресурса (ресурсов), на котором создается или обновляется оповещение. Обязательно, если область содержит подписку, группу ресурсов или несколько ресурсов.

properties.windowSize

string (duration)

Период времени (в формате длительности ISO 8601), который используется для мониторинга активности оповещений на основе порогового значения.

systemData

systemData

Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.

tags

object

Теги ресурсов.

type

string

Тип ресурса. Например, «Microsoft. Compute/virtualMachines» или «Microsoft. Аккаунты хранения/хранения»

MetricAlertResourceCollection

Представляет коллекцию ресурсов правила генерации оповещений.

Имя Тип Описание
nextLink

string

URL-адрес для получения следующего набора результатов.

value

MetricAlertResource[]

Значения для ресурсов правил предупреждения.

MetricAlertSingleResourceMultipleMetricCriteria

Задаёт критерии оповещения метрик для одного ресурса с несколькими критериями.

Имя Тип Описание
allOf

MetricCriteria[]

Список критериев метрик для этой операции "все".

odata.type string:

Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria

Указывает тип критерия оповещения. Ранее недокументированные значения могут быть возвращены

MetricCriteria

Criterion для фильтрации метрик.

Имя Тип Описание
criterionType string:

StaticThresholdCriterion

Указывает тип пороговых критериев. Ранее недокументированные значения могут быть возвращены

dimensions

MetricDimension[]

Список условий измерения.

metricName

string

Имя метрики.

metricNamespace

string

Пространство имен метрик.

name

string

Имя критерия.

operator

Operator

Оператор условий. Ранее недокументированные значения могут быть возвращены

skipMetricValidation

boolean

Позволяет создавать правило генерации оповещений для пользовательской метрики, которая еще не была вызвана проверкой метрик.

threshold

number (double)

Пороговое значение критерия, при котором активируется оповещение.

timeAggregation

AggregationTypeEnum

Типы агрегации времени по критерию. Ранее недокументированные значения могут быть возвращены

MetricDimension

Задаёт метрическую размерность.

Имя Тип Описание
name

string

Имя измерения.

operator

string

Оператор размерности. Поддерживаются только "Включить" и "Исключить"

values

string[]

Список значений измерения.

Microsoft.Common.ErrorDetail

Описывает детали ответа на ошибку.

Имя Тип Описание
additionalInfo

Microsoft.Common.ErrorDetailAdditionalInfoItem[]

Массив объектов с свойствами 'type' и 'info'. Схема «info» зависит от сервиса и зависит от строки «type».

code

string

Нелокализованная строка, которая может использоваться для программного определения ошибки.

message

string

Подробно описывает ошибку и предоставляет информацию для отладки.

target

string

Цель конкретной ошибки (например, имя ошибочного свойства).

Microsoft.Common.ErrorDetailAdditionalInfoItem

Имя Тип Описание
info

Дополнительная информация, специфичная для типа.

type

string

Тип дополнительной информации.

Microsoft.Common.ErrorResponseError

Имя Тип Описание
additionalInfo

Microsoft.Common.ErrorResponseErrorAdditionalInfoItem[]

Массив объектов с свойствами 'type' и 'info'. Схема «info» зависит от сервиса и зависит от строки «type».

code

string

Нелокализованная строка, которая может использоваться для программного определения ошибки.

details

Microsoft.Common.ErrorDetail[]

Массив дополнительных вложенных объектов сведений об ответе на ошибки, как описано в этом контракте.

message

string

Подробно описывает ошибку и предоставляет информацию для отладки. Если Accept-Language установлен в запросе, он должен быть локализован на этом языке.

target

string

Цель конкретной ошибки (например, имя ошибочного свойства).

Microsoft.Common.ErrorResponseErrorAdditionalInfoItem

Имя Тип Описание
info

Дополнительная информация, специфичная для типа.

type

string

Тип дополнительной информации.

Microsoft.Common.Identity

Удостоверение ресурса.

Имя Тип Описание
principalId

string

Идентификатор субъекта удостоверения ресурса.

tenantId

string

Идентификатор клиента ресурса.

type

IdentityType

Тип управляемого удостоверения службы.

userAssignedIdentities

<string,  Microsoft.Common.UserIdentityProperties>

Список удостоверений пользователей, связанных с ресурсом. Ссылки на ключ словаря удостоверений пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Microsoft.Common.UserIdentityProperties

Свойства присвоенной пользователю идентичности.

Имя Тип Описание
clientId

string

Идентификатор клиента идентификатора ресурса.

principalId

string

Идентификатор субъекта удостоверения ресурса.

Odatatype

Указывает тип критерия оповещения. Ранее недокументированные значения могут быть возвращены

Значение Описание
Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria

Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria

Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria

Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria

Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria

Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria

Microsoft.Azure.Monitor.PromQLCriteria

Microsoft.Azure.Monitor.PromQLCriteria

Operator

Оператор условий. Ранее недокументированные значения могут быть возвращены

Значение Описание
Equals

Равно

GreaterThan

GreaterThan

GreaterThanOrEqual

БольшеИлиРавно

LessThan

LessThan

LessThanOrEqual

LessThanOrEqual

PromQLCriteria

Определяет критерии PromQL для ресурса метрических оповещений.

Имя Тип Описание
allOf MultiPromQLCriteria[]:

Список критериев promQL. Тревога будет поднята, когда все условия будут выполнены.

failingPeriods

QueryFailingPeriods

Настройка периодов сбоя в оповещениях на основе запросов.

odata.type string:

Microsoft.Azure.Monitor.PromQLCriteria

Указывает тип критерия оповещения. Ранее недокументированные значения могут быть возвращены

QueryFailingPeriods

Настройка периодов сбоя в оповещениях на основе запросов.

Имя Тип Описание
for

string (duration)

Количество времени (в формате длительности ISO 8601) должно быть активным перед срабатыванием.

ResolveConfiguration

Имя Тип Описание
autoResolved

boolean

Указывает, должно ли оповещение быть устранено автоматически

timeToResolve

string (duration)

Время (в формате ISO 8601), по истечении которого предупреждение должно быть автоматически устранено

StaticPromQLCriteria

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

Имя Тип Описание
criterionType string:

StaticThresholdCriterion

Указывает тип пороговых критериев. Ранее недокументированные значения могут быть возвращены

name

string

Имя критерия.

query

string

Запрос, используемый для оценки правила генерации оповещений

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя Тип Описание
createdAt

string (date-time)

Метка времени создания ресурса (UTC).

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string (date-time)

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

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

WebtestLocationAvailabilityCriteria

Задаёт критерии правила оповещения метрик для веб-тестового ресурса.

Имя Тип Описание
componentId

string

Идентификатор ресурса Application Insights.

failedLocationCount

number (float)

Количество неудачных расположений.

odata.type string:

Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria

Указывает тип критерия оповещения. Ранее недокументированные значения могут быть возвращены

webTestId

string

Идентификатор веб-теста Application Insights.