Panoramica delle esportazioni dei dati di Trace

Beta

Questo prodotto o questa funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione 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 saperne di più, 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 tracciamento per un periodo più lungo del periodo di conservazione predefinito di 30 giorni.

• Per consentirti di utilizzare gli strumenti BigQuery per analizzare i dati delle tracce. 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.

  

Come funzionano le esportazioni

L'esportazione prevede la creazione di un sink per un progetto Google Cloud . 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 del sink

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

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

  "projects/PROJECT_NUMBER/traceSinks/my-sink"
  

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

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

  "projects/PROJECT_ID"
  

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

• 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 Google Cloud del sink o qualsiasi altro progetto Google Cloud che si trova nella stessa organizzazione.

  Ad esempio, una destinazione valida è:

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

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

• Identità writer: 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 maggiore sicurezza, i nuovi sink ricevono un account di servizio unico:

  [e-mail]
  

  dove PROJECT_NUMBER è il numero del tuo progetto Google Cloud , in 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 ilaccount di serviziot richiesto dal sink. Questo account di servizio non è incluso nell'elenco dei service account per il tuo progetto finché non ha almeno un binding Identity and Access Management. Aggiungi questo binding quando configuri una destinazione sink.

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

Come funzionano i sink

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

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
• Utente Trace
• Proprietario progetto
• Editor progetto

Per ulteriori informazioni, consulta Controllo dell'accesso.

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à degli autori, consulta Proprietà del sink in questa pagina.

Quote e limiti

Cloud Trace utilizza l'API BigQuery Streaming per inviare gli span di traccia alla destinazione. L'API Cloud Trace raggruppa le chiamate API. Cloud Trace non implementa un meccanismo di throttling o di nuovi tentativi. 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 la sezione Quote e limiti.

Prezzi

L'esportazione delle tracce non comporta costi di Cloud Trace. Tuttavia, potresti sostenere costi di utilizzo di BigQuery. Per saperne di più, consulta la pagina 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, vedi 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 è di 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 flussi di dati e query.

Visualizzare e gestire l'utilizzo di BigQuery

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

Per creare un criterio di avviso che si attivi quando le metriche BigQuery importate superano un livello definito dall'utente, utilizza le impostazioni seguenti.

Passaggi per creare un criterio di avviso.

Per creare un 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 criterio.
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 metrica. 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 del criterio di avviso. Per completare questi campi, utilizza i valori nella tabella Configura trigger avviso.
6. Fai clic su Avanti.

7. (Facoltativo) Per aggiungere notifiche al tuo criterio 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 Notifica alla chiusura dell'incidente. Per impostazione predefinita, le notifiche vengono inviate solo quando vengono aperti gli incidenti.

8. (Facoltativo) Aggiorna la Durata chiusura automatica 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 il criterio 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 BigQuery.
Filtro	project_id: il tuo ID progetto Google Cloud . dataset_id: il tuo ID set di dati.
Tra le serie temporali Raggruppa serie temporali per	dataset_id: l'ID del tuo 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 avviso	Any time series violates
Posizione soglia	Above threshold
Valore soglia	Sei tu a determinare il valore accettabile.
Finestra di ripetizione test	1 minute

Passaggi successivi

Per configurare un sink, consulta Esportazione delle tracce.