Esplorare i risultati del monitoraggio sintetico

Questo documento descrive come esplorare la cronologia di esecuzione dei monitoraggi sintetici e come visualizzare le metriche e i log raccolti.

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 in cui è memorizzato il monitoraggio sintetico:

Visualizzare la cronologia di esecuzione di un monitoraggio sintetico

Per comprendere la cronologia delle esecuzioni riuscite e non riuscite, visualizza la pagina Dettagli monitoraggio sintetico del monitoraggio sintetico:

  1. Nella Google Cloud console, vai alla  pagina Monitoraggio sintetico:

    Vai a Monitoraggio sintetico

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

  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 aprire la pagina Dettagli monitoraggio sintetico , individua il monitoraggio sintetico che vuoi visualizzare e fai clic sul suo nome.

La pagina Dettagli monitoraggio sintetico elenca le informazioni di riepilogo, come la percentuale di successo, la durata e lo stato più recente. Questa pagina mostra anche la durata registrata dell'esecuzione e contiene una tabella che mostra una riga per ogni esecuzione.

Ogni riga della tabella elenca lo stato, la data, la durata e rimanda a una pagina che mostra il codice e i log attuali pertinenti all'esecuzione.

Visualizzare i log e le tracce di un'esecuzione

Per visualizzare i log, le tracce e le informazioni di riepilogo di un'esecuzione, fai clic sul link all'esecuzione nella pagina Dettagli monitoraggio sintetico. Da questa pagina puoi:

  • Visualizzare i dati di log.
  • Visualizzare i dati di traccia.

  • Visualizzare il codice attuale.

  • Accedere alla funzione Cloud Run.

  • Per il test Mocha, visualizzare i risultati di ogni test. Ad esempio, se il monitoraggio sintetico contiene quattro test Mocha, il riquadro Risultati test contiene quattro voci. Ogni voce dell'elenco è annotata come riuscita o non riuscita.

    Se selezioni una voce contrassegnata come non riuscita, il codice non riuscito viene visualizzato ed evidenziato.

Visualizzare dati di log

I log vengono raccolti automaticamente da Cloud Monitoring. Questi log contengono informazioni sul test e dettagli sugli errori. I log disponibili dipendono dalla funzione Cloud Run. Ad esempio, se utilizzi Mocha, i log includono informazioni sul fatto che il test sia riuscito o meno, sulla durata del test e, in caso di errore, un'analisi dello stack completa. L'analisi dello stack include la riga di codice non riuscita, i tipi di errore e i messaggi di errore.

Per visualizzare i dettagli dei log correlati, espandi una voce di log nel riquadro Log di esecuzione.

La voce di log viene visualizzata in formato JSON. Se preferisci visualizzare i log con Esplora log, fai clic su Apri in Esplora log. Esplora log viene aperto e una query è preconfigurata.

Visualizzare i dati di traccia

I dati di Trace vengono raccolti quando viene eseguita la funzione Cloud Run. Per visualizzare i dati di traccia, utilizza la Google Cloud console o l'Cloud Trace API per visualizzare i dati di traccia.

Console

Per visualizzare i dati di traccia, effettua una delle seguenti operazioni:

  • Per visualizzare le informazioni di riepilogo di una traccia, fai clic su Visualizza dettagli traccia nella barra degli strumenti della pagina dei dettagli di un'esecuzione.

    Si apre il riquadro Dettagli che mostra un grafico di Gantt con informazioni su ogni intervallo, ovvero un record di un'operazione, nella traccia. Per informazioni complete sulla traccia e sui relativi intervalli, fai clic su Visualizza in Cloud Trace, che apre la pagina Esplora tracce.

  • Visualizza le tracce in Cloud Trace:

    1. Nella Google Cloud console, vai alla Esplora tracce pagina:

      Vai a Esplora tracce

      Puoi trovare questa pagina anche utilizzando la barra di ricerca.

    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. Nel grafico della mappa termica o nella tabella, seleziona una traccia.

