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 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 utilizza l'API Observability per archiviare i propri dati, il sistema crea un bucket di osservabilità in base al nome del servizio, un set di dati per archiviare i dati e una vista per fornire l'accesso in lettura ai dati archiviati. Google Cloud Ad esempio, per il servizio Cloud Trace, il sistema assegna al bucket creato dal sistema il nome _Trace, al set di dati il nome Spans e alla visualizzazione il nome _AllSpans. Per scoprire la struttura di un bucket di osservabilità, consulta Bucket.
Set di dati
Un set di dati archivia i dati. Il sistema crea automaticamente un set di dati quando crea un bucket di osservabilità, che gestisce il set di dati. Ad esempio, quando il sistema crea il bucket _Trace, crea anche un set di dati denominato Spans, che archivia i dati di traccia. Per scoprire di più 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. Il sistema crea una visualizzazione quando crea un set di dati. 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 di più sulla struttura di una vista, consulta View.
Link sui set di dati

Ogni set di dati può contenere al massimo un link. Quando crei un link 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 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 di creare il bucket di osservabilità 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'Cloud Trace API 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à.

Se riesci a visualizzare i dati di traccia utilizzando la pagina Esplora tracce, significa che il bucket di osservabilità denominato _Trace esiste. Se non vedi dati o se vedi un banner che indica che l'archiviazione non è inizializzata, prova una delle seguenti operazioni:

Residenza dei dati per i bucket di osservabilità

Se hai requisiti di conformità o normativi per archiviare i dati in posizioni specifiche o per utilizzare chiavi di crittografia gestite dal cliente (CMEK), ti consigliamo di configurare sia i criteri dell'organizzazione sia le impostazioni predefinite per i bucket di osservabilità.

Per organizzazioni, cartelle e progetti, le impostazioni predefinite per i bucket di osservabilità consentono di configurare quanto segue:

  • Una posizione di archiviazione predefinita.
  • Per ogni località, una chiave Cloud Key Management Service predefinita.

Se configurate per un progetto, queste impostazioni si applicano solo ai nuovi bucket di osservabilità creati in quel progetto. Se configurate per una cartella o un'organizzazione, queste impostazioni vengono applicate ai nuovi bucket di osservabilità creati nei progetti discendenti della cartella o dell'organizzazione, ad eccezione di quelli in cui hai configurato le impostazioni predefinite.

Puoi anche utilizzare i criteri dell'organizzazione per limitare le posizioni dei nuovi bucket di osservabilità, per richiedere l'utilizzo delle CMEK o per limitare le chiavi Cloud KMS che possono essere utilizzate per la crittografia. Se configuri criteri dell'organizzazione che richiedono l'utilizzo di CMEK, devi configurare le impostazioni predefinite per i bucket di osservabilità. In caso contrario, il provisioning dei bucket di osservabilità creati dal sistema non andrà a buon fine.

Per saperne di più, consulta Imposta i valori predefiniti per i bucket di osservabilità.

Limitazioni

Non puoi:

  • Modificare o eliminare i bucket di osservabilità.
  • Crea, elimina o modifica i set di dati.
  • Creare, eliminare o modificare le visualizzazioni.
  • Utilizza la Google Cloud console per elencare bucket, set di dati, viste o link.

Passaggi successivi