Esplorare i risultati del monitoraggio sintetico

L'analisi dei risultati di esecuzione del monitoraggio sintetico consente di diagnosticare gli errori di test, ispezionare la latenza delle richieste e analizzare la risposta delle applicazioni monitorate. Per ogni monitor sintetico, puoi visualizzare la cronologia di esecuzione, i log e i dati di traccia, nonché le metriche di rendimento e i log della funzione Cloud Run sottostante.

Prima di iniziare

Completa le seguenti operazioni nel progetto Google Cloud che archivia 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 del monitoraggio sintetico per il monitoraggio sintetico:

  1. Nella console Google Cloud , 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 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.
  3. Per aprire la pagina Dettagli monitor sintetico, individua il monitor sintetico che vuoi visualizzare, quindi fai clic sul relativo nome.

La pagina Dettagli monitor sintetico elenca le informazioni di riepilogo, ad esempio il tasso 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 e la durata e rimanda a una pagina che mostra il codice attuale e i log pertinenti a quella esecuzione.

Visualizzare log e tracce per un'esecuzione

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

  • Visualizza i dati dei log.
  • Visualizza i dati di tracciamento.

  • Visualizza il codice attuale.

  • Accedi alla funzione Cloud Run.

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

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

Visualizza dati di log

I log vengono raccolti automaticamente da Cloud Monitoring. Questi log contengono informazioni sul test e dettagli dell'errore. I log disponibili dipendono dalla tua funzione Cloud Run. Ad esempio, se utilizzi Mocha, i log includono informazioni sull'esito del test, la durata del test e, in caso di errore, un'analisi completa dello stack. L'analisi dello stack include la riga di codice che ha generato l'errore, 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.

Visualizza 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 console Google Cloud o l'Cloud Trace API.

Console

Per visualizzare i dati di traccia, esegui 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 console Google Cloud , vai alla pagina Esplora tracce:

      Vai a Esplora tracce

      Puoi trovare questa pagina anche utilizzando la barra di ricerca.

    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.
    3. Nel grafico heatmap o nella tabella, seleziona una traccia.

La traccia e gli intervalli possono includere cerchi nella sequenza temporale che rappresentano le voci di log o gli eventi che si sono verificati durante l'esecuzione. Fai clic sul cerchio per visualizzare 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 console Google Cloud per visualizzare i dati di traccia. Tuttavia, se vuoi utilizzare l'Cloud Trace API, utilizza il metodo traces.list per elencare le tracce disponibili e poi utilizza il metodo traces.get per ottenere i dettagli di una traccia.

Visualizza log e metriche per una funzione Cloud Run

Log e metriche forniscono informazioni sulle azioni eseguite dalla tua 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 dell'uptime.

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

Visualizza i log delle funzioni

Console

Per visualizzare i log delle funzioni Cloud Run:

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

Per esplorare in modo più dettagliato i dati dei log in un grafico, espandi una voce di log e poi seleziona Apri in Esplora log. In 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 Scrittura, visualizzazione e risposta ai log.

Visualizza le metriche delle funzioni

Per i monitor 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 monitor sintetico. Queste metriche includono la latenza dell'esecuzione del codice e la cronologia delle operazioni riuscite. Per informazioni su come visualizzare queste metriche, consulta Visualizzare la cronologia di esecuzione di un monitoraggio sintetico.

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

Per visualizzare le metriche della funzione Cloud Run nella console Google Cloud : svolgi le seguenti operazioni:

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

Per ingrandire un intervallo di tempo specifico:

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

Per esplorare in modo più dettagliato i dati visualizzati in un grafico, nella barra degli strumenti del grafico, seleziona Altre opzioni del grafico, quindi effettua una selezione. Sono incluse le opzioni seguenti:

  • Scaricare il grafico come PNG o CSV
  • Salvare il grafico in una dashboard personalizzata
  • Apri Esplora metriche
  • Espandi o comprimi la legenda del grafico
  • Reimpostare lo zoom