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 genera 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 da includere.

I report personalizzati includono:

  • Un istogramma dei dati sulla latenza.
  • Una tabella che elenca la latenza in base al percentile, insieme ai link alle tracce di esempio.
  • (Facoltativo) Dati sulla latenza di un intervallo di tempo diverso da utilizzare per il confronto.
  • Un riquadro Bottleneck che elenca le chiamate RPC che contribuiscono in modo significativo alla latenza.

Puoi creare un nuovo report inserendo manualmente i relativi parametri 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 con il sottotitolo Traccia.

  2. Fai clic su Nuovo report.

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

    • Request filter: l'URI completo, il prefisso dell'URI o i termini di filtro 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 preceduto daRecv/cart, inserisci il prefisso nel filtro.

      Puoi anche filtrare le tracce in base agli attributi degli intervalli. 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 per il report. Se non viene specificato alcun nome per questo campo facoltativo, Trace crea un nome in base al filtro delle richieste specificato e all'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 Traccia, 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 con il sottotitolo 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 Traccia.

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

Visualizza per distribuzione della densità

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

Report Cloud Trace con la latenza visualizzata come istogramma.

Quando crei un report di confronto, la funzionalità Trace sovrappone i dati dei 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. Questi dati 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 di Cloud Trace con la 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 Esploratore traccia, che mostra informazioni dettagliate sull'intervallo principale della traccia. Per maggiori dettagli, consulta Trovare ed esplorare le tracce.

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

Pannello della 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.

Informazioni sul riquadro Bottleneck

Un collo di bottiglia indica che il valore della latenza per uno span in una traccia specifica rientra nell'intervallo previsto dei valori di latenza. 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 Bottleneck, 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.

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 di confronto, i colli di bottiglia evidenziano le chiamate RPC che hanno causato variazioni nella distribuzione della latenza tra i due set. La legenda in questo riquadro identifica le voci che appartengono a ciascuno dei set di dati.

Passaggi successivi