Panoramica dell'archiviazione delle Trace

Questo documento descrive il modello di archiviazione per i dati di Cloud Trace. Introduce bucket, visualizzazioni e link di osservabilità. Se crei un collegamento, puoi eseguire query sui dati di traccia da BigQuery.

Questo documento non descrive lo schema, che specifica come vengono archiviati i singoli span. Per saperne di più, consulta Schema di traccia.

Modello di archiviazione dell'osservabilità

Il modello di archiviazione dell'API Observability si basa sulla seguente architettura:

Bucket di osservabilità
Un bucket di osservabilità è l'entità di gestione per i set di dati, che archiviano i dati. Un bucket di osservabilità si trova in una posizione specifica e ha un criterio di conservazione dei dati. Quando un servizio Google Cloud utilizza l'API Observability per archiviare i propri dati, il sistema crea un bucket di osservabilità in base al nome del servizio. Ad esempio, per il servizio Cloud Trace, il bucket creato dal sistema si chiama _Trace. Per scoprire la struttura di un bucket di osservabilità, consulta Bucket.
Set di dati
Un dataset è un'entità di archiviazione. Ogni set di dati è figlio di un bucket di osservabilità. Quando il sistema crea un bucket di osservabilità per un servizio Google Cloud , crea anche un set di dati. Ad esempio, dopo che il sistema crea il bucket _Trace, crea il set di dati denominato Spans. Questo set di dati archivia i dati di traccia. Per informazioni sulla struttura di un set di dati, consulta Dataset.
Visualizzazioni dei set di dati
Ogni set di dati ospita una o più visualizzazioni. Una vista fornisce l'accesso in lettura a un sottoinsieme di voci nel set di dati. Quando viene creato un set di dati, il sistema crea automaticamente una vista. Questa visualizzazione include tutti i dati nel set di dati. Il nome della visualizzazione dipende dal servizio. Ad esempio, per il servizio Cloud Trace, il sistema crea una vista denominata _AllSpans nel set di dati Spans. Per scoprire la struttura di una vista, consulta View.
Link sui set di dati

Ogni set di dati può contenere al massimo un link. Quando crei un collegamento per un set di dati, il sistema crea un set di dati BigQuery collegato. Puoi quindi eseguire query sui dati nel set di dati utilizzando BigQuery o altri servizi che utilizzano l'API BigQuery. Per scoprire di più sulla struttura di un link, consulta Link.

Il sistema non crea automaticamente link nei set di dati.

Configurazione dell'archiviazione per i dati di traccia

I dati di traccia vengono archiviati in un bucket di osservabilità denominato _Trace. Il sistema crea un set di dati denominato Spans in questo bucket. Su questo set di dati, il sistema crea una vista denominata _AllSpans. Questa visualizzazione include tutti i dati del set di dati.

Il sistema tenta una sola volta di creare il bucket denominato _Trace quando il bucket non esiste e si verifica una delle seguenti condizioni:

  • Un'applicazione invia dati di traccia al tuo progetto Google Cloud utilizzando l&#39Cloud Trace APIe o l'API Telemetry.

  • Abiliti Cloud Trace per un servizio Google Cloud e poi questo servizio invia i dati di traccia al tuo progetto Google Cloud . Ad esempio, Cloud Service Mesh supporta la raccolta delle tracce, ma questa è disattivata per impostazione predefinita. Se attivi la tracciabilità per Cloud Service Mesh, i dati inviati da questo servizio causano la creazione del bucket da parte del sistema.

    I dati di Trace generati da Cloud Run Functions, Cloud Run e App Engine non causano la creazione del bucket di osservabilità da parte del sistema. Gli intervalli di questi servizi vengono archiviati solo quando esiste il bucket di osservabilità.

Per determinare se esiste il bucket di osservabilità denominato _Trace o per attivare un flusso che crea questo bucket:

  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. Esegui una delle seguenti operazioni:

    • Se la pagina mostra i dati di tracciamento, non devi fare nulla. Il tuo progetto Google Cloud contiene un bucket di osservabilità denominato _Trace.

    • Se la pagina mostra il seguente banner, significa che non sono presenti dati di traccia o che sono presenti solo dati di Cloud Run Functions, Cloud Run e App Engine.

      Trace storage is not initialized for this project. Enable trace storage to begin collecting trace data.

      Se vuoi attivare un flusso che crea un bucket di osservabilità denominato _Trace, vai al banner e fai clic su Attiva.

    • Se nella pagina viene visualizzato il seguente banner, l'inizializzazione del bucket di osservabilità denominato _Trace non è riuscita. Se visualizzi questo messaggio, vai al banner e fai clic su Apri un ticket.

      Initializing trace storage has failed for an unexpected reason. Please file a support ticket for assistance.

Limitazioni

Non puoi:

  • Modificare o eliminare i bucket di osservabilità.
  • Creare, eliminare o modificare i set di dati.
  • Creare, eliminare o modificare le visualizzazioni.
  • Utilizza la Google Cloud console per elencare bucket, set di dati, viste o link.
  • Crea bucket di osservabilità in località diverse da us; un bucket di osservabilità deve trovarsi nella località us.

Passaggi successivi