Gestisci criteri di avviso

Questo documento descrive come modificare, elencare e visualizzare le policy di avviso utilizzando la Google Cloud console. Ad esempio, descrive come modificare una policy in modo che sia associata a un'applicazione App Hub. Questa pagina descrive anche come visualizzare la rappresentazione JSON di una policy e come aggiungere policy di avviso a una dashboard personalizzata, che consente di visualizzare le policy nello stesso contesto dei dati delle metriche.

Questo documento non descrive come modificare, elencare e visualizzare le policy di avviso utilizzando l'API Cloud Monitoring. Per saperne di più, consulta Gestire le policy di avviso tramite l'API.

Questa funzionalità è supportata solo per i Google Cloud progetti. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.

Prima di iniziare

Completa i seguenti passaggi nel Google Cloud progetto che archivia le policy di avviso:

1. Per ottenere le autorizzazioni necessarie per creare e modificare le policy di avviso utilizzando la Google Cloud console, chiedi all'amministratore di concederti il ruolo IAM Editor di Monitoring (roles/monitoring.editor) sul tuo 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 saperne di più sui ruoli di Cloud Monitoring, consulta Controllare l'accesso con Identity and Access Management.

2. Assicurati di conoscere i concetti generali delle policy di avviso. Per saperne di più, consulta la Panoramica degli avvisi.

Modificare, elencare o eliminare le policy di avviso

1. Nella Google Cloud console, 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 riportano informazioni di riepilogo, incidenti e policy di avviso.

2. Nella barra degli strumenti della Google Cloud console, seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.

3. Fai clic su Visualizza tutte le policy nel riquadro Policy.

   La pagina Policy elenca tutte le policy, include una barra dei filtri e, per ogni policy, le opzioni per modificarla, copiarla o eliminarla:

   • Per filtrare l'elenco delle policy di avviso, procedi in uno dei seguenti modi:

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

     Quando aggiungi più filtri, questi vengono uniti da un operatore logico AND.

4. (Facoltativo) Per visualizzare i dettagli di una policy, fai clic sul nome della policy. Per informazioni sulla pagina Dettagli policy, consulta Visualizzare una policy di avviso.

5. (Facoltativo) Per modificare o copiare una policy, fai clic su Altre opzioni, e seleziona l'opzione corrispondente. La modifica e la copia di una policy sono simili a creazione di una policy di avviso basata su metriche. Tuttavia, non tutti i campi possono essere modificati. Al termine, fai clic su Salva policy.

6. (Facoltativo) Per eliminare una policy, 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 di una criterio di avviso, il grafico smette di visualizzare i dati quando la criterio di avviso viene eliminata. Per saperne di più, consulta Il widget della policy di avviso non mostra alcun dato.

Visualizzare una criterio di avviso

1. Nella Google Cloud console, 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. Nella barra degli strumenti della Google Cloud console, seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.

3. Per elencare tutte le policy, fai clic su Visualizza tutte le policy nel riquadro Policy.

4. Trova la policy che vuoi visualizzare e selezionala.

   Si apre la pagina dei dettagli della criterio di avviso. Qui puoi monitorare o modificare la policy e visualizzare i dati correlati, come incidenti e notifiche. Inoltre, puoi:

   • Modificare l'intervallo di tempo per i dati mostrati nel grafico. I grafici hanno una risoluzione limitata e potrebbero non mostrare ogni misurazione per alcuni intervalli di tempo.

   • Modificare l'avviso per aggiungere etichette definite dall'utente, che verranno incluse negli incidenti e nelle notifiche. Per saperne di più, consulta Annotare gli incidenti con le etichette.

   • Modificare lo stato di attivazione della policy. Quando una policy è disattivata, non riceverai notifiche.

   Nota: una policy riattivata potrebbe essere attivata immediatamente. Per saperne di più, consulta Notifiche per le policy di avviso disattivate.

