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.

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 i ruoli personalizzati o altri ruoli predefiniti.

Visualizzare la cronologia di esecuzione di un monitoraggio sintetico

Per comprendere la cronologia delle esecuzioni passate 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. Per aprire la pagina Dettagli monitoraggio sintetico, individua il monitoraggio sintetico che vuoi visualizzare e 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 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 contiene un link a una pagina che mostra il codice corrente e i log pertinenti a quell'esecuzione.

Visualizza log e tracce per un'esecuzione

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

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

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

  Se selezioni una voce contrassegnata come non riuscita, il codice di errore 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.

Visualizza i dati di traccia

I dati di Trace vengono raccolti automaticamente quando viene eseguita la 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 di Gantt mostra la richiesta HTTP avviata da Cloud Monitoring. I dati della traccia mostrano il testo passato al logger winston e la richiesta HTTP in uscita inviata dalla chiamata axios get.

Nel menu a scomparsa del tracciato, se fai clic su Visualizza nel tracciato, puoi visualizzare i dati del tracciato utilizzando Cloud Trace Explorer. La traccia è già espansa per mostrare i dettagli. Quando la traccia o l'intervallo mostra un cerchio, puoi fare clic sul cerchio per visualizzare la voce di log. La funzione Cloud Run può essere identificata visualizzando il campo resource.labels.service_name.

Visualizzare i log e le metriche di una funzione Cloud Run

I log e le metriche forniscono informazioni sulle azioni eseguite dalla 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 dalle funzioni Cloud Run.

Visualizza i log delle funzioni

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 Visualizzare la cronologia delle esecuzioni di un monitor 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 rimanente di questa sezione descrive come visualizzare queste metriche.