La traccia e gli intervalli possono includere cerchi nella sequenza temporale che rappresentano voci di log o eventi che si sono verificati durante l'esecuzione. Fai clic sul cerchio per visualizzare le informazioni sulla voce di log o sull'evento. Per identificare una funzione Cloud Run in una voce di log, visualizza il campo resource.labels.service_name.

Per saperne di più sull'esplorazione dei dati di traccia, consulta Trovare ed esplorare le tracce.

REST

Ti consigliamo di utilizzare la Google Cloud console per visualizzare i dati di traccia. Tuttavia, se vuoi utilizzare l'Cloud Trace API, utilizza il traces.list metodo per elencare le tracce disponibili, quindi utilizza il traces.get metodo per ottenere i dettagli di una traccia.

Visualizzare i log e le metriche di una funzione Cloud Run

I log e le metriche forniscono informazioni sulle azioni eseguite dalla funzione Cloud Run. Ad esempio, i log che contengono un campo denominato userAgent con un valore di GoogleStackdriverMonitoring-UptimeChecks indicano che il servizio ha ricevuto una richiesta dal servizio di controllo di uptime.

Il resto di questa sezione descrive come visualizzare i log e le metriche raccolti da Cloud Run Functions.

Visualizzare i log delle funzioni

Console

Per visualizzare i log di Cloud Run Functions:

  1. Nel riquadro con il nome del monitoraggio sintetico, fai clic sul nome della funzione Cloud Run.
  2. Nella pagina Dettagli funzione, seleziona la scheda Log.

Per esplorare i dati di log in un grafico in modo più dettagliato, espandi una voce di log e seleziona Apri in Esplora log. Da Esplora log, puoi eseguire azioni come perfezionare la query, creare una metrica basata su log o creare un avviso basato su log.

REST

Per informazioni su come leggere e scrivere i log di Cloud Run Functions a livello di programmazione, consulta Scrivere, visualizzare e rispondere ai log.

Visualizzare le metriche delle funzioni

Per i monitoraggi sintetici, le metriche vengono raccolte sia da Cloud Monitoring sia da Cloud Run Functions:

  • Cloud Monitoring raccoglie le metriche relative a ogni esecuzione di un monitoraggio sintetico. Queste metriche includono la latenza dell'esecuzione del codice e la cronologia di successo. Per informazioni su come visualizzare queste metriche, consulta Visualizzare la cronologia di esecuzione di un monitoraggio sintetico.

  • Cloud Run Functions raccoglie le metriche relative a ogni funzione Cloud Run. Queste metriche registrano il tempo di esecuzione, l'utilizzo della memoria, il conteggio delle istanze e il numero di chiamate per sezione. Il resto di questa sezione descrive come visualizzare queste metriche.

Per visualizzare le metriche di Cloud Run Functions nella Google Cloud console, procedi nel seguente modo:

  1. Nel riquadro con il nome del monitoraggio sintetico, fai clic sul nome della funzione Cloud Run.
  2. Nella pagina Dettagli funzione, seleziona la scheda Metriche.

Per eseguire lo zoom su un intervallo di tempo specifico:

  1. In un grafico, posiziona il puntatore su un'estremità dell'intervallo di tempo e fai clic con il tasto sinistro.
  2. Trascina il puntatore orizzontalmente fino all'altra estremità dell'intervallo di tempo, quindi rilascia il pulsante del puntatore.

Per esplorare i dati visualizzati in un grafico in modo più dettagliato, nella barra degli strumenti del grafico, seleziona Altre opzioni del grafico, e poi effettua una selezione. Le opzioni includono:

  • Scarica il grafico come PNG o CSV
  • Salva il grafico in una dashboard personalizzata
  • Apri Esplora metriche
  • Espandi o comprimi la legenda del grafico
  • Reimposta lo zoom