Creare e visualizzare report

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

Rapporti giornalieri

Trace crea automaticamente un report giornaliero che confronta il rendimento del giorno precedente con quello dello stesso giorno della settimana precedente per i tre endpoint principali.

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

Report di analisi personalizzati

Il report di analisi giornaliera viene creato automaticamente e non ti consente di scegliere i contenuti. Tuttavia, puoi creare un report di analisi personalizzato e selezionare le tracce sono inclusi nel report.

I report personalizzati includono:

  • Un istogramma dei dati di latenza.
  • Una tabella che elenca la latenza per percentile insieme ai link da campionare le tracce audio.
  • (Facoltativo) Dati sulla latenza di un intervallo di tempo diverso da utilizzare per il confronto.
  • Un riquadro del collo di bottiglia che elenca le chiamate RPC significative che contribuiscono alla latenza.

Puoi creare un nuovo report inserendo manualmente i relativi parametri oppure duplicare un report esistente e modificarne i parametri. Entrambi gli 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 con il sottotitolo Trace (Traccia).

  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 termini del filtro di traccia.

      Ad esempio, quando uno spazio principale di un progetto è Recv, per includere tutte le richieste, inserisci il nome dello spazio principale, Recv, o un prefisso del nome dello spazio principale. Per limitare il report alle tracce con un URI con prefisso Recv/cart, inserisci il prefisso nel filtro.

      Puoi anche filtrare le tracce in base agli attributi di intervallo. Ad esempio, quando aggiunti /http/status_code:5, il report include solo le tracce che hanno uno spazio con la chiave dell'attributo /http/status_code e i valori dell'attributo con prefisso 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 alla richiesta specificata filtro e l'ora in cui è stato creato il report.
    • Module: il modulo App Engine (Java, Python, Go o PHP) che ha gestito la richiesta. Il valore predefinito è Tutti.
    • Version: la 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 le ore di inizio e di fine dell'intervallo. Il valore predefinito è Personalizzata.
  4. (Facoltativo) Per confrontare due insiemi di dati sulla latenza, seleziona Confronta con il valore di 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 del 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 con il sottotitolo Trace (Traccia).

  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 con il sottotitolo Trace (Traccia).

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

Visualizza per distribuzione di densità

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

Report Cloud Trace con latenza visualizzata come istogramma.

Quando crei un report di confronto, Trace sovrappone i dati i due set di dati in modo da poterli confrontare 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 arancioni 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 i 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 e visualizza informazioni dettagliate sull'intervallo principale della traccia. Per maggiori dettagli, consulta 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 ciascuno dei set di dati.

Comprendere il riquadro dei colli di bottiglia

Un collo di bottiglia indica che il valore della latenza per uno span in una traccia specifica rientra nell'intervallo di valori di latenza previsti. Cloud Trace determina l'intervallo previsto dei valori di latenza utilizzando tecniche statistiche che si basano su calcoli e confronti di distribuzioni empiriche della latenza per sottoinsiemi di tracce.

Il riquadro Colli di bottiglia, se presente, elenca le chiamate RPC significative contribuiscono alla latenza nelle richieste. Questo riquadro visualizza 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 un una traccia specifica.

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

Riquadro Bottleneck delle richieste di 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 set. La legenda in questo riquadro identifica le voci appartenenti a ciascuno dei dati e set di dati.

Passaggi successivi