Avvisi per i criteri di avviso basati su metriche

Gli avvisi di Cloud Monitoring ti consentono di monitorare e analizzare i problemi quando i dati delle serie temporali soddisfano le condizioni di una criterio di avviso basata su metriche. Per ogni avviso, Monitoring invia una notifica e crea una pagina Dettagli avviso per aiutarti a risolvere il problema e gestire il ciclo di vita dell'avviso.

Nella pagina Dettagli avviso, puoi visualizzare la cronologia dell'avviso, i grafici dei dati delle metriche monitorate e i link agli avvisi e alle voci di log correlati. Se una policy contiene più condizioni, specifica se la soddisfazione di una singola condizione apre un avviso. Il monitoraggio non crea un avviso se la policy è sospesa o disattivata oppure se il numero di policy di avviso o avvisi supera i limiti per gli avvisi.

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.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per visualizzare e gestire gli avvisi, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci 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.

Visualizza avvisi

Per visualizzare gli avvisi nel tuo progetto, utilizza la console Google Cloud , gcloud CLI o l'API Monitoring.

Console Google Cloud

Per elencare gli avvisi nel tuo progetto Google Cloud :

  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 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.

    La pagina Avvisi mostra informazioni su policy di avviso, sospensioni e avvisi:

    • Il riquadro Riepilogo elenca il numero di avvisi aperti.
    • La tabella Avvisi mostra gli avvisi aperti più recenti. Per elencare gli avvisi più recenti nella tabella, inclusi quelli chiusi, fai clic su Mostra avvisi chiusi.

  3. Per visualizzare i dettagli di un avviso specifico, selezionalo nell'elenco.

    Viene visualizzata la pagina Dettagli avviso. Per saperne di più sulla pagina Dettagli avviso, consulta la sezione Esaminare un avviso di questo documento.

Trovare avvisi meno recenti

La tabella Avvisi nella pagina Avvisi mostra gli avvisi aperti più recenti. Per visualizzare gli avvisi meno recenti, esegui una delle seguenti operazioni:

  • Per scorrere le voci nella tabella Avvisi, fai clic su  Più recenti o  Meno recenti.

  • Per aprire una pagina che ti consente di elencare e filtrare gli avvisi, fai clic su Visualizza tutti gli avvisi. Si apre la pagina Avvisi. Da questa pagina, segui questi passaggi:

    • Mostra tutti gli avvisi, inclusi quelli chiusi. Per mostrare tutti gli avvisi, fai clic su Mostra avvisi chiusi.
    • Filtra avvisi. Per informazioni sull'aggiunta di filtri, consulta Filtrare gli avvisi.
    • Conferma o chiudi un avviso oppure posticipa la criterio di avviso. Per accedere a queste opzioni, fai clic su  Altre opzioni nella riga dell'avviso e seleziona un'opzione dal menu. Per saperne di più, consulta Gestire gli avvisi.

Filtra avvisi

Per limitare gli avvisi visualizzati nella tabella, aggiungi filtri. Se aggiungi più filtri, la tabella mostra solo gli avvisi che soddisfano tutti i filtri.

Per filtrare la tabella degli avvisi:

  1. Nella pagina Avvisi, fai clic su  Filtra tabella e poi seleziona una proprietà del filtro. Le proprietà di filtro includono:

    • Stato dell'avviso
    • Nome della criterio di avviso
    • Quando l'avviso è stato aperto o chiuso
    • Tipo di metrica
    • Tipo di risorsa

  2. Seleziona un valore dal menu secondario o inseriscine uno nella barra dei filtri.

    Ad esempio, se selezioni Tipo di metrica e inserisci usage_time, potresti visualizzare solo le seguenti opzioni nel menu secondario:

    agent.googleapis.com/cpu/usage_time
compute.googleapis.com/guest/container/cpu/usage_time
container.googleapis.com/container/cpu/usage_time

    La tabella Avvisi elenca quindi il filtro.

gcloud

Puoi utilizzare gcloud per ricevere avvisi ed elencarli.

Ricevere un avviso

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • ALERT_NAME: il nome della risorsa dell'avviso. Ad esempio, projects/my-project/alerts/my-alert-id.

Esegui il comando gcloud alpha monitoring alerts describe:

