Gestire i criteri di avviso

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questo documento descrive come modificare, elencare e visualizzare le policy di avviso utilizzando la console Google Cloud. Ad esempio, descrive come modificare un criterio in modo che sia associato a un'applicazione App Hub. Questa pagina descrive anche come visualizzare la rappresentazione JSON di un criterio e come aggiungere criteri di avviso a una dashboard personalizzata, che ti consente di visualizzare i criteri 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 ulteriori informazioni, consulta Gestire i criteri di avviso tramite API.

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

Prima di iniziare

Nel progetto Google Cloud in cui sono archiviati i criteri di avviso, completa quanto segue:

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 di monitoraggio (roles/monitoring.editor) nel tuo progetto. Per ulteriori informazioni 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 ulteriori informazioni, consulta la Panoramica degli avvisi.

Modificare, elencare o eliminare i criteri di avviso

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

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

   La pagina Criteri elenca tutti i criteri, include una barra dei filtri e, per ogni criterio, le opzioni per modificarlo, copiarlo o eliminarlo:

   • 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 le norme 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.

4. (Facoltativo) Per visualizzare i dettagli di un criterio, fai clic sul nome del criterio. Per informazioni sulla pagina Dettagli criteri, consulta Visualizzare un criterio di avviso.

5. (Facoltativo) Per modificare o copiare un criterio, fai clic su more_vert Altre opzioni e poi seleziona l'opzione corrispondente. La modifica e la copia di un criterio è simile 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.

6. (Facoltativo) Per eliminare un criterio, fai clic su more_vert 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, quando il criterio di avviso viene eliminato, il grafico smette di mostrare i dati. Per ulteriori informazioni, consulta Il widget dei criteri di avviso non mostra dati.

Visualizzare un criterio di avviso

1. Nella console Google Cloud, vai alla pagina notifications 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 console Google Cloud, seleziona il tuo progetto Google Cloud. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella abilitata per le app.

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

4. Individua il criterio che vuoi visualizzare e selezionalo.

   Viene visualizzata la pagina dei dettagli del criterio di avviso. Qui puoi monitorare o modificare i tuoi criteri e visualizzare i dati correlati, ad esempio incidenti e notifiche. Inoltre, puoi:

   • Modifica l'intervallo di tempo per i dati visualizzati nel grafico. I grafici hanno una risoluzione limitata e potrebbero non mostrare tutte le misurazioni per alcuni intervalli di tempo.

   • Modifica l'avviso per aggiungere etichette definite dall'utente, che verranno incluse negli incidenti e nelle notifiche. Per ulteriori informazioni, consulta la sezione Annotare gli incidenti con le etichette.

   • Modifica lo stato di abilitazione del criterio. Quando un criterio è disattivato, non riceverai notifiche.

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 creare autonomamente il file JSON utilizzando la documentazione dell'API come guida per i contenuti. Un'alternativa è creare un criterio utilizzando la console Google Cloud e poi scaricarlo sul sistema locale. Il file JSON 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, segui questi passaggi:

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

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

Aggiungere criteri di avviso alla dashboard

Per visualizzare i criteri di avviso nello stesso contesto dei dati delle metriche, aggiungili a una dashboard personalizzata. Quando visualizzi la dashboard, viene visualizzato 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 le norme.

Puoi aggiungere criteri con una condizione alle dashboard personalizzate. I criteri che contengono più condizioni possono essere visualizzati 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. Nella barra degli strumenti della console Google Cloud, seleziona il tuo progetto Google Cloud. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella abilitata per le app.
3. Seleziona una dashboard o fai clic su Crea dashboard.
4. Nella barra degli strumenti, fai clic su add Aggiungi widget.
5. Nella finestra di dialogo Aggiungi widget, seleziona notifications Criterio di avviso.
6. Fai clic su arrow_drop_down Criterio di avviso e seleziona un criterio di avviso. Dal menu Criterio di avviso è possibile selezionare solo i criteri 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 mostra un 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 posi il cursore sul chip che mostra il numero di incidenti aperti, si apre una finestra di dialogo che rimanda al criterio di avviso sottostante.

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

Associare un criterio di avviso a un'applicazione App Hub

Aggiungendo etichette definite dall'utente a una policy 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 il criterio di avviso è elencato anche nelle dashboard di monitoraggio delle applicazioni. Per scoprire di più sulle etichette, consulta Annotare gli incidenti con le etichette.

Per associare un criterio di avviso a un carico di lavoro o a un servizio utilizzando la console Google Cloud, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina notifications 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 console Google Cloud, seleziona il tuo progetto Google Cloud. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella abilitata per le app.
3. Individua il criterio di avviso, fai clic su more_vert Visualizza altro, selezionate Modifica e vai alla sezione Notifiche e nome.
4. Nella sezione Etichette applicazione, seleziona l'applicazione e poi il carico di lavoro o il servizio.
5. Fai clic su Salva criterio.

Al termine di questi passaggi, le etichette con le seguenti chiavi vengono associate al tuo criterio di avviso. Queste etichette identificano l'applicazione e il servizio o il carico di lavoro:

• apphub_application_location
• apphub_application_id
• apphub_service_id o apphub_workload_id

Puoi anche aggiungere etichette utente a un 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 ulteriori informazioni, consulta le seguenti risorse:

• Gestisci i criteri di avviso tramite API.
• Gestisci i criteri di avviso con Terraform.