Panoramica delle esportazioni dei dati di Trace

Attenzione: a partire dal 18 febbraio 2026, l'esportazione dei dati degli intervalli in BigQuery tramite i sink di Cloud Trace è obsoleta. I sink utilizzati per esportare gli intervalli in BigQuery verranno rimossi a partire dal 18 febbraio 2027. Per informazioni su come visualizzare i dati degli intervalli in BigQuery, consulta Eseguire la migrazione a Observability Analytics.

Beta

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questa pagina fornisce una panoramica concettuale dell'esportazione dei dati di traccia utilizzando Cloud Trace. Potresti voler esportare i dati di traccia per i seguenti motivi:

• Per archiviare i dati di traccia per un periodo superiore al periodo di conservazione predefinito di 30 giorni.

• Per consentirti di utilizzare gli strumenti di BigQuery per analizzare i dati di traccia. Ad esempio, utilizzando BigQuery, puoi identificare i conteggi e i quantili degli intervalli. Per informazioni sulla query utilizzata per generare la seguente tabella, consulta Query HipsterShop.

  

Nota: solo gli intervalli di traccia importati tramite l'Cloud Trace API sono idonei all' esportazione. Gli intervalli di Trace emessi dai Google Cloud servizi o importati tramite l' API Telemetry non sono supportati.

Come funzionano le esportazioni

L'esportazione prevede la creazione di un sink per un Google Cloud progetto. Un sink definisce un set di dati BigQuery come destinazione.

Puoi creare un sink utilizzando l'Cloud Trace API o Google Cloud CLI.

Proprietà e terminologia dei sink

I sink sono definiti per un Google Cloud progetto e hanno le seguenti proprietà:

• Nome: un nome per il sink. Ad esempio, un nome potrebbe essere:

  "projects/PROJECT_NUMBER/traceSinks/my-sink"
  

  dove PROJECT_NUMBER è il numero del progetto del sink Google Cloud e my-sink è l'identificatore del sink.

• Parent: la risorsa in cui crei il sink. Il parent deve essere un Google Cloud progetto:

  "projects/PROJECT_ID"
  

  Il PROJECT_ID può essere un Google Cloud identificatore o un numero di progetto.

• Destinazione: un unico luogo in cui inviare gli intervalli di traccia. Trace supporta l'esportazione delle tracce in BigQuery. La destinazione può essere il progetto del sink o qualsiasi altro progetto della stessa organizzazione. Google Cloud Google Cloud

  Ad esempio, una destinazione valida è:

  bigquery.googleapis.com/projects/DESTINATION_PROJECT_NUMBER/datasets/DATASET_ID
  

  dove DESTINATION_PROJECT_NUMBER è il Google Cloud numero del progetto di destinazione e DATASET_ID è l'identificatore del set di dati BigQuery.

• Writer Identity: un nome di account di servizio. Il proprietario della destinazione di esportazione deve concedere a questo account di servizio le autorizzazioni per scrivere nella destinazione di esportazione. Quando esporta le tracce, Trace adotta questa identità per l'autorizzazione. Per una maggiore sicurezza, i nuovi sink ricevono un account di servizio univoco:

  [e-mail]
  

  dove PROJECT_NUMBER è il numero del progetto, Google Cloud in formato esadecimale, e GENERATED_VALUE è un valore generato in modo casuale.

  Non crei, possiedi o gestisci il account di servizio identificato dall'identità writer di un sink. Quando crei un sink, Trace crea l'account di servizio richiesto dal sink. Questo account di servizio non è incluso nell'elenco degli account di servizio per il tuo progetto finché non ha almeno un'associazione Identity and Access Management. Aggiungi questo binding quando configuri una destinazione del sink.

  Per informazioni sull'utilizzo dell'identità writer, consulta Autorizzazioni di destinazione.

Come funzionano i sink

Ogni volta che un intervallo di traccia arriva in un progetto, Trace ne esporta una copia.

Le tracce ricevute da Trace prima della creazione del sink non possono essere esportate.

Controllo degli accessi

Per creare o modificare un sink, devi disporre di uno dei seguenti ruoli Identity and Access Management:

• Trace Admin
• Trace User
• Proprietario progetto
• Editor progetto

Per ulteriori informazioni, consulta Controllo degli accessi.

Per esportare le tracce in una destinazione, l'account di servizio writer del sink deve avere l'autorizzazione di scrittura nella destinazione. Per ulteriori informazioni sulle identità writer, consulta Proprietà del sink in questa pagina.

Quote e limiti

Cloud Trace utilizza l' API BigQuery Streaming per inviare gli intervalli di traccia alla destinazione. Cloud Trace esegue il batch delle chiamate API. Cloud Trace non implementa un meccanismo di ripetizione o limitazione. Gli intervalli di Trace potrebbero non essere esportati correttamente se la quantità di dati supera le quote di destinazione.

Per informazioni dettagliate su quote e limiti di BigQuery, consulta Quote e limiti.

