Gestisci criteri di avviso

Questo documento descrive come modificare, elencare e visualizzare i criteri di avviso utilizzando la console Google Cloud. Descrive inoltre come visualizzare la rappresentazione JSON di un criterio e come aggiungere criteri di avviso a una dashboard personalizzata. Quando aggiungi criteri a una dashboard personalizzata, puoi visualizzare i criteri nello stesso contesto dei dati delle metriche.

Questo documento non descrive come modificare, elencare e visualizzare i criteri di avviso utilizzando l'API Cloud Monitoring. Per maggiori informazioni, vedi Gestire i criteri di avviso per API.

Prima di iniziare

1. Per ottenere le autorizzazioni necessarie per creare e modificare i criteri di avviso utilizzando la console Google Cloud, chiedi all'amministratore di concederti il ruolo IAM Editor Monitoring (roles/monitoring.editor) per il tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

   Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

   Per ulteriori informazioni sui ruoli di Cloud Monitoring, consulta Controllare l'accesso con Identity and Access Management.

2. Assicurati di acquisire familiarità con i concetti generali dei criteri di avviso. Per saperne di più, consulta la Panoramica degli avvisi.

Modifica, elenca o elimina i criteri di avviso

1. Nella console Google Cloud, vai alla pagina Avvisi di :

   Vai ad Avvisi

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato il cui sottotitolo è Monitoring.

   La pagina Avvisi mostra riquadri con informazioni di riepilogo, incidenti e criteri di avviso.

2. Fai clic su Visualizza tutte le norme nel riquadro Norme.

   Nella pagina Norme sono elencati tutti i criteri, è inclusa una barra dei filtri e, per ogni criterio, le opzioni per modificare, copiare o eliminare il criterio:

   • Per filtrare l'elenco dei criteri di avviso, esegui una delle seguenti operazioni:

     • Inserisci un nome nella barra dei filtri. Ad esempio, per visualizzare solo i criteri il cui nome contiene Example, inserisci Example. Un confronto sensibile alle maiuscole verifica se un criterio è elencato.
     • Fai clic su Filtra i criteri, seleziona la proprietà del filtro e poi inserisci un valore per il filtro o seleziona un valore dal menu.

     Quando aggiungi più filtri, un AND logico unisce i filtri.

3. (Facoltativo) Per visualizzare i dettagli di una norma, fai clic sul nome della norma. Per informazioni sulla pagina Dettagli criterio, vedi Visualizzare un criterio di avviso.

4. (Facoltativo) Per modificare o copiare un criterio, fai clic su Altre opzioni e seleziona l'opzione corrispondente. La modifica e la copia di un criterio sono simili alla creazione di un criterio di avviso basato su metriche. Tuttavia, non tutti i campi possono essere modificati. Al termine, fai clic su Salva norma.

5. (Facoltativo) Per eliminare un criterio, fai clic su Altre opzioni e seleziona Elimina. Nella finestra di dialogo di conferma, seleziona Elimina.

   Se elimini il criterio di avviso associato a un grafico degli avvisi, il grafico degli avvisi non mostrerà più alcun dato. Per ulteriori informazioni, consulta Il grafico degli avvisi non mostra dati.

Visualizza un criterio di avviso

1. Nella console Google Cloud, vai alla pagina Avvisi di :

   Vai ad Avvisi

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato il cui sottotitolo è Monitoring.

2. Per visualizzare un elenco di tutti i criteri, fai clic su Visualizza tutti i criteri nel riquadro Norme.

3. Trova il criterio che vuoi visualizzare e selezionalo.

Ad esempio, lo screenshot seguente illustra i dettagli del criterio di avviso denominato Test staging:

Come mostrato nell'immagine precedente, la pagina dei dettagli fornisce informazioni sul criterio di avviso:

• Per visualizzare gli incidenti creati dal criterio, consulta la sezione Incidenti.

• Per visualizzare i canali di notifica configurati, consulta la sezione Canali di notifica.

