Esplorare i risultati del monitoraggio sintetico

Questo documento descrive come esplori la cronologia di esecuzione del tuo monitor sintetici e descrive inoltre come visualizzare le metriche raccolte logaritmi.

Prima di iniziare

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

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

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

Visualizza la cronologia di esecuzione per un monitoraggio sintetico

Per comprendere la cronologia delle esecuzioni superate e non riuscite, visualizza il 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. Per aprire la pagina Dettagli monitor sintetico, individua l'icona monitor sintetico che vuoi visualizzare, quindi fai clic sul relativo nome.

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

Ogni riga della tabella elenca lo stato, la data, la durata e contiene un link a una pagina che mostra il codice corrente e i log pertinenti a quell'esecuzione.

Visualizzare i log e le tracce di 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 traccia.

• Visualizza il codice attuale.

  Nota: le funzioni di Cloud Run archivia una copia del codice. Quando visualizzi i risultati di qualsiasi esecuzione, il codice visualizzato è quello corrente e potrebbe non essere pertinente all'esecuzione specifica.

• Accedere 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 Pass o Fail.

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

Visualizza dati di log

I log vengono raccolti automaticamente da Cloud Monitoring. Questi log contengono informazioni sul test e sui dettagli dell'errore. I log disponibili dipendono dalla funzione Cloud Run. Ad esempio, se utilizzi Mocha, i log includono informazioni sull'esito del test (passato o non superato), sulla 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 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. Viene aperto Esplora log e una query è preconfigurata.

Visualizzare i dati di traccia

I dati di Trace vengono raccolti automaticamente quando la tua funzione Cloud Run . Lo screenshot seguente mostra il tipo di dati acquisiti dalla traccia quando utilizzi il modello generico:

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

Nel riquadro a comparsa della traccia, Se fai clic su Visualizza in traccia, puoi visualizzare i dati di traccia utilizzando il metodo 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 voce di log. La funzione Cloud Run 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 di un'esecuzione.

  Viene visualizzato un popup che mostra un riepilogo dei dati sulla latenza. Per informazioni complete sulla traccia e sui relativi intervalli, visualizza i dati in Cloud Trace. Per aprire Cloud Trace, fai clic su Visualizza nel tracciamento.

• 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, l'intervallo viene annotato con un cerchio. Per visualizzare i dettagli dell'evento o del log, seleziona la cerchia.

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

API

Ti consigliamo di utilizzare la console Google Cloud per visualizzare i dati traccia. Tuttavia, se vuoi usare l'Cloud Trace API, utilizza il comando Metodo traces.list per elencare le tracce disponibili, e quindi utilizza metodo traces.get 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 La funzione Cloud Run è in esecuzione. Ad esempio, i log che contengono un campo denominato userAgent con il valore GoogleStackdriverMonitoring-UptimeChecks, indica 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 raccolte dalle funzioni Cloud Run.

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 su il nome della funzione Cloud Run.
2. Nella pagina Dettagli funzione, seleziona la scheda Log.

Per esplorare i dati di log di 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 metrica basata su log, oppure crea un avviso basato su log.

API

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

Visualizzare le metriche della funzione

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

• 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 dei risultati. Per informazioni su come visualizzare queste metriche, consulta Visualizza la cronologia di esecuzione per un monitoraggio sintetico.

• Le funzioni Cloud Run raccolgono le metriche relative a ogni funzione Cloud Run. Queste metriche registrano il tempo di esecuzione, l'utilizzo della memoria, il conto delle istanze e il numero di invocazioni per sezione. La parte restante di in questa sezione viene descritto come visualizzare queste metriche.

Console

Per visualizzare le metriche della funzione Cloud Run:

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

Per aumentare lo zoom di un intervallo di tempo specifico:

1. Su un grafico, posiziona il puntatore alla fine dell'intervallo di tempo e poi fai clic con il tasto sinistro del mouse.
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, nella barra degli strumenti del grafico, seleziona Altre opzioni del grafico, ed effettua una selezione. Le opzioni includono:

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

API

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