Creare o modificare una regola di avviso per le metriche

Questo articolo illustra come creare una nuova regola di avviso per le metriche o modificare una regola di avviso delle metriche esistente. Per altre informazioni sugli avvisi, vedere la panoramica degli avvisi.

Creare una regola di avviso combinando le risorse da monitorare, i dati di monitoraggio dalla risorsa e le condizioni che devono attivare l'avviso. È possibile, quindi, definire gruppi di azioni e regole di elaborazione avvisi per determinare cosa accade quando viene attivato un avviso.

Gli avvisi attivati da queste regole di avviso contengono un payload che usa lo schema di avviso comune.

Prerequisiti

Per creare una regola di avviso delle metriche, è necessario disporre delle autorizzazioni seguenti:

  • Autorizzazione di lettura nella risorsa di destinazione della regola di avviso.
  • Autorizzazione di scrittura nel gruppo di risorse in cui viene creata la regola di avviso. Se si sta creando la regola di avviso dal portale di Azure, questa viene creata per impostazione predefinita nello stesso gruppo di risorse in cui si trova la risorsa di destinazione.
  • Autorizzazione di lettura per qualsiasi gruppo di azioni associato alla regola di avviso, se applicabile.

Creare o modificare una regola di avviso dalla home page del portale

Seguire questa procedura:

  1. Nel portale, selezionare Monitoraggio>Avvisi.

  2. Aprire il menu + Crea e selezionare Regola di avviso.

    Screenshot che mostra come creare una nuova regola di avviso.

Creare o modificare una regola di avviso da una risorsa specifica

Seguire questa procedura:

  1. Nel portale, passare alla risorsa.

  2. Selezionare avvisi dal riquadro sinistro, quindi selezionare + Crea >Regola di avviso.

  3. L'ambito della regola di avviso è impostato sulla risorsa selezionata. Continuare con l'impostazione delle condizioni per la regola di avviso.

    Screenshot che mostra come creare una nuova regola di avviso da una risorsa selezionata.

Modificare una regola di avviso esistente

Seguire questa procedura:

  1. Nel portale, dalla home page o da una risorsa specifica, selezionare Avvisi dal riquadro sinistro.

  2. Selezionare Regole di avviso.

  3. Selezionare la regola di avviso da modificare, quindi selezionare Modifica.

    Screenshot che mostra i passaggi per modificare una regola di avviso esistente.

  4. Selezionare una delle schede per la regola di avviso per modificare le impostazioni.

Configurare l'ambito della regola di avviso

Seguire questa procedura:

  1. Nel riquadro Seleziona una risorsa impostare l'ambito per la regola di avviso. È possibile filtrare per sottoscrizione, tipo di risorsa o posizione risorsa.

  2. Selezionare Applica.

    Screenshot che mostra il riquadro di selezione delle risorse per la creazione di una nuova regola di avviso.

Configurare le condizioni della regola di avviso

