Esplora i risultati del monitoraggio sintetico

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

Prima di iniziare

Per ottenere le autorizzazioni necessarie per visualizzare i risultati dell'esecuzione dei monitoraggi sintetici utilizzando la console Google Cloud, chiedi all'amministratore di concederti i seguenti ruoli IAM nel tuo progetto:

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

Potresti anche riuscire a 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, visualizza 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 con il sottotitolo Monitoring.

  2. Per aprire la pagina Dettagli monitor sintetico, individua il monitor sintetico che vuoi visualizzare, quindi fai clic sul suo nome.

La pagina Dettagli monitoraggio sintetico elenca 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 della tabella elenca lo stato, la data e la durata e rimanda a una pagina in cui sono visualizzati il codice corrente e i log pertinenti.

Visualizza log e tracce per un'esecuzione

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

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

  • Visualizza il codice attuale.

  • Accedere alla Cloud Function.

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

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

Visualizza dati di log

I log vengono raccolti automaticamente da Cloud Monitoring. Questi log contengono informazioni sui dettagli del test e dell'errore. I log disponibili dipendono dalla Cloud Functions. Ad esempio, se utilizzi Mocha, i log includono informazioni sull'esito del test se è stato superato o meno, sulla durata del test e, in caso di errore, su un'analisi completa dello stack. La analisi dello stack include la riga di codice non riuscita, i tipi 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 ed è preconfigurata una query.

Visualizza i dati della traccia

I dati di Trace vengono raccolti automaticamente durante l'esecuzione della Cloud Function. Il seguente screenshot mostra il tipo di dati acquisiti dalla traccia quando utilizzi il modello generico:

Cloud Trace che mostra i dettagli di una traccia per una Cloud Function.

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

Nel riquadro a scomparsa della traccia, se fai clic su Visualizza nella traccia, puoi visualizzare i dati di traccia utilizzando Explorer 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, procedi in uno dei seguenti modi:

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

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

  • Visualizza le tracce in Cloud Trace:

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

      Vai a Trace Explorer

      Puoi trovare questa pagina anche utilizzando la barra di ricerca.

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

Per saperne di più sull'esplorazione dei dati delle tracce, consulta 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, usa il metodo traces.list per elencare le tracce disponibili, quindi utilizza il metodo traces.get per ottenere i dettagli di una traccia.

Visualizza i log e le 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 valore 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 Functions.

Visualizza i log delle funzioni

Console

Per visualizzare i log della funzione 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 quindi 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 monitoraggi sintetici, le metriche vengono raccolte sia da Cloud Monitoring che da Cloud Functions:

  • Cloud Monitoring raccoglie le metriche su ogni esecuzione di un monitoraggio 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 per un monitoraggio sintetico.

  • Cloud Functions raccoglie le metriche relative a 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. Il resto 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 una fine dell'intervallo di tempo, quindi fai clic con il tasto sinistro del mouse sul puntatore.
  2. Trascina il puntatore orizzontalmente fino all'altra fine dell'intervallo di tempo, quindi rilascia il pulsante del puntatore.

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

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

API

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