Linux, macOS o Cloud Shell

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (PowerShell)

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (cmd.exe)

gcloud alpha monitoring alerts describe ALERT_NAME
 Il comando restituisce una risposta con i dettagli dell'avviso, ad esempio lo stato dell'avviso, le etichette allegate e la criterio di avviso di origine. La risposta è simile alla seguente: 
{
  "name": "projects/my-project/alerts/my-alert-id1",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "close_time": "2025-06-13T10:11:36Z",
  "resource": {
    "type": "gce_instance",
    "labels": {
      "zone": "us-west1",
      "instance_id": "123456789",
      "project_id": "my-project"
    }
  },
  "metric": {
    "labels": {
      "instance_name": "my-instance1"
    },
    "type": "compute.googleapis.com/instance/cpu/usage_time"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "my-policy"
  },
  "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
}

Elenca avvisi

Puoi elencare gli avvisi nel tuo progetto e filtrare i risultati utilizzando gcloud CLI.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'identificatore del progetto.

Esegui il comando gcloud alpha monitoring alerts list:

Linux, macOS o Cloud Shell

gcloud alpha monitoring alerts list

Windows (PowerShell)

gcloud alpha monitoring alerts list

Windows (cmd.exe)

gcloud alpha monitoring alerts list
 Il comando restituisce una risposta con i dettagli dell'avviso, ad esempio lo stato dell'avviso, le etichette allegate e la criterio di avviso di origine. La risposta è simile alla seguente: 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id1",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "close_time": "2025-06-13T10:11:36Z",
      "resource": {
        "type": "gce_instance",
        "labels": {
          "zone": "us-west1",
          "instance_id": "123456789",
          "project_id": "my-project"
        }
      },
      "metric": {
        "labels": {
          "instance_name": "my-instance1"
        },
        "type": "compute.googleapis.com/instance/cpu/usage_time"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "my-policy"
      },
      "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
    }
  ]
}
Puoi anche utilizzare i seguenti flag facoltativi per filtrare, ordinare o modificare l'output:

  • --filter: fornisci un'espressione di filtro per filtrare gli avvisi in base all'ora o all'etichetta. Ad esempio, filtra per ora con --filter='close_time>="2025-09-10T00:00:00Z"' o per etichetta con --filter='resource.labels.key="value"'.

  • --sort-by: un elenco separato da virgole dei campi in base a cui ordinare l'output. Ad esempio: --sort-by=open_time.

  • --uri: il comando restituisce un elenco di URI delle risorse anziché l'output predefinito.

  • --limit: imposta questo flag su 2 o su un valore superiore per limitare il numero di avvisi restituiti. Non utilizzare questo flag insieme al flag --filter.

API Monitoring

Puoi utilizzare l'API Monitoring per ricevere avvisi ed elencarli.

Ricevere un avviso

Per ottenere i dettagli di un singolo avviso con l'API Monitoring, utilizza il metodo alerts.get.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'identificatore del progetto.
  • ALERT_ID: l'ID dell'avviso.

Metodo HTTP e URL: 

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID

Per inviare la richiesta, espandi una di queste opzioni:

Il comando restituisce una risposta con i dettagli dell'avviso, ad esempio lo stato dell'avviso, le etichette allegate e la criterio di avviso di origine. La risposta è simile alla seguente: 
{
  "name": "projects/my-project/alerts/my-alert-id1",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "close_time": "2025-06-13T10:11:36Z",
  "resource": {
    "type": "gce_instance",
    "labels": {
      "zone": "us-west1",
      "instance_id": "123456789",
      "project_id": "my-project"
    }
  },
  "metric": {
    "labels": {
      "instance_name": "my-instance1"
    },
    "type": "compute.googleapis.com/instance/cpu/usage_time"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "my-policy"
  },
  "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
}

Elenca avvisi

Per elencare gli avvisi nel tuo progetto e filtrare i risultati con l'API Monitoring, utilizza il metodo alerts.list.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'identificatore del progetto.

Metodo HTTP e URL: 

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts

Per inviare la richiesta, espandi una di queste opzioni:

