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

Prima di iniziare

Per ottenere le autorizzazioni necessarie per visualizzare i risultati dell'esecuzione del monitoraggio sintetico utilizzando la console Google Cloud, chiedi all'amministratore di concederti i seguenti ruoli IAM sul tuo progetto:

• Monitoring Viewer (roles/monitoring.viewer) (Visualizzatore Monitoring)
• Sviluppatore Cloud Functions (roles/cloudfunctions.developer)
• Visualizzatore log (roles/logging.viewer)

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Visualizza la cronologia di esecuzione per un monitoraggio sintetico

Per comprendere la cronologia delle esecuzioni superate e non riuscite, consulta la pagina Dettagli 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 il cui sottotitolo è Monitoring.

2. Per aprire la pagina Dettagli monitoraggio sintetico, individua il monitor 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 e 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 nella tabella elenca lo stato, la data e la durata. Inoltre, rimanda a una pagina che mostra il codice corrente 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, fai clic sul link all'esecuzione nella pagina Dettagli monitoraggio sintetico. In questa pagina puoi eseguire le seguenti operazioni:

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

• Visualizza il codice attuale.

  Nota: Cloud Functions archivia una copia del tuo codice. Quando visualizzi i risultati di qualsiasi esecuzione, il codice visualizzato è il codice attuale e potrebbe non essere pertinente per l'esecuzione specifica.

• Accedi alla Cloud Function.

• Per il test Mocha, visualizza i risultati di ogni test. Ad esempio, se il monitoraggio sintetico contiene quattro test Mocha, il riquadro Risultati del test contiene quattro voci. Ogni voce nell'elenco è annotata come superamento o errore.

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

Visualizza dati di log

I log vengono raccolti automaticamente da Cloud Monitoring. Questi log contengono informazioni sui dettagli di test ed errori. I log disponibili dipendono dalla Cloud Function. Ad esempio, se utilizzi Mocha, i log includono informazioni che indicano se il test è stato superato o meno, la durata del test e, in caso di errore, 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, nel riquadro Log di esecuzione, espandi una voce di log.

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 dati traccia

I dati di Trace vengono raccolti automaticamente quando viene eseguita la Cloud Function. Il seguente screenshot mostra il tipo di dati che vengono acquisiti dalle tracce quando utilizzi il modello generico:

Nello screenshot precedente, la prima riga del grafico di Gantt mostra la richiesta HTTP avviata da Cloud Monitoring. I dati di traccia mostrano il testo trasmesso al logger vince e mostra la richiesta HTTP in uscita emessa dalla chiamata axios get.

Nel riquadro a scomparsa della traccia, se fai clic su Visualizza nella traccia, puoi visualizzare i dati di traccia utilizzando l'esplorazione di Cloud Trace. La traccia è già espansa per mostrare i dettagli. Quando la traccia o l'intervallo visualizza un cerchio, puoi fare clic sul cerchio per visualizzare la voce di log. La funzione Cloud Functions può essere identificata visualizzando il campo resource.labels.service_name.

Console

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

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

  Si apre un riquadro a scomparsa che mostra un riepilogo dei dati di latenza. Per informazioni complete sulla traccia e sui suoi intervalli, visualizza i dati in Cloud Trace. Per aprire Cloud Trace, fai clic su Visualizza nella traccia.

• Visualizza le tue tracce in Cloud Trace:

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

     Vai a Trace Explorer

     Puoi trovare questa pagina anche utilizzando la barra di ricerca.

  2. Nel grafico a dispersione o nella tabella, seleziona una traccia.
  3. Per ogni log o evento associato a un intervallo, quest'ultimo viene annotato con un cerchio. Seleziona il cerchio per visualizzare i dettagli dell'evento o del log.

Per maggiori informazioni sull'esplorazione dei dati di traccia, consulta Trovare ed esplorare tracce.

API

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

Visualizza log e metriche per una Cloud Function

I log e le metriche forniscono informazioni sulle azioni eseguite dalla funzione Cloud Function. Ad esempio, i log che contengono un campo denominato userAgent con un valore GoogleStackdriverMonitoring-UptimeChecks indicano che il tuo 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 Functions.

Visualizza i log delle funzioni

Console

Per visualizzare i log delle funzioni Cloud Function, segui questi passaggi:

1. Nel riquadro con il nome del monitor sintetico, fai clic sul nome della funzione Cloud Function.
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. In Esplora log puoi eseguire azioni come perfezionare la query, creare una metrica basata su log o creare un avviso basato su log.

API

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

Visualizza metriche delle funzioni

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

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

• Cloud Functions raccoglie metriche su ogni Cloud Function. Queste metriche registrano il tempo di esecuzione, l'utilizzo della memoria, il numero di istanze e il numero di chiamate per sezione. La parte restante di questa sezione descrive come visualizzare queste metriche.

Console

Per visualizzare le metriche della Cloud Function, segui questi passaggi:

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

Per aumentare lo zoom su un intervallo di tempo specifico:

1. In un grafico, posiziona il puntatore a un'estremità dell'intervallo di tempo e 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 più nel dettaglio i dati visualizzati in un grafico, seleziona Altre opzioni del grafico nella barra degli strumenti del grafico, poi effettua una selezione. Le opzioni includono le seguenti:

• Scarica il grafico in formato PNG o CSV
• Salva il grafico in una dashboard personalizzata
• Apri Metrics Explorer
• Espandi o comprimi la legenda del grafico
• Reimposta lo zoom

API

Per informazioni su come leggere le metriche della Cloud Function in modo programmatico, consulta Visualizzazione delle metriche monitorate.