Prezzi

L'esportazione delle tracce non comporta addebiti di Cloud Trace. Tuttavia, potresti incorrere in addebiti di BigQuery. Per ulteriori informazioni, consulta Prezzi di BigQuery.

Stima dei costi

BigQuery addebita un costo per l'importazione e l'archiviazione dei dati. Per stimare i costi mensili di BigQuery:

1. Stima il numero totale di intervalli di traccia importati in un mese.

   Per informazioni su come visualizzare l'utilizzo, consulta Visualizzare l'utilizzo per account di fatturazione.

2. Stima i requisiti di streaming in base al numero di intervalli di traccia importati.

   Ogni intervallo viene scritto in una riga della tabella. Ogni riga in BigQuery richiede almeno 1024 byte. Pertanto, un limite inferiore per i requisiti di streaming di BigQuery è assegnare 1024 byte a ogni intervallo. Ad esempio, se il tuo Google Cloud progetto ha importato 200 span, questi richiedono almeno 20.400 byte per l'inserimento di flussi di dati.

3. Utilizza il Calcolatore prezzi per stimare i costi di BigQuery dovuti ad archiviazione, inserimenti di streaming e query.

Visualizzare e gestire l'utilizzo di BigQuery

Puoi utilizzare Metrics Explorer per visualizzare l'utilizzo di BigQuery. Puoi anche creare una criterio di avviso che ti invii una notifica se l'utilizzo di BigQuery supera i limiti predefiniti. La tabella seguente contiene le impostazioni per creare una criterio di avviso. Puoi utilizzare le impostazioni nella tabella del riquadro di destinazione quando crei un grafico o utilizzi Esplora metriche.

BigQuery

Passaggi per creare una policy di avviso.

Per creare una criterio di avviso, segui questi passaggi:

1. Nella Google Cloud console, vai alla  pagina Avvisi:

   Vai ad Avvisi

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. Se non hai creato i canali di notifica e vuoi ricevere le notifiche, fai clic su Modifica canali di notifica e aggiungi i tuoi canali di notifica. Torna alla pagina Avvisi dopo aver aggiunto i canali.
3. Nella pagina Avvisi, seleziona Crea policy.
4. Per selezionare la risorsa, la metrica e i filtri, espandi il menu Seleziona una metrica e poi utilizza i valori nella tabella Nuova condizione:
   1. (Facoltativo) Per limitare il menu alle voci pertinenti, inserisci il nome della risorsa o della metrica nella barra dei filtri.
   2. Seleziona un tipo di risorsa. Ad esempio, seleziona Istanza VM.
   3. Seleziona una categoria di metriche. Ad esempio, seleziona istanza.
   4. Seleziona una metrica. Ad esempio, seleziona Utilizzo CPU.
   5. Seleziona Applica.
5. Fai clic su Avanti e poi configura il trigger criterio di avviso. Per completare questi campi, utilizza i valori nella tabella Configura trigger di avviso.
6. Fai clic su Avanti.

7. (Facoltativo) Per aggiungere notifiche alla tua policy di avviso, fai clic su Canali di notifica. Nella finestra di dialogo, seleziona uno o più canali di notifica dal menu e fai clic su Ok.

   Per ricevere una notifica quando gli incidenti vengono aperti e chiusi, seleziona Invia notifica alla chiusura dell'incidente. Per impostazione predefinita, le notifiche vengono inviate solo quando gli incidenti vengono aperti.

8. (Facoltativo) Aggiorna la Durata della chiusura automatica degli incidenti. Questo campo determina quando Monitoring chiude gli incidenti in assenza di dati delle metriche.
9. (Facoltativo) Fai clic su Documentazione e aggiungi tutte le informazioni che vuoi includere in un messaggio di notifica.
10. Fai clic su Nome avviso e inserisci un nome per la policy di avviso.
11. Fai clic su Crea criterio.

Nuova condizione Campo	Valore
Risorsa e metrica	Nel menu Risorse, seleziona Set di dati BigQuery. Nel menu Categorie di metriche, seleziona Archiviazione. Seleziona una metrica dal menu Metriche. Le metriche specifiche per l'utilizzo includono Stored bytes, Uploaded bytes, e Uploaded bytes billed. Per un elenco completo delle metriche disponibili, consulta Metriche di BigQuery.
Filtro	project_id: l' Google Cloud ID progetto. dataset_id: l'ID del set di dati.
Tra le serie temporali Raggruppa serie temporali per	dataset_id: l'ID del set di dati.
Tra le serie temporali Aggregazione serie temporali	sum
Finestra temporale continua	1 m
Funzione finestra temporale continua	mean

Configura trigger di avviso Campo	Valore
Tipo di condizione	Threshold
Trigger di avviso	Any time series violates
Posizione soglia	Above threshold
Valore di soglia	Sei tu a determinare il valore accettabile.
Finestra di ritest	1 minute

Passaggi successivi

Per configurare un sink, consulta Esportare le tracce.