Seguire questa procedura:

  1. Nella scheda Condizione, quando si seleziona il campo Nome segnale, nell'elenco a discesa vengono visualizzati i segnali più usati. Selezionare uno di questi segnali popolari oppure selezionare Visualizza tutti i segnali se si vuole scegliere un segnale diverso per la condizione.

    Screenshot che mostra segnali comuni durante la creazione di una regola di avviso.

  2. (Facoltativo) Se si sceglie Visualizza tutti i segnali nel passaggio precedente, usare il riquadro Selezionare un segnale per cercare il nome del segnale o filtrare l'elenco dei segnali. Filter by:

    Questa tabella descrive i servizi disponibili per le regole di avviso delle metriche:

    Origine segnale Descrizione
    Piattaforma Per i segnali delle metriche, il servizio di monitoraggio è lo spazio dei nomi delle metriche. "Piattaforma" indica che le metriche vengono fornite dal provider di risorse, vale a dire Azure.
    Azure.ApplicationInsights Metriche segnalate dal cliente, inviate da Application Insights SDK.
    Azure.VM.Windows.GuestMetrics Metriche guest della macchina virtuale, raccolte da un'estensione in esecuzione nella macchina virtuale. Può includere contatori delle prestazioni predefinite del sistema operativo e contatori delle prestazioni personalizzati.
    <spazio dei nomi personalizzato> Spazio dei nomi delle metriche personalizzato contenente le metriche personalizzate inviate con l'API Metriche di Monitoraggio di Azure.

    Selezionare il Nome segnale e Applica.

  3. Visualizzare in anteprima i risultati del segnale di metrica selezionato nella sezione Anteprima. Selezionare i valori per i campi seguenti.

    Campo Descrizione
    Intervallo di tempo Intervallo di tempo da includere nei risultati. Può essere dalle ultime sei ore all'ultima settimana.
    Serie temporale Serie temporale da includere nei risultati.
  4. Nella sezione Logica di avviso:

    Campo Descrizione
    Threshold Selezionare se la soglia deve essere valutata in base a un valore statico o a un valore dinamico.
    Una soglia statica valuta la regola usando il valore di soglia configurato.
    Le soglie dinamiche usano algoritmi di apprendimento automatico per apprendere continuamente il modello di comportamento delle metriche e calcolare le soglie appropriate per comportamenti imprevisti. Altre informazioni sull'uso delle soglie dinamiche per gli avvisi delle metriche.
    Operatore Selezionare l'operatore per confrontare il valore della metrica con la soglia.
    Se si utilizzano soglie dinamiche, le regole di avviso possono utilizzare soglie personalizzate basate sul comportamento delle metriche per i limiti superiori e inferiori della stessa regola di avviso. Selezionare uno di questi operatori:
    - Maggiore della soglia superiore o minore della soglia inferiore (impostazione predefinita)
    - Maggiore della soglia superiore
    - Minore della soglia inferiore
    Tipo di aggregazione Selezionare la funzione di aggregazione da applicare ai punti dati: Somma, Conteggio, Media, Min. o Max.
    Valore di soglia Se è stata selezionata una soglia statica, immettere il valore di soglia per la logica della condizione.
    Unità Se il segnale metrica selezionato supporta unità diverse, ad esempio byte, KB, MB e GB e, se è stata selezionata una soglia statica, immettere l'unità per la logica della condizione.
    Sensibilità della soglia Se è stata selezionata una soglia dinamica, immettere il livello di riservatezza. Il livello di sensibilità influisce sulla quantità di deviazione dal modello della serie di metriche per attivare un avviso.
    - Elevato: le soglie sono estremamente vicine al modello della serie di metriche. La regola di avviso viene attivata alla minima deviazione, il che comporta un maggior numero di avvisi.
    - Medio: le soglie sono meno strette e più bilanciate. Sono presenti meno avvisi rispetto a quelli con sensibilità elevata (impostazione predefinita).
    - Basso: le soglie sono allentate, consentendo una maggiore deviazione dal modello della serie di metriche. Le regole di avviso vengono attivate solo in caso di grandi deviazioni e verranno quindi generati meno avvisi.
    Granularità dell'aggregazione Selezionare l'intervallo utilizzato per raggruppare i punti dati usando la funzione del tipo di aggregazione. Scegliere una granularità di aggregazione (periodo) maggiore della frequenza di valutazione per ridurre la probabilità di mancanza del primo periodo di valutazione di una serie temporale aggiunta.
    Frequenza della valutazione Selezionare la frequenza con cui viene eseguita la regola di avviso. Selezionare una frequenza inferiore alla granularità di aggregazione per generare una finestra temporale scorrevole per la valutazione.
  5. (Facoltativo) È possibile configurare la suddivisione in base alle dimensioni.

    Le dimensioni sono coppie nome-valore che contengono più dati sul valore della metrica. Usando le dimensioni, è possibile filtrare le metriche e monitorare serie temporali specifiche, anziché monitorare l'aggregazione di tutti i valori dimensionali.

    Se si seleziona più di un valore dimensione, ogni serie temporale risultante dalla combinazione attiverà un proprio avviso e verrà addebitata separatamente. Ad esempio, la metrica delle transazioni di un account di archiviazione può avere una dimensione del nome API contenente il nome dell'API chiamata da ogni transazione, ad esempio GetBlob, DeleteBlob e PutPage. È possibile scegliere di attivare un avviso quando è presente un numero elevato di transazioni in un'API specifica (i dati aggregati). In alternativa, è possibile usare le dimensioni per avvisare solo quando il numero di transazioni è elevato per API specifiche.

    Campo Descrizione
    Nome della dimensione Le dimensioni possono essere colonne di numeri o stringhe. Le dimensioni vengono usate per monitorare serie temporali specifiche e fornire contesto a un avviso attivato.
    La suddivisione nella colonna ID risorsa di Azure rende la risorsa specificata nella destinazione dell'avviso. Se rilevato, la colonna ResourceID viene selezionata automaticamente e modifica il contesto dell'avviso attivato nella risorsa del record.
    Operatore L’operatore utilizzato per il nome e il valore della dimensione.
    Valori di dimensione I valori delle dimensioni sono basati sui dati delle ultime 48 ore. Selezionare Aggiungi valore personalizzato per aggiungere valori dimensione personalizzati.
    Includere tutti i valori futuri Selezionare questo campo per includere tutti i valori futuri aggiunti alla dimensione selezionata.
  6. (Facoltativo) Nella sezione Quando valutare:

    Campo Descrizione
    Controllare ogni Selezionare la frequenza con cui la regola di avviso controlla se la condizione viene soddisfatta.
    Periodo di ricerca Selezionare la distanza da visualizzare ogni volta che vengono controllati i dati. Ad esempio, ogni 1 minuto, guardare indietro di 5 minuti.
  7. (Facoltativo) Nella sezione Opzioni avanzate è possibile specificare il numero di errori entro un periodo di tempo specifico che attivano un avviso. Ad esempio, è possibile specificare che si vuole attivare un avviso solo se si sono verificati tre errori nell'ultima ora. I criteri aziendali dell'applicazione devono determinare questa impostazione.

    Selezionare i valori per questi campi:

    Campo Descrizione
    Numero di violazioni Numero di violazioni nell'intervallo di tempo configurato che attivano l'avviso.
    Periodo di valutazione Periodo di tempo entro il quale si verifica il numero di violazioni.
    Ignora i dati precedenti a Usare questa impostazione per selezionare la data da cui iniziare a usare i dati cronologici delle metriche per calcolare le soglie dinamiche. Ad esempio, se una risorsa è in esecuzione in modalità di test e viene spostata nell'ambiente di produzione, è possibile ignorare il comportamento della metrica durante il test della risorsa.
  8. Selezionare Fatto. Dopo aver configurato le condizioni della regola di avviso, è possibile configurare i dettagli della regola di avviso per completare la creazione dell'avviso oppure, facoltativamente, è anche possibile aggiungere azioni e tag alla regola di avviso.

