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 |
---|---|---|---|---|
resource
|
path | True |
string |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
rule
|
path | True |
string |
O nome da regra. |
subscription
|
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 |
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 |
OK |
|
Other Status Codes |
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 |
---|---|
Additional |
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'. |
Aggregation |
os tipos de agregação temporal dos critérios. |
Dynamic |
Critério de limiar dinâmico. |
Dynamic |
O número mínimo de violações necessárias dentro da janela de tempo de retrospetiva selecionada necessária para gerar um alerta. |
Dynamic |
O operador usado para comparar o valor da métrica com o limite. |
Dynamic |
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 | |
Error |
Descreve os detalhes de uma resposta de erro. |
Error |
Descreve o formato de Resposta de erro. |
Metric |
Uma ação de alerta. |
Metric |
Especifica os critérios de alerta de métrica para vários recursos que têm vários critérios métricos. |
Metric |
O recurso de alerta métrico. |
Metric |
O recurso de alerta métrico para operações de patch. |
Metric |
Especifica os critérios de alerta de métrica para um único recurso que tem vários critérios métricos. |
Metric |
Critério para filtrar métricas. |
Metric |
Especifica uma dimensão métrica. |
Operator |
o operador de critérios. |
Webtest |
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 |
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:
Dynamic |
Especifica o tipo de critérios de limite |
dimensions |
Lista de condições de dimensão. |
|
failingPeriods |
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 |
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 |
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 |
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 |
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 |
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 |
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. |
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 |
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 |
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 |
A lista de critérios métricos para esta operação "toda". |
|
odata.type |
string:
Microsoft. |
Especifica o tipo dos critérios de alerta. |
MetricCriteria
Critério para filtrar métricas.
Name | Tipo | Description |
---|---|---|
criterionType |
string:
Static |
Especifica o tipo de critérios de limite |
dimensions |
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 |
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 |
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. |
Especifica o tipo dos critérios de alerta. |
webTestId |
string |
O ID de teste da Web do Application Insights. |