Metric Alerts - Update
Aggiornare una definizione di avviso delle metriche.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/metricAlerts/{ruleName}?api-version=2018-03-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
resource
|
path | True |
string |
Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole. |
rule
|
path | True |
string |
Nome della regola. |
subscription
|
path | True |
string |
ID della sottoscrizione di destinazione. |
api-version
|
query | True |
string |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
Nome | Tipo | Descrizione |
---|---|---|
properties.actions |
matrice di azioni eseguite quando la regola di avviso diventa attiva e quando viene risolta una condizione di avviso. |
|
properties.autoMitigate |
boolean |
flag che indica se l'avviso deve essere risolto automaticamente o meno. Il valore predefinito è true. |
properties.criteria | MetricAlertCriteria: |
definisce le informazioni specifiche sui criteri di avviso. |
properties.description |
string |
descrizione dell'avviso della metrica che verrà incluso nel messaggio di posta elettronica dell'avviso. |
properties.enabled |
boolean |
flag che indica se l'avviso della metrica è abilitato. |
properties.evaluationFrequency |
string |
la frequenza con cui l'avviso metrica viene valutato nel formato di durata ISO 8601. |
properties.scopes |
string[] |
l'elenco di ID risorsa a cui è limitato l'ambito di questo avviso per la metrica. |
properties.severity |
integer |
Gravità dell'avviso {0, 1, 2, 3, 4} |
properties.targetResourceRegion |
string |
area delle risorse di destinazione in cui viene creato/aggiornato l'avviso. Obbligatorio per MultipleResourceMultipleMetricCriteria. |
properties.targetResourceType |
string |
tipo di risorsa delle risorse di destinazione in cui viene creato/aggiornato l'avviso. Obbligatorio per MultipleResourceMultipleMetricCriteria. |
properties.windowSize |
string |
periodo di tempo (in formato di durata ISO 8601) usato per monitorare l'attività di avviso in base alla soglia. |
tags |
object |
Tag delle risorse |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
BadRequest |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
Create or update an alert rule
Esempio di richiesta
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"
}
}
]
}
}
Risposta di esempio
{
"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"
}
}
]
}
}
Definizioni
Nome | Descrizione |
---|---|
Aggregation |
tipi di aggregazione temporale dei criteri. |
Dynamic |
Criterio per la soglia dinamica. |
Dynamic |
Numero minimo di violazioni necessarie all'interno dell'intervallo di tempo di lookback selezionato necessario per generare un avviso. |
Dynamic |
Operatore usato per confrontare il valore della metrica con la soglia. |
Dynamic |
L'estensione della deviazione necessaria per attivare un avviso. Ciò influirà sul modo in cui la soglia è impostata sul modello della serie di metriche. |
Error |
Descrive il formato della risposta di errore. |
Metric |
Azione di avviso. |
Metric |
Specifica i criteri di avviso delle metriche per più risorse con più criteri di metrica. |
Metric |
Risorsa di avviso della metrica. |
Metric |
Risorsa di avviso per le metriche per le operazioni di patch. |
Metric |
Specifica i criteri di avviso delle metriche per una singola risorsa con più criteri di metrica. |
Metric |
Criterio per filtrare le metriche. |
Metric |
Specifica una dimensione metrica. |
Operator |
l'operatore criteria. |
Webtest |
Specifica i criteri delle regole di avviso delle metriche per una risorsa di test Web. |
AggregationTypeEnum
tipi di aggregazione temporale dei criteri.
Nome | Tipo | Descrizione |
---|---|---|
Average |
string |
|
Count |
string |
|
Maximum |
string |
|
Minimum |
string |
|
Total |
string |
DynamicMetricCriteria
Criterio per la soglia dinamica.
Nome | Tipo | Descrizione |
---|---|---|
alertSensitivity |
L'estensione della deviazione necessaria per attivare un avviso. Ciò influirà sul modo in cui la soglia è impostata sul modello della serie di metriche. |
|
criterionType |
string:
Dynamic |
Specifica il tipo di criteri di soglia |
dimensions |
Elenco delle condizioni della dimensione. |
|
failingPeriods |
Numero minimo di violazioni necessarie all'interno dell'intervallo di tempo di lookback selezionato necessario per generare un avviso. |
|
ignoreDataBefore |
string |
Usare questa opzione per impostare la data da cui iniziare a apprendere i dati cronologici delle metriche e calcolare le soglie dinamiche (in formato ISO8601) |
metricName |
string |
Nome della metrica. |
metricNamespace |
string |
Spazio dei nomi della metrica. |
name |
string |
Nome dei criteri. |
operator |
Operatore usato per confrontare il valore della metrica con la soglia. |
|
skipMetricValidation |
boolean |
Consente la creazione di una regola di avviso in una metrica personalizzata non ancora emessa, provocando la mancata esecuzione della convalida della metrica. |
timeAggregation |
tipi di aggregazione temporale dei criteri. |
DynamicThresholdFailingPeriods
Numero minimo di violazioni necessarie all'interno dell'intervallo di tempo di lookback selezionato necessario per generare un avviso.
Nome | Tipo | Descrizione |
---|---|---|
minFailingPeriodsToAlert |
number |
Numero di violazioni da attivare un avviso. Deve essere minore o uguale a numberOfEvaluationPeriods. |
numberOfEvaluationPeriods |
number |
Numero di punti di lookback aggregati. L'intervallo di tempo di lookback viene calcolato in base alla granularità delle aggregazioni (windowSize) e al numero selezionato di punti aggregati. |
DynamicThresholdOperator
Operatore usato per confrontare il valore della metrica con la soglia.
Nome | Tipo | Descrizione |
---|---|---|
GreaterOrLessThan |
string |
|
GreaterThan |
string |
|
LessThan |
string |
DynamicThresholdSensitivity
L'estensione della deviazione necessaria per attivare un avviso. Ciò influirà sul modo in cui la soglia è impostata sul modello della serie di metriche.
Nome | Tipo | Descrizione |
---|---|---|
High |
string |
|
Low |
string |
|
Medium |
string |
ErrorResponse
Descrive il formato della risposta di errore.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore |
message |
string |
Messaggio di errore che indica il motivo per cui l'operazione non è riuscita. |
MetricAlertAction
Azione di avviso.
Nome | Tipo | Descrizione |
---|---|---|
actionGroupId |
string |
ID del gruppo di azioni da usare. |
webHookProperties |
object |
Questo campo consente di specificare proprietà personalizzate, che verrebbero aggiunte al payload dell'avviso inviato come input al webhook. |
MetricAlertMultipleResourceMultipleMetricCriteria
Specifica i criteri di avviso delle metriche per più risorse con più criteri di metrica.
Nome | Tipo | Descrizione |
---|---|---|
allOf | MultiMetricCriteria[]: |
l'elenco di più criteri di metrica per questa operazione 'tutto'. |
odata.type |
string:
Microsoft. |
specifica il tipo dei criteri di avviso. |
MetricAlertResource
Risorsa di avviso della metrica.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa di Azure |
location |
string |
Posizione risorsa |
name |
string |
Nome risorsa di Azure |
properties.actions |
matrice di azioni eseguite quando la regola di avviso diventa attiva e quando viene risolta una condizione di avviso. |
|
properties.autoMitigate |
boolean |
flag che indica se l'avviso deve essere risolto automaticamente o meno. Il valore predefinito è true. |
properties.criteria | MetricAlertCriteria: |
definisce le informazioni specifiche sui criteri di avviso. |
properties.description |
string |
descrizione dell'avviso della metrica che verrà incluso nel messaggio di posta elettronica dell'avviso. |
properties.enabled |
boolean |
flag che indica se l'avviso della metrica è abilitato. |
properties.evaluationFrequency |
string |
la frequenza con cui l'avviso metrica viene valutato nel formato di durata ISO 8601. |
properties.isMigrated |
boolean |
valore che indica se viene eseguita la migrazione di questa regola di avviso. |
properties.lastUpdatedTime |
string |
Ora dell'ultimo aggiornamento della regola nel formato ISO8601. |
properties.scopes |
string[] |
l'elenco di ID risorsa a cui è limitato l'ambito di questo avviso per la metrica. |
properties.severity |
integer |
Gravità dell'avviso {0, 1, 2, 3, 4} |
properties.targetResourceRegion |
string |
area delle risorse di destinazione in cui viene creato/aggiornato l'avviso. Obbligatorio se l'ambito contiene una sottoscrizione, un gruppo di risorse o più risorse. |
properties.targetResourceType |
string |
tipo di risorsa delle risorse di destinazione in cui viene creato/aggiornato l'avviso. Obbligatorio se l'ambito contiene una sottoscrizione, un gruppo di risorse o più risorse. |
properties.windowSize |
string |
periodo di tempo (in formato di durata ISO 8601) usato per monitorare l'attività di avviso in base alla soglia. |
tags |
object |
Tag delle risorse |
type |
string |
Tipo di risorsa di Azure |
MetricAlertResourcePatch
Risorsa di avviso per le metriche per le operazioni di patch.
Nome | Tipo | Descrizione |
---|---|---|
properties.actions |
matrice di azioni eseguite quando la regola di avviso diventa attiva e quando viene risolta una condizione di avviso. |
|
properties.autoMitigate |
boolean |
flag che indica se l'avviso deve essere risolto automaticamente o meno. Il valore predefinito è true. |
properties.criteria | MetricAlertCriteria: |
definisce le informazioni specifiche sui criteri di avviso. |
properties.description |
string |
descrizione dell'avviso della metrica che verrà incluso nel messaggio di posta elettronica dell'avviso. |
properties.enabled |
boolean |
flag che indica se l'avviso della metrica è abilitato. |
properties.evaluationFrequency |
string |
la frequenza con cui l'avviso metrica viene valutato nel formato di durata ISO 8601. |
properties.isMigrated |
boolean |
valore che indica se viene eseguita la migrazione di questa regola di avviso. |
properties.lastUpdatedTime |
string |
Ora dell'ultimo aggiornamento della regola nel formato ISO8601. |
properties.scopes |
string[] |
l'elenco di ID risorsa a cui è limitato l'ambito di questo avviso per la metrica. |
properties.severity |
integer |
Gravità dell'avviso {0, 1, 2, 3, 4} |
properties.targetResourceRegion |
string |
area delle risorse di destinazione in cui viene creato/aggiornato l'avviso. Obbligatorio per MultipleResourceMultipleMetricCriteria. |
properties.targetResourceType |
string |
tipo di risorsa delle risorse di destinazione in cui viene creato/aggiornato l'avviso. Obbligatorio per MultipleResourceMultipleMetricCriteria. |
properties.windowSize |
string |
periodo di tempo (in formato di durata ISO 8601) usato per monitorare l'attività di avviso in base alla soglia. |
tags |
object |
Tag delle risorse |
MetricAlertSingleResourceMultipleMetricCriteria
Specifica i criteri di avviso delle metriche per una singola risorsa con più criteri di metrica.
Nome | Tipo | Descrizione |
---|---|---|
allOf |
Elenco dei criteri delle metriche per questa operazione 'tutto'. |
|
odata.type |
string:
Microsoft. |
specifica il tipo dei criteri di avviso. |
MetricCriteria
Criterio per filtrare le metriche.
Nome | Tipo | Descrizione |
---|---|---|
criterionType |
string:
Static |
Specifica il tipo di criteri di soglia |
dimensions |
Elenco delle condizioni della dimensione. |
|
metricName |
string |
Nome della metrica. |
metricNamespace |
string |
Spazio dei nomi della metrica. |
name |
string |
Nome dei criteri. |
operator |
l'operatore criteria. |
|
skipMetricValidation |
boolean |
Consente la creazione di una regola di avviso in una metrica personalizzata non ancora emessa, provocando la mancata esecuzione della convalida della metrica. |
threshold |
number |
valore soglia criteri che attiva l'avviso. |
timeAggregation |
tipi di aggregazione temporale dei criteri. |
MetricDimension
Specifica una dimensione metrica.
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Nome della dimensione. |
operator |
string |
l'operatore dimension. Sono supportati solo 'Include' e 'Exclude' |
values |
string[] |
elenco di valori delle dimensioni. |
Operator
l'operatore criteria.
Nome | Tipo | Descrizione |
---|---|---|
Equals |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
WebtestLocationAvailabilityCriteria
Specifica i criteri delle regole di avviso delle metriche per una risorsa di test Web.
Nome | Tipo | Descrizione |
---|---|---|
componentId |
string |
ID risorsa di Application Insights. |
failedLocationCount |
number |
Numero di percorsi non riusciti. |
odata.type |
string:
Microsoft. |
specifica il tipo dei criteri di avviso. |
webTestId |
string |
ID test Web di Application Insights. |