Partilhar via


Metric Alerts - Update

Atualizar uma definição de alerta de métrica.

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

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

ruleName
path True

string

O nome da regra.

subscriptionId
path True

string

A ID da assinatura de destino.

api-version
query True

string

A versão da API a ser usada para esta operação.

Corpo do Pedido

Name Tipo Description
properties.actions

MetricAlertAction[]

A matriz de ações que são executadas quando a regra de alerta se torna ativa e quando uma condição de alerta é resolvida.

properties.autoMitigate

boolean

O sinalizador que indica se o alerta deve ser resolvido automaticamente ou não. O padrão é true.

properties.criteria MetricAlertCriteria:

define as informações sobre os critérios de alerta específicos.

properties.description

string

A descrição do alerta métrico que será incluído no e-mail de alerta.

properties.enabled

boolean

O sinalizador que indica se o alerta de métrica está habilitado.

properties.evaluationFrequency

string

a frequência com que o alerta métrico é avaliado, representada no formato de duração ISO 8601.

properties.scopes

string[]

A lista de IDs de recursos para os quais esse alerta de métrica tem escopo.

properties.severity

integer

Severidade do alerta {0, 1, 2, 3, 4}

properties.targetResourceRegion

string

A região do(s) recurso(s) de destino na qual o alerta é criado/atualizado. Obrigatório para MultipleResourceMultipleMetricCriteria.

properties.targetResourceType

string

O tipo de recurso do(s) recurso(s) de destino no qual o alerta é criado/atualizado. Obrigatório para MultipleResourceMultipleMetricCriteria.

properties.windowSize

string

o período de tempo (no formato de duração ISO 8601) usado para monitorar a atividade de alerta com base no limite.

tags

object

Tags de recursos

Respostas

Name Tipo Description
200 OK

MetricAlertResource

OK

Other Status Codes

ErrorResponse

BadRequest

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

Create or update an alert rule

Pedido de amostra

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

{
  "tags": {},
  "properties": {
    "description": "This is the description of the rule1",
    "severity": 3,
    "enabled": true,
    "scopes": [
      "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourceGroups/gigtest/providers/Microsoft.Compute/virtualMachines/gigwadme"
    ],
    "evaluationFrequency": "PT1M",
    "windowSize": "PT15M",
    "criteria": {
      "odata.type": "Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria",
      "allOf": [
        {
          "criterionType": "StaticThresholdCriterion",
          "name": "High_CPU_80",
          "metricName": "\\Processor(_Total)\\% Processor Time",
          "dimensions": [],
          "operator": "GreaterThan",
          "threshold": 80.5,
          "timeAggregation": "Average"
        }
      ]
    },
    "autoMitigate": true,
    "actions": [
      {
        "actionGroupId": "/subscriptions/14ddf0c5-77c5-4b53-84f6-e1fa43ad68f7/resourcegroups/gigtest/providers/microsoft.insights/actiongroups/group2",
        "webHookProperties": {
          "key11": "value11",
          "key12": "value12"
        }
      }
    ]
  }
}

Resposta da amostra

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

Definições

Name Description
AdditionalInfo

Uma matriz de objetos com propriedades 'type' e 'info'. O esquema de 'info' é específico do serviço e depende da cadeia de caracteres 'type'.

AggregationTypeEnum

os tipos de agregação temporal dos critérios.

DynamicMetricCriteria

Critério de limiar dinâmico.

DynamicThresholdFailingPeriods

O número mínimo de violações necessárias dentro da janela de tempo de retrospetiva selecionada necessária para gerar um alerta.

DynamicThresholdOperator

O operador usado para comparar o valor da métrica com o limite.

DynamicThresholdSensitivity

A extensão do desvio necessário para disparar um alerta. Isso afetará o quão apertado é o limite para o padrão de série métrica.

Error
ErrorDetail

Descreve os detalhes de uma resposta de erro.

ErrorResponse

Descreve o formato de Resposta de erro.

MetricAlertAction

Uma ação de alerta.

MetricAlertMultipleResourceMultipleMetricCriteria

Especifica os critérios de alerta de métrica para vários recursos que têm vários critérios métricos.

MetricAlertResource

O recurso de alerta métrico.

MetricAlertResourcePatch

O recurso de alerta métrico para operações de patch.

MetricAlertSingleResourceMultipleMetricCriteria

Especifica os critérios de alerta de métrica para um único recurso que tem vários critérios métricos.

MetricCriteria

Critério para filtrar métricas.

MetricDimension

Especifica uma dimensão métrica.

Operator

o operador de critérios.

WebtestLocationAvailabilityCriteria

Especifica os critérios da regra de alerta métrico para um recurso de teste da Web.

AdditionalInfo

Uma matriz de objetos com propriedades 'type' e 'info'. O esquema de 'info' é específico do serviço e depende da cadeia de caracteres 'type'.

Name Tipo Description
info

object

As informações adicionais específicas do tipo.

type

string

O tipo de informação adicional.