Configurare le azioni della regola di avviso

(Facoltativo) Seguire questa procedura per aggiungere azioni alla regola di avviso:

  1. Seleziona la scheda Azioni.

  2. Selezionare o creare i gruppi di azioni necessari.

    Screenshot che mostra la scheda Azioni durante la creazione di una nuova regola di avviso.

Configurare i dettagli della regola di avviso

Seguire questa procedura:

  1. Nella scheda Dettagli, definire i Dettagli del progetto.

    • Selezionare la Sottoscrizione.
    • Selezionare Gruppo di risorse.
  2. Definire i Dettagli della regola di avviso.

    Screenshot che mostra la scheda Dettagli durante la creazione di una nuova regola di avviso.

  3. Selezionare la Gravità.

  4. Immettere i valori per Nome regola di avviso e Descrizione regola di avviso.

  5. (Facoltativo) Se si sta creando una regola di avviso delle metriche che monitora una metrica personalizzata con l'ambito definito come una delle aree seguenti e si vuole assicurarsi che l'elaborazione dei dati per la regola di avviso venga eseguita all'interno di tale area, è possibile selezionare questa opzione per elaborare la regola di avviso in una di queste aree:

    • Europa settentrionale
    • Europa occidentale
    • Svezia centrale
    • Germania centro-occidentale
  6. (Facoltativo) Nella sezione Opzioni avanzate, è possibile impostare diverse opzioni.

    Campo Descrizione
    Abilita alla creazione Selezionare questa opzione in modo che l’esecuzione della regola di avviso si avvii non appena la regola viene creata.
    Risolvere avvisi automaticamente (anteprima) Selezionare questa opzione per rendere l'avviso con stato. Quando un avviso è con stato, l'avviso viene risolto quando la condizione non viene più soddisfatta.
    Se non si seleziona questa casella di controllo, gli avvisi delle metriche sono senza stato. Gli avvisi senza stato vengono attivati ogni volta che viene soddisfatta la condizione, anche se l'avviso è già stato attivato.
    La frequenza delle notifiche per gli avvisi delle metriche senza stato varia in base alla frequenza configurata della regola di avviso:
    Frequenza di avviso inferiore a 5 minuti: mentre la condizione continua a essere soddisfatta, viene inviata una notifica tra uno e sei minuti.
    Frequenza di avviso superiore a 5 minuti: mentre la condizione continua a essere soddisfatta, viene inviata una notifica tra la frequenza configurata e raddoppia il valore della frequenza. Ad esempio, per una regola di avviso con una frequenza di 15 minuti, una notifica viene inviata in un punto compreso tra 15 e 30 minuti.
  7. (Facoltativo) Nella sezione Proprietà personalizzate, se questa regola di avviso contiene gruppi di azioni, è possibile aggiungere proprietà personalizzate da includere nel payload della notifica di avviso. È possibile usare queste proprietà nelle azioni chiamate dal gruppo di azioni, ad esempio da un webhook, una funzione di Azure o un'azione dell'app per la logica.

    Le proprietà personalizzate vengono specificate come coppie chiave/valore usando testo statico, un valore dinamico estratto dal payload dell'avviso o una combinazione di entrambi.

    Il formato per l’estrazione di un valore dinamico dal payload dell'avviso è: ${<path to schema field>}. Ad esempio: ${data.essentials.monitorCondition}.

    Usare il formato dello schema di avviso comune per specificare il campo nel payload, indipendentemente dal fatto che i gruppi di azioni configurati per la regola di avviso usino lo schema comune.

    Nota

    • Le proprietà personalizzate vengono aggiunte al payload dell'avviso ma non vengono visualizzate nel modello e-mail o nei dettagli dell'avviso nel portale di Azure.

    Screenshot che mostra le proprietà personalizzate per la creazione di una nuova regola di avviso.

    Negli esempi seguenti, i valori nelle proprietà personalizzate vengono usati per utilizzare i dati da un payload che usa lo schema di avviso comune.

    In questo esempio viene creato un tag Dettagli aggiuntivi con i dati relativi all'ora di inizio della finestra e all'ora di fine della finestra:

    • Nome: Additional Details
    • Valore: Evaluation windowStartTime: ${data.alertContext.condition.windowStartTime}. windowEndTime: ${data.alertContext.condition.windowEndTime}
    • Risultato: AdditionalDetails:Evaluation windowStartTime: 2023-04-04T14:39:24.492Z. windowEndTime: 2023-04-04T14:44:24.492Z

    In questo esempio vengono aggiunti dati relativi al motivo della risoluzione o dell'attivazione dell'avviso:

    • Nome: Alert ${data.essentials.monitorCondition} reason
    • Valore: ${data.alertContext.condition.allOf[0].metricName} ${data.alertContext.condition.allOf[0].operator} ${data.alertContext.condition.allOf[0].threshold} ${data.essentials.monitorCondition}. The value is ${data.alertContext.condition.allOf[0].metricValue}
    • Risultati potenziali:
      • Alert Resolved reason: Percentage CPU GreaterThan5 Resolved. The value is 3.585
      • Alert Fired reason": "Percentage CPU GreaterThan5 Fired. The value is 10.585
  8. Dopo aver configurato l'ambito, le condizioni e i dettagli, è possibile selezionare il pulsante Rivedi e crea in qualsiasi momento.