Visualizzare la rappresentazione JSON di una criterio di avviso

Quando crei o modifichi una criterio di avviso utilizzando l'API Cloud Monitoring, fornisci una rappresentazione JSON della policy al metodo API. Puoi creare il codice JSON autonomamente utilizzando la documentazione dell'API come guida per i contenuti. In alternativa, puoi creare una policy utilizzando la Google Cloud console e poi scaricarla sul tuo sistema locale. Il file JSON scaricato può essere modificato e utilizzato come modello per altre policy. Per esempi di policy descritte da JSON, consulta Policy di esempio.

Per scaricare la rappresentazione JSON di una criterio di avviso:

1. Nella Google Cloud console, 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. Nella barra degli strumenti della Google Cloud console, seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.
3. Trova la policy che vuoi visualizzare e fai clic sul nome della policy per aprire la pagina Dettagli policy.
4. Fai clic su JSON.

Per visualizzare la rappresentazione JSON di una criterio di avviso durante la modifica, fai clic su  Visualizza codice.

Aggiungere una criterio di avviso alla dashboard

Per visualizzare le policy di avviso nello stesso contesto dei dati delle metriche, aggiungile a una dashboard personalizzata. Quando visualizzi la dashboard, viene mostrato un grafico per ogni criterio di avviso aggiunta. Questi grafici mostrano la metrica monitorata, la soglia e il numero di incidenti aperti per la policy. Questi grafici contengono anche link che consentono di visualizzare o modificare la policy.

Puoi aggiungere policy con una condizione alle dashboard personalizzate. Le policy che contengono più condizioni possono essere visualizzate solo dal contesto degli avvisi.

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

1. Nella Google Cloud console, 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. Nella barra degli strumenti della Google Cloud console, seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.
3. Seleziona una dashboard o fai clic su Crea dashboard.
4. Nella barra degli strumenti, fai clic su  Aggiungi widget.
5. Nella finestra di dialogo Aggiungi widget, seleziona Policy di avviso.
6. Fai clic su Policy di avviso e seleziona una criterio di avviso. Dal menu Policy di avviso è possibile selezionare solo le policy di avviso con una singola condizione.
7. 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 illustra un grafico per una criterio di avviso:

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

Per saperne di più, consulta Visualizzare le policy di avviso e gli incidenti in una dashboard.

Associare una criterio di avviso a un'applicazione App Hub

Aggiungendo etichette definite dall'utente a una criterio di avviso, puoi associarla a un servizio o a un workload che fa parte di un' applicazione App Hub. Queste etichette sono incluse negli incidenti e nelle notifiche e la criterio di avviso è elencata anche nelle dashboard di monitoraggio delle applicazioni. Per saperne di più sulle etichette, consulta Annotare gli incidenti con le etichette.

Per associare una criterio di avviso a un workload o a un servizio utilizzando la Google Cloud console:

1. Nella Google Cloud console, 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. Nella barra degli strumenti della Google Cloud console, seleziona il tuo Google Cloud progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione.
3. Trova la criterio di avviso, fai clic su Visualizza altro, seleziona Modifica e vai alla sezione Notifiche e nome.

4. Nella sezione Etichette applicazione, seleziona l'applicazione e poi il servizio o il workload:

   

5. Fai clic su Salva policy.

Dopo aver completato questi passaggi, alla criterio di avviso vengono associate etichette con le seguenti chiavi. Queste etichette identificano l'applicazione e il servizio o il workload:

• apphub_application_location
• apphub_application_id
• apphub_service_id o apphub_workload_id

Puoi anche aggiungere etichette utente a una criterio di avviso utilizzando Google Cloud CLI, Terraform o l'API Cloud Monitoring. Tuttavia, devi utilizzare le chiavi delle etichette mostrate nell'esempio precedente. Per saperne di più, consulta le seguenti risorse:

• Gestire le policy di avviso tramite l'API.
• Gestire le policy di avviso con Terraform.