• Per visualizzare le informazioni aggiuntive che hai specificato da includere in una notifica, consulta la sezione Documentazione.

• Per visualizzare le etichette definite dall'utente, consulta la sezione Etichette. Per esempi che illustrano come utilizzare le etichette per aggiungere informazioni agli incidenti, consulta la pagina Annotare gli incidenti con le etichette.

• Per modificare, copiare, eliminare, scaricare la rappresentazione JSON o cambiare lo stato attivato del criterio, utilizza le opzioni nella barra degli strumenti. Ad esempio, per disabilitare un criterio di avviso attivato, fai clic su Abilitato, quindi seleziona Disabilita nella finestra di dialogo di conferma.

Nota: un criterio riattivato potrebbe essere attivato immediatamente; per ulteriori informazioni, consulta Notifiche per i criteri di avviso disattivati per una spiegazione.

Visualizza la rappresentazione JSON di un criterio di avviso

Quando crei o modifichi un criterio di avviso utilizzando l'API Cloud Monitoring, fornisci una rappresentazione JSON del criterio al metodo API. Puoi creare il file JSON autonomamente utilizzando la documentazione dell'API come guida per i contenuti. In alternativa, crea un criterio utilizzando la console Google Cloud per poi scaricarlo sul tuo sistema locale. Il file JSON che hai scaricato può essere modificato e utilizzato come modello per altri criteri. Per esempi di criteri descritti da JSON, consulta Criteri di esempio.

Per scaricare la rappresentazione JSON di un criterio di avviso:

1. Nella console Google Cloud, vai alla pagina Avvisi di :

   Vai ad Avvisi

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato il cui sottotitolo è Monitoring.

2. Individua il criterio che vuoi visualizzare e fai clic sul suo nome per aprire la pagina Dettagli norme.
3. Fai clic su JSON.

Per visualizzare la rappresentazione JSON di un criterio di avviso quando lo modifichi, fai clic su  Visualizza codice.

Aggiungi criterio di avviso alla dashboard

Per visualizzare i criteri di avviso nello stesso contesto dei dati delle metriche, aggiungili a una dashboard personalizzata. La dashboard mostra un grafico per ogni criterio di avviso che hai aggiunto. Questi grafici mostrano la metrica monitorata, la soglia e il numero di incidenti aperti per il criterio. Questi grafici contengono anche link che ti consentono di visualizzare o modificare il criterio.

Puoi aggiungere criteri con una condizione alle dashboard personalizzate. I criteri che contengono più condizioni possono essere visualizzati solo dal contesto degli avvisi.

Per visualizzare un riepilogo di un criterio di avviso in una dashboard personalizzata:

1. Nella console Google Cloud, vai alla pagina  Dashboard:

   Vai a Dashboard

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato il cui sottotitolo è Monitoring.

2. Seleziona una dashboard o fai clic su Crea dashboard.
3. Nella barra degli strumenti, fai clic su  Aggiungi widget.
4. Nella finestra di dialogo Aggiungi widget, seleziona Criterio di avviso.
5. Fai clic su Criterio di avviso, quindi seleziona un criterio di avviso. Dal menu Criterio di avviso è possibile selezionare solo criteri di avviso a condizione singola.
6. Per applicare le modifiche alla dashboard, fai clic su Applica nella barra degli strumenti. Per ignorare le modifiche, fai clic su Annulla.

Il seguente screenshot illustra un grafico degli avvisi:

In questo esempio, il criterio di avviso monitora l'utilizzo della CPU di due diverse macchine virtuali. La linea tratteggiata mostra la soglia della condizione, impostata sul 50%. Il chip verde con l'etichetta No incidents indica che non sono presenti incidenti aperti per il criterio di avviso. Se posizioni il puntatore sul chip che mostra il numero di incidenti aperti, si apre una finestra di dialogo che rimanda al criterio di avviso sottostante.

Per maggiori informazioni, consulta Visualizzare grafici degli avvisi e incidenti su una dashboard.