Configura le esportazioni

Questa pagina spiega come esportare le tracce utilizzando l'Cloud Trace API e Google Cloud CLI. Devi utilizzare la versione 274.0.0 o successive di Google Cloud CLI. Per informazioni su come aggiornare Google Cloud CLI, consulta gcloud components update .

Alcuni esempi in questa pagina sono stati generati utilizzando curl. Per informazioni sulla configurazione di questo strumento, vedi Utilizzo di curl.

Per un esempio che illustra l'utilizzo dei comandi Google Cloud CLI per elencare, creare, descrivere, aggiornare ed eliminare un sink, consulta Esempio end-to-end.

Terminologia

Per semplificare gli esempi in questa pagina, sono state utilizzate variabili di ambiente.

Gli esempi di Google Cloud CLI utilizzano le seguenti variabili di ambiente:

• SINK_ID: il nome o l'identificatore del sink. Ad esempio, my-sink. Non è necessario fornire il comando completo a Google Cloud CLI, in quanto può determinare il tuo progetto Google Cloud .

• DESTINATION: memorizza il nome completo della destinazione. Deve essere un set di dati BigQuery. 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.

Gli esempi di curl utilizzano le seguenti variabili di ambiente:

• ACCESS_TOKEN: memorizza il token di autorizzazione. Per saperne di più, consulta Utilizzare curl.
• PROJECT_ID: memorizza l'identificatore o il numero del progetto Google Cloud .
• PROJECT_NUMBER: memorizza il Google Cloud numero di progetto.
• SINK_ID: il nome o l'identificatore del sink. Ad esempio, my-sink.
• SINK_BODY: memorizza la descrizione di una risorsa TraceSink. La risorsa TraceSink include un nome e la destinazione del sink. Il nome deve specificare il Google Cloud numero del progetto.
• DESTINATION: memorizza il nome completo della destinazione. Deve essere un set di dati BigQuery.

Configurazione della destinazione

Per esportare le tracce in BigQuery:

1. Crea il set di dati di destinazione.

2. Crea il sink utilizzando l'Cloud Trace API o Google Cloud CLI. Per maggiori dettagli, vedi Creare un sink.

3. Concedi al sink il ruolo dataEditor per il tuo set di dati BigQuery:

   1. Ottieni l'identità writer dal sink. Per informazioni sull'identità del writer, vedi Proprietà e terminologia del sink.

      L'identità dell'autore per un sink è inclusa nei dati di risposta al comando create. È incluso anche nei dati di risposta del comando list.

   2. Aggiungi l'identità di scrittura del sink come account di servizio al tuo set di dati BigQuery e assegnagli il ruolo di BigQuery Data Editor.

      • Per aggiungere le autorizzazioni utilizzando la console Google Cloud , consulta Controllo dell'accesso a un set di dati.

      • Per aggiungere le autorizzazioni utilizzando Google Cloud CLI, utilizza il comando add-iam-policy-binding e fornisci l'identificatore del tuo progetto Google Cloud e l'identità del writer del sink:

        gcloud projects add-iam-policy-binding ${DESTINATION_PROJECT_ID} \
          --member serviceAccount:${WRITER_IDENTITY} \
          --role roles/bigquery.dataEditor
        

        Nel comando precedente, WRITER_IDENTITY è una variabile di ambiente che memorizza l'identità del writer del sink e DESTINATION_PROJECT_ID è l'identificatore del progetto Google Cloud del set di dati BigQuery.

Elenco dei sink

Per elencare tutti i sink nel tuo progetto, Google Cloud incluse le identità di scrittura, richiama il metodo traceSinks.list.

gcloud alpha trace sinks list

https://cloudtrace.googleapis.com/v2beta1/projects/${PROJECT_NUMBER}/traceSinks

curl --http1.1 --header "Authorization: Bearer ${ACCESS_TOKEN}"  https://cloudtrace.googleapis.com/v2beta1/projects/${PROJECT_NUMBER}/traceSinks

Mostra i dettagli di un sink specifico

Per mostrare i dettagli di un sink specifico nel tuo progetto Google Cloud, richiama il metodo traceSinks.get.

gcloud alpha trace sinks describe ${SINK_ID}

https://cloudtrace.googleapis.com/v2beta1/projects/${PROJECT_NUMBER}/traceSinks/%{SINK_ID}

curl --http1.1 --header "Authorization: Bearer ${ACCESS_TOKEN}"  https://cloudtrace.googleapis.com/v2beta1/projects/${PROJECT_NUMBER}/traceSinks/${SINK_ID}

Creazione di un sink

Per creare un sink nel tuo progetto Google Cloud , richiama il metodo traceSinks.create. La destinazione di un sink deve essere un set di dati BigQuery.

Questo set di dati deve esistere prima di creare il sink. Trace non verifica l'esistenza della destinazione. Consulta