Creare o modificare una regola di avviso per le metriche

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.

Seguire questa procedura:

1. Nel portale, selezionare Monitoraggio>Avvisi.

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

   

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.

   

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.

   

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

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.

   

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.

   

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:

   • Tipo di segnale: tipo di regola di avviso che si sta creando.
   • Origine segnale: il servizio che invia il segnale.

   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.

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. 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) Se si usano soglie dinamiche, nella sezione Opzioni avanzate è possibile specificare il numero di errori entro un periodo di tempo specifico per attivare 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.

(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.

   

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.

   

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 automaticamente gli avvisi	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.

   

   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.

(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.

   

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.

   

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.

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 (*).

• Non è possibile usare soglie dinamiche nelle regole di avviso che monitorano più condizioni.

• 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".