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 come aggiungere criteri di avviso a una dashboard personalizzata. Quando aggiungi criteri a una dashboard personalizzata, puoi visualizzarli 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 ulteriori informazioni, consulta Gestire i criteri di avviso tramite 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 Ruolo IAM Editor Monitoring (roles/monitoring.editor) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

    Potresti anche riuscire a 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 conoscere i concetti generali dei criteri di avviso. Per saperne di più, consulta Panoramica degli avvisi.

Modificare, elencare o eliminare i criteri di avviso

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

    Vai ad Avvisi

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

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

  2. Fai clic su Visualizza tutti i criteri nel riquadro Criteri.

    La pagina Norme elenca tutte le norme e include una barra dei filtri. 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 Norme filtro, seleziona la proprietà filtro, quindi inserisci un valore per il filtro o selezionane uno dal menu.

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

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

  4. (Facoltativo) Per modificare o copiare una norma: 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 una dashboard contiene un grafico che mostra i dati per un criterio di avviso, il grafico smette di mostrare i dati quando il criterio di avviso viene eliminato. Per ulteriori informazioni, vedi Il widget del criterio di avviso non mostra dati.

Visualizzare un criterio di avviso

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

    Vai ad Avvisi

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

  2. Per elencare tutti i criteri, fai clic su Visualizza tutti i criteri nel riquadro Criteri.

  3. Trova il criterio che vuoi visualizzare e selezionalo.

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

Pagina di esempio dei dettagli dei criteri di avviso.

Come mostrato nell'immagine precedente, la pagina dei dettagli fornisce informazioni sulle norme relative agli avvisi:

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

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

  • Per visualizzare le informazioni aggiuntive che hai specificato di includere in un di 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 Annotare gli incidenti con le etichette.

  • Per modificare, copiare, eliminare, scaricare la rappresentazione JSON o cambiare attivo del criterio, utilizza le opzioni nella barra degli strumenti. Ad esempio, per disattivare un criterio di avviso abilitato, fai clic su Abilitato e poi seleziona Disattiva nella finestra di dialogo di conferma.

Visualizzare 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 dell'API. Puoi crea personalmente il file JSON utilizzando la documentazione dell'API come guida dei contenuti. Un'alternativa è creare un criterio utilizzando nella console Google Cloud e scaricare il criterio nel tuo sistema locale. Il file JSON scaricato può essere modificato e utilizzato come modello per altre criteri. Per esempi di criteri descritti da JSON, vedi Esempi di criteri.

Per scaricare la rappresentazione JSON di un criterio di avviso, segui questi passaggi:

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

    Vai ad Avvisi

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

  2. Trova la norma che vuoi visualizzare e fai clic sul nome per aprire la pagina Dettagli norma.
  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. Quando la visualizzi, 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. Criteri che contengono più condizioni possono essere visualizzate solo dal contesto di avviso.

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 con il sottotitolo Monitoring.

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

Lo screenshot seguente mostra un grafico per un criterio di avviso:

Esempio di grafico per un criterio di avviso.

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 su 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 si collega al criterio di avviso sottostante.

Per ulteriori informazioni, consulta Visualizzare criteri di avviso e incidenti in una dashboard.