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 si desidera attivare l'avviso. È quindi possibile definire gruppi di azioni e regole di elaborazione degli 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.

Autorizzazioni per creare regole di avviso delle 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.

Accesso alla procedura guidata della regola di avviso nel portale di Azure

Esistono diversi modi per creare o modificare una nuova regola di avviso.

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

  1. Nel portale selezionare Monitoraggio>avvisi.

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

    Screenshot che mostra i passaggi per creare una nuova regola di avviso.

Creare o modificare una regola di avviso da una risorsa specifica

  1. Nel portale passare alla risorsa.

  2. Selezionare Avvisi nel riquadro sinistro e quindi selezionare + Crea>regola di avviso.

    Screenshot che mostra i passaggi per creare una nuova regola di avviso da una risorsa selezionata.

Modificare una regola di avviso esistente

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

  2. Selezionare Regole di avviso.

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

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

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

Configurare l'ambito della regola di avviso

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

  2. Selezionare Applica.

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

Configurare le condizioni della regola di avviso

  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 Di visualizzare 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 del 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 soglia configurato.
    Le soglie dinamiche usano algoritmi di Machine Learning per apprendere continuamente i modelli di comportamento delle metriche e calcolare le soglie appropriate per il comportamento imprevisto. 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 usano soglie statiche, selezionare uno di questi operatori:
    -Maggiore
    - Maggiore o uguale a
    -Meno
    - Minore o uguale a
    Se si usano soglie dinamiche, le regole di avviso possono usare soglie personalizzate in base al comportamento delle metriche per limiti superiori e inferiori nella stessa regola di avviso. Selezionare uno di questi operatori:
    - Maggiore della soglia superiore o inferiore alla 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: Sum, Count, Average, Min o Max.
    Valore 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à soglia Se è stata selezionata una soglia dinamica, immettere il livello di riservatezza. Il livello di riservatezza influisce sulla quantità di deviazione dal modello di serie di metriche necessario per attivare un avviso.
    - Alta: le soglie sono strette e vicine al modello di serie delle metriche. Una regola di avviso viene attivata sulla deviazione più piccola, con conseguente aumento degli avvisi.
    - Medio: le soglie sono meno strette e più bilanciate. Sono presenti meno avvisi rispetto a quelli con riservatezza elevata (impostazione predefinita).
    - Bassa: le soglie sono sciolte, consentendo una maggiore deviazione dal modello di serie delle metriche. Le regole di avviso vengono attivate solo in caso di deviazioni di grandi dimensioni, con conseguente minor numero di avvisi.
    Granularità aggregazione Selezionare l'intervallo usato per raggruppare i punti dati usando la funzione del tipo di aggregazione. Scegliere una granularità 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 di esecuzione della regola di avviso. Selezionare una frequenza inferiore alla granularità dell'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 selezionano più valori di dimensione, ogni serie temporale risultante dalla combinazione attiva il proprio avviso e viene addebitato 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 numeri o colonne stringa. 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 rilevata, la colonna ResourceID viene selezionata automaticamente e modifica il contesto dell'avviso attivato nella risorsa del record.
    Operatore Operatore utilizzato per il nome e il valore della dimensione. Selezionare uno dei valori seguenti:
    -Uguale
    - Non è uguale a
    - Inizia con
    Valori di dimensione I valori delle dimensioni sono basati sui dati delle ultime 48 ore. Selezionare Aggiungi valore personalizzato per aggiungere valori di dimensione personalizzati.
    Includere tutti i valori futuri Selezionare questo campo per includere eventuali 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 posticipata 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 dati prima 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. Da questo punto in poi, è possibile selezionare il pulsante Rivedi e crea in qualsiasi momento.

Configurare le azioni della regola di avviso

  1. Nella scheda Azioni 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

  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 il nome della regola di avviso e la descrizione della 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 per la regola di avviso per avviare l'esecuzione non appena viene completata la creazione.
    Risolvere automaticamente gli avvisi (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 azioni dell'app per la logica.

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

    Il formato per estrarre 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

    • Lo schema comune sovrascrive le configurazioni personalizzate. Non è possibile usare sia le proprietà personalizzate che lo schema comune.
    • Le proprietà personalizzate vengono aggiunte al payload dell'avviso, ma non vengono visualizzate nel modello di posta elettronica o nei dettagli dell'avviso nel portale di Azure.
    • Gli avvisi di Integrità dei servizi non supportano proprietà personalizzate.

    Screenshot che mostra la sezione delle proprietà personalizzate della creazione di una nuova regola di avviso.

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

    Esempio 1

    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: "Dettagli aggiuntivi"
    • Valore: "Finestra di valutazioneStartTime: ${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"

    Esempio 2 Questo esempio aggiunge i dati relativi al motivo della risoluzione o dell'attivazione dell'avviso.

    • Nome: "Avviso ${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}. Il valore è ${data.alertContext.condition.allOf[0].metricValue}"
    • Risultato: i risultati di esempio possono essere simili ai seguenti:
      • "Motivo risolto avviso: Percentuale CPU GreaterThan5 risolta. Il valore è 3,585"
      • "Avviso attivato motivo": "Percentuale CPU GreaterThan5 attivata. Il valore è 10,585"

Configurare i tag delle regole di avviso

  1. Nella scheda Tag impostare i tag necessari nella risorsa regola di avviso.

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

Esaminare e creare la regola di avviso

  1. Nella scheda Rivedi e crea la regola viene convalidata e consente di conoscere 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 durante 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 Seleziona tutti i valori correnti e futuri. Selezionare l'asterisco (*).
  • Quando le metriche configurate in condizioni diverse supportano la stessa dimensione, è necessario impostare in modo esplicito un valore di dimensione configurato nello 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 Transactions e SuccessE2ELatency supportano una dimensione ApiName , è necessario aggiornare entrambe le condizioni e specificare la dimensione ApiName con un "GetBlob" valore.

Considerazioni per la creazione di una regola di avviso che contiene più criteri

  • È possibile selezionare un solo valore per dimensione all'interno di ogni criterio.
  • Non è possibile usare un asterisco (*) come valore della dimensione.
  • Quando le metriche configurate in criteri diversi supportano la stessa dimensione, un valore della dimensione configurato deve essere impostato in modo esplicito nello stesso modo per tutte le metriche. Per un esempio di modello di Resource Manager, vedere Creare un avviso di metrica con un modello di Resource Manager.

Passaggi successivi

Visualizzare e gestire le istanze di avviso