Il comando restituisce una risposta con i dettagli dell'avviso, ad esempio lo stato dell'avviso, le etichette allegate e la criterio di avviso di origine. La risposta è simile alla seguente: 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id1",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "close_time": "2025-06-13T10:11:36Z",
      "resource": {
        "type": "gce_instance",
        "labels": {
          "zone": "us-west1",
          "instance_id": "123456789",
          "project_id": "my-project"
        }
      },
      "metric": {
        "labels": {
          "instance_name": "my-instance1"
        },
        "type": "compute.googleapis.com/instance/cpu/usage_time"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "my-policy"
      },
      "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
    }
  ]
}
Gli utenti di cURL possono aggiungere il flag --data-urlencode seguito da un'espressione di filtro per filtrare gli avvisi per ora o etichetta. Vedi i seguenti esempi:

Elenca gli avvisi aperti nell'ultima ora:

--data-urlencode "filter=(open_time>=\"`date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

Elenca e filtra gli avvisi aperti dell'ultimo giorno:

--data-urlencode "filter=(open_time>=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND state=open)"

Elenca e filtra gli avvisi aperti tra due periodi:

--data-urlencode "filter=(open_time>=\"`date -u -d "2 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND open_time<=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

Elenca e filtra gli avvisi in base all'etichetta utente. In questo esempio, filtra per un'etichetta utente con il nome app e il valore my-gke-app:

--data-urlencode "filter=(policy.user_labels.app=\"my-gke-app\")"
Gli utenti di PowerShell possono utilizzare il seguente esempio per aggiungere un filtro basato sul tempo all'URL della richiesta: 
$baseUrl = "https://monitoring.googleapis.com/v3/projects/my-project/alerts"
$filterValue = (Get-Date).AddHours(-1).ToString("yyyy-MM-ddTHH:mm:ssZ")
$filter = 'open_time >= "' + $filterValue + '"'
$encodedFilter = [System.Uri]::EscapeDataString($filter)
$url = $baseUrl + "?filter=" + $encodedFilter

Analizzare un avviso

La pagina Dettagli avviso contiene informazioni che possono aiutarti a identificare la causa di un avviso.

Esplora i dati delle metriche

Per analizzare lo stato della metrica prima e dopo l'avviso, utilizza il grafico Metriche avviso. Questo grafico mostra una cronologia e le serie temporali che hanno soddisfatto la condizione della tuacriterio di avvisoo.

Puoi regolare l'intervallo della cronologia per cercare tendenze e pattern nei dati delle metriche rispetto all'avviso:

  • Per alternare la visualizzazione delle sole serie temporali che hanno soddisfatto la condizione e la visualizzazione di tutte le serie temporali valutate dalla condizione, fai clic su Mostra tutte le serie temporali.

  • Per modificare l'intervallo di tempo visualizzato dal grafico, puoi utilizzare il selettore dell'intervallo di tempo nella barra degli strumenti o evidenziare gli intervalli di tempo sul grafico con il puntatore.

Puoi anche analizzare i dati delle metriche in modo più dettagliato visualizzandoli in Esplora metriche. Per farlo, vai al grafico Metriche avviso e fai clic su Esplora dati. Per impostazione predefinita, Metrics Explorer aggrega e filtra i dati delle metriche in modo che il grafico delle metriche sia allineato alla serie temporale mostrata nella cronologia di Metriche avviso.

Esplorare le voci di log

Il riquadro Log nella pagina Dettagli avviso mostra le voci di log che corrispondono al tipo di risorsa e alle etichette della risorsa monitorata per la metrica. Puoi analizzare queste voci di log per trovare ulteriori informazioni che potrebbero aiutarti a risolvere i problemi relativi all'avviso.

  • Per visualizzare le voci di log in Esplora log, fai clic su Visualizza in Esplora log, quindi seleziona un progetto di definizione dell'ambito. Esplora log fornisce strumenti aggiuntivi per analizzare i dati voce di log, come una cronologia della creazione delle voci di log correlate.
  • Per visualizzare e modificare la query utilizzata per filtrare le voci di log in Esplora metriche, fai clic su Esplora dati.

Visualizzare le informazioni sull'applicazione

Per le policy di avviso associate a un'applicazione App Hub, vai alla sezione Associata all'applicazione. Una voce in questa sezione elenca l'ID applicazione e i link a una dashboard che mostra informazioni sull&#x0D> applicazione. La seconda voce elenca un workload o un servizio e rimanda a una dashboard.