AggregationTypeEnum

os tipos de agregação temporal dos critérios.

Name Tipo Description
Average

string

Count

string

Maximum

string

Minimum

string

Total

string

DynamicMetricCriteria

Critério de limiar dinâmico.

Name Tipo Description
alertSensitivity

DynamicThresholdSensitivity

A extensão do desvio necessário para disparar um alerta. Isso afetará o quão apertado é o limite para o padrão de série métrica.

criterionType string:

DynamicThresholdCriterion

Especifica o tipo de critérios de limite

dimensions

MetricDimension[]

Lista de condições de dimensão.

failingPeriods

DynamicThresholdFailingPeriods

O número mínimo de violações necessárias dentro da janela de tempo de retrospetiva selecionada necessária para gerar um alerta.

ignoreDataBefore

string

Use esta opção para definir a data a partir da qual começar a aprender os dados históricos da métrica e calcular os limites dinâmicos (no formato ISO8601)

metricName

string

Nome da métrica.

metricNamespace

string

Namespace da métrica.

name

string

Nome dos critérios.

operator

DynamicThresholdOperator

O operador usado para comparar o valor da métrica com o limite.

skipMetricValidation

boolean

Permite criar uma regra de alerta em uma métrica personalizada que ainda não foi emitida, fazendo com que a validação da métrica seja ignorada.

timeAggregation

AggregationTypeEnum

os tipos de agregação temporal dos critérios.

DynamicThresholdFailingPeriods

O número mínimo de violações necessárias dentro da janela de tempo de retrospetiva selecionada necessária para gerar um alerta.

Name Tipo Description
minFailingPeriodsToAlert

number

O número de violações para disparar um alerta. Deve ser menor ou igual a numberOfEvaluationPeriods.

numberOfEvaluationPeriods

number

O número de pontos de retrospetiva agregados. A janela de tempo de retrospetiva é calculada com base na granularidade de agregação (windowSize) e no número selecionado de pontos agregados.

DynamicThresholdOperator

O operador usado para comparar o valor da métrica com o limite.

Name Tipo Description
GreaterOrLessThan

string

GreaterThan

string

LessThan

string

DynamicThresholdSensitivity

A extensão do desvio necessário para disparar um alerta. Isso afetará o quão apertado é o limite para o padrão de série métrica.

Name Tipo Description
High

string

Low

string

Medium

string

Error

Name Tipo Description
additionalInfo

AdditionalInfo[]

Uma matriz de objetos com propriedades 'type' e 'info'. O esquema de 'info' é específico do serviço e depende da cadeia de caracteres 'type'.

code

string

String não localizada que pode ser usada para identificar programaticamente o erro.

details

ErrorDetail[]

Uma matriz de objetos adicionais aninhados de informações de resposta de erro, conforme descrito por este contrato.

message

string

Descreve o erro em detalhes e fornece informações de depuração. Se Accept-Language estiver definido na solicitação, ela deverá ser localizada para esse idioma.

target

string

O destino do erro específico (por exemplo, o nome da propriedade em erro).

ErrorDetail

Descreve os detalhes de uma resposta de erro.

Name Tipo Description
additionalInfo

AdditionalInfo[]

Uma matriz de objetos com propriedades 'type' e 'info'. O esquema de 'info' é específico do serviço e depende da cadeia de caracteres 'type'.

code

string

String não localizada que pode ser usada para identificar programaticamente o erro.

message

string

Descreve o erro em detalhes e fornece informações de depuração.

target

string

O destino do erro específico (por exemplo, o nome da propriedade em erro).

ErrorResponse

Descreve o formato de Resposta de erro.

Name Tipo Description
error

Error

MetricAlertAction

Uma ação de alerta.

Name Tipo Description
actionGroupId

string

A ID do grupo de ação a ser usado.

webHookProperties

object

Este campo permite especificar propriedades personalizadas, que seriam anexadas à carga útil de alerta enviada como entrada para o webhook.

MetricAlertMultipleResourceMultipleMetricCriteria

Especifica os critérios de alerta de métrica para vários recursos que têm vários critérios métricos.

Name Tipo Description
allOf MultiMetricCriteria[]:

a lista de critérios métricos múltiplos para esta operação «todas».

odata.type string:

Microsoft.Azure.Monitor.MultipleResourceMultipleMetricCriteria

Especifica o tipo dos critérios de alerta.

MetricAlertResource

O recurso de alerta métrico.

Name Tipo Description
id

string

ID do recurso do Azure

location

string

Localização do recurso

name

string

Nome do recurso do Azure

properties.actions

MetricAlertAction[]

A matriz de ações que são executadas quando a regra de alerta se torna ativa e quando uma condição de alerta é resolvida.

properties.autoMitigate

boolean

O sinalizador que indica se o alerta deve ser resolvido automaticamente ou não. O padrão é true.

properties.criteria MetricAlertCriteria:

define as informações sobre os critérios de alerta específicos.

properties.description

string

A descrição do alerta métrico que será incluído no e-mail de alerta.