Configurare tag di regole di avviso

(Facoltativo) Seguire questa procedura per aggiungere tag alla regola di avviso:

  1. Selezionare la scheda Tag.

  2. Impostare i tag obbligatori nella risorsa regola di avviso.

    Screenshot che mostra la scheda Tag durante la creazione di una nuova regola di avviso.

Rivedere e creare la regola di avviso

Seguire questa procedura:

  1. Nella scheda Rivedi + Crea, la regola viene convalidata e consente di appurare eventuali problemi.

  2. Quando la convalida viene superata e le impostazioni sono state esaminate, selezionare il pulsante Crea.

    Screenshot che mostra la scheda Rivedi e crea la creazione di una nuova regola di avviso.

Restrizioni di denominazione per le regole di avviso delle metriche

Considerare le restrizioni seguenti per i nomi delle regole di avviso delle metriche:

  • I nomi delle regole di avviso delle metriche non possono essere modificati (rinominati) dopo la creazione.
  • I nomi delle regole di avviso delle metriche devono essere univoci all'interno di un gruppo di risorse.
  • I nomi delle regole di avviso delle metriche non possono contenere i caratteri seguenti: * # & + : <> ? @ % { } \ /
  • I nomi delle regole di avviso delle metriche non possono terminare con uno spazio o un punto.
  • Il nome combinato del gruppo di risorse e il nome della regola di avviso non possono superare i 252 caratteri.