Visualizza informazioni supplementari

La sezione Etichette mostra le etichette e i valori per la risorsa monitorata e la metrica della serie temporale che ha causato l'avviso, nonché le etichette utente definite nella criterio di avviso. Queste informazioni potrebbero aiutarti a identificare la risorsa monitorata specifica che ha causato l'avviso. Per saperne di più, consulta Annotare gli avvisi con le etichette.

La sezione Documentazione mostra il modello di documentazione per le notifiche che hai fornito durante la creazione della criterio di avviso. Queste informazioni potrebbero includere una descrizione di ciò che la norma di avviso monitora, nonché suggerimenti per la mitigazione. Per saperne di più, consulta Annotare le notifiche con la documentazione definita dall'utente.

Se non hai configurato la documentazione per la tua criterio di avviso, il riquadro Documentazione mostra il messaggio "Nessuna documentazione configurata".

Per aiutarti a scoprire i problemi sottostanti della tua applicazione, puoi esplorare gli avvisi relativi ad altre condizionicriterio di avvisoo.

La sezione Avvisi correlati mostra un elenco di avvisi che corrispondono a uno dei seguenti elementi:

  • L'avviso è stato creato quando è stata soddisfatta una condizione dello stesso criterio di avviso.
  • L'avviso condivide un'etichetta con l'avviso visualizzato nella pagina Dettagli avviso.

Gestisci avvisi

Gli avvisi si trovano in uno dei seguenti stati:

  •  Aperto: Il set di condizioni del criterio di avviso è soddisfatto o non sono presenti dati che indicano che la condizione non è più soddisfatta. Se una criterio di avviso contiene più condizioni, gli avvisi vengono aperti a seconda di come vengono combinate queste condizioni. Per saperne di più, consulta Policy con più condizioni.

  •  Confermato: L'avviso è aperto ed è stato contrassegnato manualmente come confermato. In genere, questo stato indica che l'avviso è in fase di indagine.

  •  Chiuso: Il sistema ha rilevato che la condizione non è più soddisfatta, hai chiuso l'avviso o sono trascorsi 7 giorni senza che la condizione sia stata soddisfatta.

Quando configuri una criterio di avviso, assicurati che lo stato stazionario fornisca un indicatore quando tutto va bene. Ciò è necessario per garantire che lo stato senza errori possa essere identificato e, se è aperto un avviso, per chiuderlo. Se non è presente alcun segnale che indichi che una condizione di errore è terminata, dopo l'apertura di un avviso, questo rimane aperto per 7 giorni dopo l'attivazione del criterio di avviso.

Ad esempio, se crei una criterio di avviso che ti avvisa quando il conteggio degli errori è superiore a 0, assicurati che produca un conteggio di 0 errori quando non ce ne sono. Se la criterio di avviso restituisce null o vuoto nello stato senza errori, non è presente alcun segnale che indichi quando gli errori sono terminati. Se necessario, PromQL ti consente di specificare un valore predefinito che viene utilizzato quando non è disponibile alcun valore misurato.

Confermare gli avvisi

Ti consigliamo di contrassegnare un avviso come riconosciuto quando inizi a esaminare la causa dell'avviso.

Per contrassegnare un avviso come riconosciuto:

  1. Nella tabella Avvisi della pagina Avvisi, fai clic su Visualizza tutti gli avvisi.

  2. Nella pagina Avvisi, individua l'avviso che vuoi confermare e poi esegui una delle seguenti operazioni:

    • Fai clic su  Altre opzioni e poi seleziona Conferma.
    • Apri la pagina dei dettagli dell'avviso e fai clic su Conferma avviso.

Se la tua criterio di avviso è configurata per inviare notifiche ripetute, la conferma di un avviso non interrompe le notifiche. Per interromperli, procedi in uno dei seguenti modi:

  • Crea una sospensione per il criterio di avviso.
  • Disattiva il criterio di avviso.

Posticipare una criterio di avviso

Per impedire a Monitoring di creare avvisi e inviare notifiche durante un periodo di tempo specifico, posticipa la criterio di avviso correlata. Quando posticipi una criterio di avviso, Monitoring chiude anche tutti gli avvisi correlati.