properties.enabled

boolean

O sinalizador que indica se o alerta de métrica está habilitado.

properties.evaluationFrequency

string

a frequência com que o alerta métrico é avaliado, representada no formato de duração ISO 8601.

properties.isMigrated

boolean

O valor que indica se essa regra de alerta foi migrada.

properties.lastUpdatedTime

string

Da última vez que a regra foi atualizada em ISO8601 formato.

properties.scopes

string[]

A lista de IDs de recursos para os quais esse alerta de métrica tem escopo.

properties.severity

integer

Severidade do alerta {0, 1, 2, 3, 4}

properties.targetResourceRegion

string

A região do(s) recurso(s) de destino na qual o alerta é criado/atualizado. Obrigatório se o escopo contiver uma assinatura, grupo de recursos ou mais de um recurso.

properties.targetResourceType

string

O tipo de recurso do(s) recurso(s) de destino no qual o alerta é criado/atualizado. Obrigatório se o escopo contiver uma assinatura, grupo de recursos ou mais de um recurso.

properties.windowSize

string

o período de tempo (no formato de duração ISO 8601) usado para monitorar a atividade de alerta com base no limite.

tags

object

Tags de recursos

type

string

Tipo de recurso do Azure

MetricAlertResourcePatch

O recurso de alerta métrico para operações de patch.

Name Tipo Description
properties.actions

MetricAlertAction[]

A matriz de ações que são executadas quando a regra de alerta se torna ativa e quando uma condição de alerta é resolvida.

properties.autoMitigate

boolean

O sinalizador que indica se o alerta deve ser resolvido automaticamente ou não. O padrão é true.

properties.criteria MetricAlertCriteria:

define as informações sobre os critérios de alerta específicos.

properties.description

string

A descrição do alerta métrico que será incluído no e-mail de alerta.

properties.enabled

boolean

O sinalizador que indica se o alerta de métrica está habilitado.

properties.evaluationFrequency

string

a frequência com que o alerta métrico é avaliado, representada no formato de duração ISO 8601.

properties.isMigrated

boolean

O valor que indica se essa regra de alerta foi migrada.

properties.lastUpdatedTime

string

Da última vez que a regra foi atualizada em ISO8601 formato.

properties.scopes

string[]

A lista de IDs de recursos para os quais esse alerta de métrica tem escopo.

properties.severity

integer

Severidade do alerta {0, 1, 2, 3, 4}

properties.targetResourceRegion

string

A região do(s) recurso(s) de destino na qual o alerta é criado/atualizado. Obrigatório para MultipleResourceMultipleMetricCriteria.

properties.targetResourceType

string

O tipo de recurso do(s) recurso(s) de destino no qual o alerta é criado/atualizado. Obrigatório para MultipleResourceMultipleMetricCriteria.

properties.windowSize

string

o período de tempo (no formato de duração ISO 8601) usado para monitorar a atividade de alerta com base no limite.

tags

object

Tags de recursos

MetricAlertSingleResourceMultipleMetricCriteria

Especifica os critérios de alerta de métrica para um único recurso que tem vários critérios métricos.

Name Tipo Description
allOf

MetricCriteria[]

A lista de critérios métricos para esta operação "toda".

odata.type string:

Microsoft.Azure.Monitor.SingleResourceMultipleMetricCriteria

Especifica o tipo dos critérios de alerta.

MetricCriteria

Critério para filtrar métricas.

Name Tipo Description
criterionType string:

StaticThresholdCriterion

Especifica o tipo de critérios de limite

dimensions

MetricDimension[]

Lista de condições de dimensão.

metricName

string

Nome da métrica.

metricNamespace

string

Namespace da métrica.

name

string

Nome dos critérios.

operator

Operator

o operador de critérios.

skipMetricValidation

boolean

Permite criar uma regra de alerta em uma métrica personalizada que ainda não foi emitida, fazendo com que a validação da métrica seja ignorada.

threshold

number

O valor limite de critérios que ativa o alerta.

timeAggregation

AggregationTypeEnum

os tipos de agregação temporal dos critérios.

MetricDimension

Especifica uma dimensão métrica.

Name Tipo Description
name

string

Nome da dimensão.

operator

string

o operador de dimensão. Apenas 'Incluir' e 'Excluir' são suportados

values

string[]

Lista de valores de dimensão.

Operator

o operador de critérios.

Name Tipo Description
Equals

string

GreaterThan

string

GreaterThanOrEqual

string

LessThan

string

LessThanOrEqual

string

WebtestLocationAvailabilityCriteria

Especifica os critérios da regra de alerta métrico para um recurso de teste da Web.

Name Tipo Description
componentId

string

A ID do recurso do Application Insights.

failedLocationCount

number

O número de locais com falha.

odata.type string:

Microsoft.Azure.Monitor.WebtestLocationAvailabilityCriteria

Especifica o tipo dos critérios de alerta.

webTestId

string

O ID de teste da Web do Application Insights.