Esplorare i risultati del monitoraggio sintetico

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

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

Prima di iniziare

Completa i seguenti passaggi nel Google Cloud progetto 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 della cartella app.
  3. Per aprire la pagina Dettagli monitoraggio sintetico, individua il monitoraggio sintetico che vuoi visualizzare, quindi fai clic sul relativo nome.

La pagina Dettagli monitoraggio sintetico elenca informazioni di riepilogo, ad esempio il tasso di successo, la durata e lo stato più recente. Questa pagina mostra anche un grafico della 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 il link a una pagina che mostra il codice attuale e i log pertinenti all'esecuzione.

Visualizza log e tracce per un'esecuzione

Per visualizzare i log, le tracce e le informazioni di riepilogo per un'esecuzione, nella pagina Dettagli monitor 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 il 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 positivo o negativo del test, sulla durata del test e, in caso di esito negativo, un'analisi completa dello stack. 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 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 Google Cloud console, vai alla pagina Esplora tracce:

      Vai a Trace Explorer

      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 della cartella app.
    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 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 ulteriori informazioni sull'esplorazione dei dati di traccia, vedi Trovare ed esplorare le tracce.

API

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 tuo 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 della funzione 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. Da Esplora log, puoi eseguire azioni come perfezionare la query, creare una metrica basata sui log o creare un avviso basato sui log.

API

Per informazioni su come leggere e scrivere i log delle funzioni Cloud Run in modo programmatico, consulta Scrittura, visualizzazione e risposta ai log.

Visualizzare le metriche delle funzioni

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

  • Cloud Monitoring raccoglie metriche su 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, vedi Visualizzare la cronologia di esecuzione di un monitor 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 invocazioni per sezione. La parte restante di questa sezione descrive come visualizzare queste metriche.

Console

Per visualizzare le metriche della funzione 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 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, poi fai una selezione. Sono incluse le opzioni seguenti:

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