Per creare una sospensione per un avviso che stai visualizzando:

  1. Nella pagina Dettagli avviso, fai clic su Policy di posticipo.

  2. Seleziona la durata del posticipo. Dopo aver selezionato la durata della posticipazione, questa inizia immediatamente.

Puoi anche posticipare una criterio di avviso dalla pagina Avvisi individuando l'avviso che vuoi posticipare, facendo clic su  Altre opzioni e selezionando Posticipa. Puoi posticipare le policy di avviso durante le interruzioni per evitare ulteriori notifiche durante la procedura di risoluzione dei problemi.

Chiudi avvisi

Puoi lasciare che Monitoring chiuda un avviso per te oppure puoi chiuderlo dopo che le osservazioni smettono di arrivare. Se chiudi un avviso e poi arrivano dati che indicano che la condizione è soddisfatta, viene creato un nuovo avviso. Quando chiudi un avviso, questa azione non chiude gli altri avvisi aperti per la stessa condizione. Se posticipi una criterio di avviso, gli avvisi aperti vengono chiusi all'inizio del posticipo.

Il monitoraggio chiude automaticamente un avviso quando si verifica una delle seguenti condizioni:

  • Condizioni per le metriche e le soglie:

    • Arriva un'osservazione che indica che la soglia non è stata violata.

    • Non arrivano osservazioni, la condizione è configurata per chiudere gli avvisi quando le osservazioni smettono di arrivare e lo stato della risorsa sottostante è sconosciuto o non è disattivato.

    • Non arrivano osservazioni per la durata di chiusura automatica del criterio di avviso e la condizione non è configurata per chiudere automaticamente gli avvisi quando le osservazioni smettono di arrivare. Per configurare la durata della chiusura automatica, puoi utilizzare la console Google Cloud o l'API Monitoring. Per impostazione predefinita, la durata della chiusura automatica è di sette giorni. La durata minima della chiusura automatica è di 30 minuti.

  • Condizioni di assenza di metriche:

    • Si verifica un'osservazione.
    • Non vengono ricevute osservazioni per 24 ore dopo la scadenza della durata di chiusura automatica dellacriterio di avvisoo. Per configurare la durata della chiusura automatica, puoi utilizzare la console Google Cloud o l'API Monitoring. Per impostazione predefinita, la durata della chiusura automatica è di sette giorni.

  • Condizioni di previsione:

    • Viene prodotta una previsione che indica che la serie temporale non supererà la soglia entro la finestra di previsione.

    • Non arrivano osservazioni per 10 minuti, la condizione è configurata per chiudere gli avvisi quando le osservazioni smettono di arrivare e lo stato della risorsa sottostante è sconosciuto o non è disattivato.

    • Non arrivano osservazioni per la durata di chiusura automatica del criterio di avviso e la condizione non è configurata per chiudere automaticamente gli avvisi quando le osservazioni smettono di arrivare.

Ad esempio, una criterio di avviso ha generato un avviso perché la latenza della risposta HTTP è stata superiore a 2 secondi per 10 minuti consecutivi. Se la misurazione successiva della latenza della risposta HTTP è inferiore o uguale a due secondi, l'avviso viene chiuso. Allo stesso modo, se non vengono ricevuti dati per sette giorni, l'avviso viene chiuso.

Per chiudere un avviso:

  1. Nella tabella Avvisi della pagina Avvisi, fai clic su Visualizza tutti gli avvisi.

  2. Nella pagina Avvisi, individua l'avviso che vuoi chiudere, quindi esegui una delle seguenti operazioni:

    • Fai clic su  Visualizza altro e poi seleziona Chiudi avviso.
    • Apri la pagina Dettagli avviso per l'avviso e poi fai clic su Chiudi avviso.

Se visualizzi il messaggio Unable to close alert with active conditions, l'avviso non può essere chiuso perché sono stati ricevuti dati nel periodo di avviso più recente.

Se visualizzi il messaggio Unable to close alert. Please try again in a few minutes., l'avviso non è stato chiuso a causa di un errore interno.

Conservazione e limiti dei dati

Per informazioni sui limiti e sul periodo di conservazione degli avvisi, consulta Limiti per gli avvisi.

Passaggi successivi