Creare e visualizzare report

I report di analisi in Cloud Trace mostrano una visione complessiva della latenza per tutte le richieste della tua applicazione o per un sottoinsieme di richieste.

Rapporti giornalieri

Trace crea automaticamente un report giornaliero che confronta le prestazioni del giorno precedente con quelle dello stesso giorno della settimana precedente per i primi tre endpoint.

Per maggiori dettagli sulla visualizzazione del report dell'analisi giornaliera, consulta Visualizzare un report.

Report di analisi personalizzati

Il report di analisi giornaliero viene creato automaticamente e non ti consente di scegliere i contenuti del report. Tuttavia, puoi creare un report di analisi personalizzato e selezionare le tracce da includere nel report.

I report personalizzati includono:

  • Un istogramma dei dati di latenza.
  • Tabella che elenca la latenza per percentile insieme ai link alle tracce di campionamento.
  • (Facoltativo) Dati di latenza di un intervallo di tempo diverso che utilizzi per il confronto.
  • Un riquadro collo di bottiglia in cui sono elencate le chiamate RPC che contribuiscono in modo significativo alla latenza.

Puoi creare un nuovo report inserendo i parametri del report manualmente oppure duplicare un report esistente e modificarne i parametri. Entrambi questi approcci sono descritti nelle sezioni seguenti.

Creare un nuovo report

Per creare un nuovo report di analisi:

  1. Nella console Google Cloud, vai alla pagina Report di analisi:

    Vai a Report di analisi

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato il cui sottotitolo è Trace.

  2. Fai clic su Nuovo report.

  3. Inserisci o seleziona i seguenti parametri nel modulo visualizzato:

    • Request filter: l'URI completo, il prefisso URI o i termini del filtro di traccia.

      Ad esempio, se un intervallo principale del progetto è Recv, per includere tutte le richieste inserisci il nome dell'intervallo principale, Recv o un prefisso del nome dell'intervallo principale. Per limitare il report alle tracce con un URI preceduto da Recv/cart, inserisci questo prefisso nel filtro.

      Puoi anche filtrare le tracce in base agli attributi di intervallo. Ad esempio, quando aggiungi /http/status_code:5, il report include solo le tracce che hanno un intervallo con chiave dell'attributo /http/status_code e valori degli attributi preceduti da 5.
    • HTTP method: metodo HTTP per la richiesta. Il valore predefinito è Tutti.
    • HTTP Status: stato HTTP restituito dalla richiesta. Il valore predefinito è Tutti.
    • Report Name: nome leggibile del report. Se per questo campo facoltativo non viene specificato alcun nome, Trace crea un nome in base al filtro delle richieste specificato e all'ora in cui è stato creato il report.
    • Module: modulo App Engine (Java, Python, Go o PHP) che ha gestito la richiesta. Il valore predefinito è Tutti.
    • Version: versione dell'applicazione App Engine che ha gestito la richiesta. Il valore predefinito è Tutti.
    • Time Range: intervallo di tempo durante il quale si sono verificate le richieste. Puoi selezionare Ultima ora, Ultime 24 ore, Ultima settimana o Intervallo personalizzato. Quando selezioni Personalizzato, devi specificare l'ora di inizio e l'ora di fine dell'intervallo. Il valore predefinito è Personalizzato.
  4. (Facoltativo) Per confrontare due set di dati di latenza, seleziona Confronta con riferimento e inserisci l'intervallo di tempo per i dati di confronto.

  5. Fai clic su Invia.

Duplicare un report

In Trace, puoi duplicare i parametri di filtro di un report esistente:

  1. Nella console Google Cloud, vai alla pagina Report di analisi:

    Vai a Report di analisi

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato il cui sottotitolo è Trace.

  2. Fai clic sul nome del report di cui vuoi duplicare la struttura.

  3. Fai clic su Crea report simile.

  4. Nella pagina Nuova richiesta di report, modifica uno o più parametri del report, incluso il nome del report.

  5. Fai clic su Invia.

Visualizzare un report

Per visualizzare un report di analisi:

  1. Nella console Google Cloud, vai alla pagina Report di analisi:

    Vai a Report di analisi

    Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato il cui sottotitolo è Trace.

  2. Per visualizzare un report, fai clic sul suo nome.

Visualizza per distribuzione della densità

Per impostazione predefinita, il pulsante Distribuzione della densità è attivo. Con questa impostazione, l'asse x è la latenza della traccia su una scala logaritmica, mentre l'asse y è la percentuale delle richieste totali con quella latenza:

Report Cloud Trace con latenza visualizzata come istogramma.

Quando crei un report di confronto, Trace sovrappone i dati dei due set per consentirti di confrontarli e analizzare eventuali modifiche:

Report di confronto di Cloud Trace con la latenza visualizzata come istogramma.

Nel report di confronto, la legenda identifica l'intervallo di tempo per i grafici arancione e blu. Sono stati omessi nello screenshot.

Visualizza per distribuzione cumulativa

Per visualizzare il numero totale di richieste la cui latenza è inferiore o uguale al valore della latenza sull'asse x, fai clic su Distribuzione cumulativa:

Report Cloud Trace con latenza visualizzata come distribuzione cumulativa.

Informazioni sul riquadro della latenza

Il riquadro Latenza mostra i percentili di latenza e include link alle tracce per le richieste di esempio rappresentative. Per visualizzare i dettagli di una traccia specifica, seleziona una delle quattro tracce di esempio. Quando selezioni una delle tracce di esempio, si apre la pagina Esplora tracce, che mostra informazioni dettagliate sull'intervallo principale della traccia. Per maggiori dettagli, vedi Trovare ed esplorare le tracce.

La seguente immagine mostra un riquadro di latenza per un report di analisi. In questo caso, esiste un solo set di dati indicato dalla lettera A:

Riquadro Latenza di Cloud Trace.

Quando crei un report di confronto, il riquadro dei dati sulla latenza contiene informazioni per entrambi i set di dati. La legenda del riquadro identifica le voci che appartengono a ciascun set di dati.

Comprendere il riquadro dei colli di bottiglia

Un collo di bottiglia indica che il valore di latenza per un intervallo in una traccia specifica non rientra nell'intervallo previsto di valori di latenza. Cloud Trace determina l'intervallo previsto di valori di latenza utilizzando tecniche statistiche che si basano sul calcolo e sul confronto delle distribuzioni empiriche della latenza per i sottoinsiemi di tracce.

Il riquadro Colli di bottiglia, se presente, elenca le chiamate RPC che contribuiscono in modo significativo alla latenza nelle richieste. Questo riquadro mostra le chiamate RPC per percentile con richieste di esempio rappresentative. Puoi fare clic su un numero in Tracce di esempio per visualizzare i dettagli di una traccia specifica.

La seguente immagine mostra il riquadro Colli di bottiglia per un report di analisi. In questo caso, esiste un solo set di dati indicato dalla lettera A:

Riquadro colli di bottiglia delle richieste Cloud Trace.

In un report comparativo, i colli di bottiglia evidenziano le chiamate RPC che hanno causato cambiamenti nella distribuzione della latenza tra i due insiemi. La legenda in questo riquadro identifica le voci appartenenti a ciascuno dei set di dati.

Passaggi successivi