Nota

Se il nome della regola di avviso contiene caratteri non alfabetici o numerici, ad esempio spazi, segni di punteggiatura o simboli, questi caratteri potrebbero essere codificati con URL quando vengono recuperati da determinati client.

Restrizioni quando si usano dimensioni in una regola di avviso delle metriche con più condizioni

Gli avvisi delle metriche supportano gli avvisi sulle metriche multidimensionali e supportano la definizione di più condizioni, fino a cinque condizioni per ogni regola di avviso.

Quando si usano dimensioni in una regola di avviso che contiene più condizioni, considerare i vincoli seguenti:

  • È possibile selezionare un solo valore per dimensione all'interno di ogni condizione.

  • Non è possibile usare l'opzione per Selezionare tutti i valori correnti e futuri. Selezionare l'asterisco (*).

  • Quando le metriche configurate in condizioni diversi supportano la stessa dimensione, è necessario impostare esplicitamente un valore di dimensione, allo stesso modo per tutte le metriche nelle condizioni pertinenti.

    Ad esempio:

    • Si consideri una regola di avviso delle metriche definita in un account di archiviazione e monitora due condizioni:
      • Totale Transazioni> 5
      • Media SuccessE2ELatency> 250 ms
    • Si vuole aggiornare la prima condizione e monitorare solo le transazioni in cui la dimensione ApiName è uguale a "GetBlob".
    • Poiché le metriche Transazioni e SuccessE2ELatency supportano una dimensione ApiName, è necessario aggiornare entrambe le condizioni e specificare la dimensione ApiName con un valore "GetBlob".

Considerations when creating an alert rule that contains multiple criteria

  • You can only select one value per dimension within each criterion.
  • You can't use an asterisk (*) as a dimension value.
  • When metrics that are configured in different criteria support the same dimension, a configured dimension value must be explicitly set in the same way for all those metrics. For a Resource Manager template example, see Create a metric alert with a Resource Manager template.