Questa pagina è stata tradotta dall'API Cloud Translation.

Configurare 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 devi 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.

Nota: il controllo semantico sul formato della destinazione è limitato. Ad esempio, se ometti DATASET_ID quando invii un comando di creazione, il comando di creazione non ha esito negativo, ma le tracce non vengono esportate correttamente.

Gli esempi di curl utilizzano le seguenti variabili di ambiente:

ACCESS_TOKEN: memorizza il token di autorizzazione. Per ulteriori informazioni, vedi Utilizzare curl.
PROJECT_ID: memorizza l'identificatore o il numero di 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:

Crea il set di dati di destinazione.
Crea il sink utilizzando l'Cloud Trace API o Google Cloud CLI. Per maggiori dettagli, vedi Creare un sink.
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à writer 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 Google Cloud progetto 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

Per elencare i sink definiti con il progetto predefinito utilizzando Google Cloud CLI, esegui questo comando:

gcloud alpha trace sinks list

Protocollo

Per elencare i sink utilizzando curl, invia una richiesta GET a:

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

Ad esempio, la seguente richiesta recupera tutti i lavandini:

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

Mostrare 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

Per visualizzare i dettagli del sink il cui identificatore è archiviato in SINK_ID utilizzando Google Cloud CLI, esegui questo comando:

gcloud alpha trace sinks describe ${SINK_ID}

Protocollo

Per visualizzare i dettagli del sink il cui identificatore è memorizzato in SINK_ID utilizzando curl, invia una richiesta GET a:

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

Ad esempio, la seguente richiesta recupera i dettagli del sink specificato:

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 Creazione di set di dati per informazioni sulla creazione di set di dati BigQuery.

gcloud

Per creare un sink utilizzando Google Cloud CLI, esegui questo comando:

gcloud alpha trace sinks create ${SINK_ID} ${DESTINATION}

Protocollo

Per creare un sink utilizzando curl, invia una richiesta POST a:

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

Ad esempio, per creare un sink denominato test_sink per esportare gli span di traccia in test_dataset nel progetto con ${PROJECT_NUMBER}, definisci la variabile di ambiente SINK_BODY come mostrato:

SINK_BODY='{"name":"projects/12345/traceSinks/test_sink","output_config":{"destination":"bigquery.googleapis.com/projects/12345/datasets/test_dataset"}}'

Per creare il sink, esegui questo comando:

curl --http1.1 --header "Authorization: Bearer ${ACCESS_TOKEN}"  --header "Content-Type: application/json"  -X POST -d ${SINK_BODY} https://cloudtrace.googleapis.com/v2beta1/projects/${PROJECT_NUMBER}/traceSinks

Potrebbero essere necessari diversi minuti dopo la creazione di un sink prima che gli span di traccia vengano esportati nella destinazione.

Eliminazione di un sink

Per eliminare un sink che si trova nel tuo progetto Google Cloud , richiama il comando traceSinks.delete.

gcloud

Per eliminare il sink il cui identificatore è memorizzato in SINK_ID utilizzando Google Cloud CLI, esegui questo comando:

gcloud alpha trace sinks delete ${SINK_ID}

Protocollo

Per eliminare il sink il cui identificatore è memorizzato in SINK_ID utilizzando curl, invia una richiesta DELETE a:

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

Ad esempio, la seguente richiesta elimina un sink:

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

Aggiornamento di un sink

Per aggiornare un sink nel tuo progetto Google Cloud , richiama il comando traceSinks.patch.

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

gcloud

Per aggiornare il sink il cui identificatore è archiviato in SINK_ID utilizzando Google Cloud CLI, esegui il seguente comando:

gcloud alpha trace sinks update ${SINK_ID} ${DESTINATION}

La variabile di ambiente DESTINATION memorizza la nuova destinazione del sink.

Protocollo

Per aggiornare la destinazione del sink il cui identificatore è memorizzato in SINK_ID utilizzando curl, invia una richiesta PATCH a:

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

Ad esempio, la seguente richiesta aggiorna la destinazione di un sink:

curl --http1.1 --header "Authorization: Bearer ${ACCESS_TOKEN}"  --header "Content-Type: application/json"  -X PATCH -d ${SINK_BODY} https://cloudtrace.googleapis.com/v2beta1/projects/${PROJECT_NUMBER}/traceSinks/${SINK_ID}?update_mask=output_config.destination

Per un esempio di SINK_BODY, vedi l'esempio per creare un sink.

Potrebbero essere necessari diversi minuti dopo l'aggiornamento di un sink prima che gli span di traccia vengano esportati nella nuova destinazione.

Esempio end-to-end

Questa sezione illustra l'utilizzo dei comandi Google Cloud CLI per elencare, creare, descrivere, aggiornare ed eliminare un sink. I comandi sono stati eseguiti per un progetto con l'identificatore di progetto a-sample-project. Questo progetto è stato preconfigurato per contenere due set di dati BigQuery. Infine, in questi esempi, il sink e la destinazione si trovano nello stesso progetto. Questo non è un requisito. Il sink e la destinazione possono trovarsi in progettiGoogle Cloud diversi.

Passaggi di configurazione

Verifica l'impostazione del progetto predefinito:

$ gcloud config list

Esempio di risposta:

[compute]
zone = us-east1-b
[core]
account = user@example.com
disable_usage_reporting = True
project = a-sample-project

Your active configuration is: [default]

Verifica che Google Cloud CLI sia almeno alla versione 274.0.0:

$ gcloud --version

Esempio di risposta:

Google Cloud SDK 275.0.0
alpha 2020.01.03
beta 2020.01.03
bq 2.0.51
core 2020.01.03
gsutil 4.46
kubectl 2020.01.03

Identifica i set di dati disponibili nel progetto predefinito:
```
$ bq ls
```
Esempio di risposta:
```
    datasetId
 ---------------
  dataset_1
  dataset_other
```
Tieni presente che la prima volta che utilizzi i comandi bq, potresti dover selezionare il progetto.

Configura le variabili di ambiente

Imposta le variabili di ambiente utilizzate dal comando Google Cloud CLI:
```
$ PROJECT_ID=a-sample-project
$ PROJECT_NUMBER=123456789000
$ SINK_ID=a-sample-sink
$ DATA_SET_NAME=dataset_1
$ DESTINATION=bigquery.googleapis.com/projects/${PROJECT_NUMBER}/datasets/${DATA_SET_NAME}
```
In questo esempio, la destinazione e il sink si trovano nello stesso progetto. Questo non è un requisito. Il sink e la destinazione possono trovarsi in progettiGoogle Cloud diversi.

Verifica le impostazioni:

$ echo $SINK_ID
a-sample-sink
$ echo $DATA_SET_NAME
dataset_1
$ echo $DESTINATION
bigquery.googleapis.com/projects/123456789000/datasets/dataset_1

Elenca sink

Per elencare tutti i sink, esegui questo comando:

$ gcloud alpha trace sinks list

Poiché questo progetto non ha sink, la risposta è:

Listed 0 items.

Creazione di un sink

Per creare un sink, esegui questo comando:
```
$ gcloud alpha trace sinks create ${SINK_ID} ${DESTINATION}
```
Esempio di risposta:
```
You can give permission to the service account by running the following command.
gcloud projects add-iam-policy-binding bigquery-project \
--member serviceAccount:export-0000001cbe991a08-3434@gcp-sa-cloud-trace.iam.gserviceaccount.com \
--role roles/bigquery.dataEditor
```
Tieni presente che il nome del account di servizio include export-0000001cbe991a08-3434. Il numero 0000001cbe991a08 è la rappresentazione esadecimale di PROJECT_NUMBER. Il valore 3434 è un valore casuale.

Prima di eseguire Google Cloud CLI nella risposta precedente, devi sostituire bigquery-project con l'identificatore del progetto.

Verifica che il sink sia stato creato:

$ gcloud alpha trace sinks list

Esempio di risposta:

NAME           DESTINATION                                                       WRITER_IDENTITY
a-sample-sink  bigquery.googleapis.com/projects/123456789000/datasets/dataset_1  export-0000001cbe991a08-3434@gcp-sa-cloud-trace.iam.gserviceaccount.com

Descrivi il lavello in dettaglio:

$ gcloud alpha trace sinks describe ${SINK_ID}

Esempio di risposta:

destination: bigquery.googleapis.com/projects/123456789000/datasets/dataset_1
name: a-sample-sink
writer_identity: export-0000001cbe991a08-3434@gcp-sa-cloud-trace.iam.gserviceaccount.com

Concedi l'autorizzazione bigquery.dataEditor all'identità di scrittura del sink. Il comando di creazione del sink restituisce un comando Google Cloud CLI che puoi utilizzare per aggiornare l'autorizzazione.

Affinché questo comando vada a buon fine, esegui le seguenti operazioni:
- Assicurati di disporre dell'autorizzazione per modificare le autorizzazioni della destinazione.
- Sostituisci bigquery-project con l'identificatore del tuo progetto:
```
gcloud projects add-iam-policy-binding ${PROJECT_ID} --member serviceAccount:export-0000001cbe991a08-3434@gcp-sa-cloud-trace.iam.gserviceaccount.com --role roles/bigquery.dataEditor
```
Tieni presente che la prima voce di questa risposta di esempio è l'identità del writer del sink:

    Updated IAM policy for project [a-sample-project].
    bindings:
    - members:
      - serviceAccount:export-0000001cbe991a08-3434@gcp-sa-cloud-trace.iam.gserviceaccount.com
      role: roles/bigquery.dataEditor
    - members:
      - user:user@example.com
      role: roles/cloudtrace.admin
    - members:
      - serviceAccount:service-123456789000@compute-system.iam.gserviceaccount.com
      role: roles/compute.serviceAgent
    - members:
      - serviceAccount:service-123456789000@container-engine-robot.iam.gserviceaccount.com
      role: roles/container.serviceAgent
    - members:
      - serviceAccount:service-123456789000@container-analysis.iam.gserviceaccount.com
      role: roles/containeranalysis.ServiceAgent
    - members:
      - serviceAccount:service-123456789000@containerregistry.iam.gserviceaccount.com
      role: roles/containerregistry.ServiceAgent
    - members:
      - serviceAccount:123456789000-compute@developer.gserviceaccount.com
      - serviceAccount:123456789000@cloudservices.gserviceaccount.com
      role: roles/editor
    - members:
      - user:user@example.com
      role: roles/owner
    etag: BwWbqGVnShQ=
    version: 1

Modificare la destinazione del sink

In questo esempio, la destinazione viene modificata da dataset_1 a dataset_other:

Aggiorna le variabili di ambiente DATA_SET_NAME e DESTINATION:

$ DATA_SET_NAME=dataset_other
$ DESTINATION=bigquery.googleapis.com/projects/${PROJECT_NUMBER}/datasets/${DATA_SET_NAME}
$ echo ${DESTINATION}
bigquery.googleapis.com/projects/123456789000/datasets/dataset_other

Assicurati di aggiornare il valore di DESTINATION dopo aver modificato DATA_SET_NAME o PROJECT_NUMBER.

Modifica la destinazione del sink:

$ gcloud alpha trace sinks update ${SINK_ID} ${DESTINATION}

Un output di esempio è:

Updated [https://cloudtrace.googleapis.com/v2beta1/projects/123456789000/traceSinks/a-sample-sink].
destination: bigquery.googleapis.com/projects/123456789000/datasets/dataset_other
name: a-sample-sink
writer_identity: export-0000001cbe991a08-3434@gcp-sa-cloud-trace.iam.gserviceaccount.com

Esegui il comando describe per visualizzare i dettagli del sink:

$ gcloud alpha trace sinks describe ${SINK_ID}
destination: bigquery.googleapis.com/projects/123456789000/datasets/dataset_other
name: a-sample-sink
writer_identity: export-0000001cbe991a08-3434@gcp-sa-cloud-trace.iam.gserviceaccount.com

Quando aggiorni la destinazione di un sink, non modifichi l'identità del writer del sink e pertanto non devi aggiornare le autorizzazioni per il sink.

Eliminazione di un sink

Per eliminare un sink, esegui questo comando:

$ gcloud alpha trace sinks delete ${SINK_ID}

L'output di esempio è:

Really delete sink [a-sample-sink]?

Do you want to continue (y/N)? y

Deleted [https://cloudtrace.googleapis.com/v2beta1/projects/123456789000/traceSinks/a-sample-sink].

Puoi verificare il risultato eseguendo il comando list:

$ gcloud alpha trace sinks list
Listed 0 items.

Convalida

Puoi utilizzare la metrica exported_span_count di Cloud Monitoring come base per un grafico che mostra gli errori quando i dati di Trace vengono esportati in BigQuery. Puoi anche creare un criterio di avviso per ricevere una notifica in caso di errori di esportazione.

Creare un grafico

Per visualizzare le metriche per una risorsa monitorata con Esplora metriche, segui questi passaggi:

Nella console Google Cloud , vai alla pagina Esplora metriche:
Vai a Esplora metriche

Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.
Nella barra degli strumenti della console Google Cloud , seleziona il tuo progetto Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.
Nell'elemento Metrica, espandi il menu Seleziona una metrica, digita Spans Exported to BigQuery nella barra dei filtri e poi utilizza i sottomenu per selezionare un tipo di risorsa e una metrica specifici:
1. Nel menu Risorse attive, seleziona Cloud Trace.
2. Nel menu Categorie di metriche attive, seleziona Bigquery_explort.
3. Nel menu Metriche attive, seleziona Span esportati in BigQuery.
4. Fai clic su Applica.
Per aggiungere filtri, che rimuovono le serie temporali dai risultati della query, utilizza l'elemento Filtro.

Configura la modalità di visualizzazione dei dati.

Lascia vuoto l'elemento Filtro. Con questa scelta, il grafico mostra tutti i dati di stato.

Nell'elemento Aggregazione, imposta il primo menu su Media e il secondo su status.

Queste selezioni generano una singola serie temporale per ogni valore di stato univoco. La tabella seguente mostra i possibili valori dello stato:

Valore Stato	Significato e azione correttiva
`ok`	Il trasferimento dei dati è stato completato.
`bigquery_permission_denied`	L'esportazione dei dati nella destinazione non è riuscita. L'esportazione può non riuscire per uno dei seguenti motivi: L'account di servizio nel sink di traccia non dispone dell'autorizzazione di scrittura nel set di dati di destinazione. Vedi Autorizzazione negata. La destinazione del set di dati nel sink non esiste. Consulta Destinazione non valida. Errori interni di BigQuery. Si tratta di un errore imprevisto e transitorio.
`bigquery_quota_exceeded`	Il progetto BigQuery ha superato la quota di streaming BigQuery. Consulta la sezione Quota esaurita.
`invalid_span internal_errors` `invalid_destination`	Errore sconosciuto che impedisce l'esportazione dei dati in BigQuery. Per risolvere questo problema, contatta l'assistenza tecnica o poni una domanda su Stack Overflow. Per informazioni, vedi Richiedere assistenza.

Per ulteriori informazioni sulla configurazione di un grafico, consulta Seleziona le metriche durante l'utilizzo di Esplora metriche.

Se il sink di Trace esporta correttamente i dati, il grafico creato con le impostazioni precedenti mostra una singola serie temporale con il valore di stato ok. Se si verificano errori durante l'esportazione, nel grafico vengono visualizzate ulteriori serie temporali.

Creazione di un criterio di avviso

Per creare un criterio di avviso che si attiva se si verificano errori durante l'esportazione dei dati di Cloud Trace in BigQuery, utilizza le seguenti impostazioni.

Passaggi per creare un criterio di avviso.

Per creare un criterio di avviso, segui questi passaggi:

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.
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.
Nella pagina Avvisi, seleziona Crea criterio.
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.
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.
Fai clic su Avanti.
(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.
(Facoltativo) Aggiorna la Durata chiusura automatica incidenti. Questo campo determina quando Monitoring chiude gli incidenti in assenza di dati delle metriche.
(Facoltativo) Fai clic su Documentazione e aggiungi tutte le informazioni che vuoi includere in un messaggio di notifica.
Fai clic su Nome avviso e inserisci un nome per il criterio di avviso.
Fai clic su Crea criterio.

Nuova condizione Campo	Valore
Risorsa e metrica	Nel menu Risorse, seleziona Cloud Trace. Nel menu Categorie di metriche, seleziona Bigquery_export. Nel menu Metriche, seleziona Span esportati in BigQuery.
Filtro	`status != ok`
Tra le serie temporali Raggruppa serie temporali per	`status`
Tra le serie temporali Aggregazione serie temporali	`sum`
Finestra temporale continua	`1 m`
Funzione finestra temporale continua	`rate`

Configura trigger di avviso Campo	Valore
Tipo di condizione	`Threshold`
Trigger avviso	`Any time series violates`
Posizione soglia	`Above threshold`
Valore soglia	`0`
Finestra di ripetizione test	`1 minute`

Utilizzo di curl

Questa sezione descrive le convenzioni e la configurazione utilizzate per richiamare l'Cloud Trace API utilizzando lo strumento curl:

Autenticazione

Crea una variabile di ambiente in cui inserire l'identificatore del progetto: Google Cloud
```
PROJECT_ID=my-project
```
Crea una variabile di ambiente in cui inserire il numero del progetto: Google Cloud
```
PROJECT_NUMBER=12345
```
Autentica Google Cloud CLI:
```
gcloud auth login
```
Imposta l'identificatore di progetto Google Cloud predefinito:
```
gcloud config set project ${PROJECT_ID}
```
Crea un token di autorizzazione e salvalo in una variabile di ambiente:
```
ACCESS_TOKEN=`gcloud auth print-access-token`
```
Verifica il token di accesso:
```
echo ${ACCESS_TOKEN}
```
La risposta al comando deve essere una lunga stringa di caratteri. Ad esempio, su un sistema, la risposta inizia come segue:
```
y29.GluiBjo....
```

Richiamo di `curl`

Ogni comando curl include un insieme di argomenti, seguito dall'URL di una risorsa dell'Cloud Trace API. Gli argomenti comuni includono i valori specificati dalle variabili di ambiente PROJECT_ID e ACCESS_TOKEN.

Ogni chiamata curl ha il seguente formato generale:

curl --http1.1 --header "Authorization: Bearer ${ACCESS_TOKEN}" [OTHER_ARGS]
https://cloudtrace.googleapis.com/[API_VERSION]/projects/${PROJECT_ID}/[RESOURCE]

dove:

[OTHER_ARGS] (facoltativo): ometti questo campo se stai inviando una richiesta GET. Per altri tipi di richieste HTTP, sostituisci questo segnaposto con il tipo di richiesta e tutti i dati aggiuntivi necessari per soddisfare la richiesta.
[API_VERSION]: specifica la versione dell'API.
[RESOURCE]: specifica il nome della risorsa Cloud Trace API.

Ad esempio, per elencare le 1000 tracce più recenti nel tuo progetto, esegui questo comando:

curl --http1.1 --header "Authorization: Bearer ${ACCESS_TOKEN}" https://cloudtrace.googleapis.com/v1/projects/${PROJECT_ID}/traces

Risoluzione dei problemi

Questa sezione contiene informazioni per la risoluzione dei problemi che potrebbero aiutarti a risolvere gli errori durante la configurazione di un'esportazione.

Errore relativo a un argomento non valido per il set di dati

Il seguente messaggio di errore indica che il nome del set di dati non è valido:

ERROR: (gcloud.alpha.trace.sinks.create) INVALID_ARGUMENT: Request contains an invalid argument.
- '@type': type.googleapis.com/google.rpc.DebugInfo
  detail: '[ORIGINAL ERROR] generic::invalid_argument: sink destination is malformed:
    bigquery.googleapis.com/projects/123456789000/datasets/a-sample-project:dataset_1.

L'errore è causato dalla destinazione che include l' Google Cloud identificatore del progetto, a-sample-project, come qualificatore del nome del set di dati.

Per risolvere questo errore, sostituisci a-sample-project:dataset_1 con dataset_1 e poi esegui il comando create.

Tieni presente che puoi elencare i tuoi set di dati con il comando bq ls.

Nessun dato di traccia viene ricevuto

Esistono diversi motivi per cui potresti non ricevere dati di traccia in BigQuery.

Destinazione non valida

Verifica che il nome del set di dati e il numero di progetto siano corretti.

Per verificare che il nome del set di dati sia corretto. Per elencare i set di dati nel tuo progetto attuale, esegui bq ls.

Se hai scelto di utilizzare le variabili di ambiente, verifica che il valore di ciascuna variabile sia corretto eseguendo un comando echo. Ad esempio, verifica che la destinazione sia corretta:
```
$ echo ${DESTINATION}
bigquery.googleapis.com/projects/123456789000/datasets/dataset_other
```
Poiché DESTINATION dipende dal valore di PROJECT_NUMBER e DATA_SET_NAME, queste due variabili devono essere impostate per prime. Inoltre, se modifichi una di queste due variabili, devi aggiornare il valore memorizzato in DESTINATION.
Per determinare il numero dei tuoi progetti attuali, esegui questo comando:
```
gcloud projects list --filter="${PROJECT_ID}"
```
Puoi impostare PROJECT_NUMBER in modo programmatico utilizzando il seguente comando:
```
$ PROJECT_NUMBER=`gcloud projects list --filter="${PROJECT_ID}" --format="value(PROJECT_NUMBER)"`
```

Autorizzazioni non valide

Verifica che al account di servizio sia stato concesso il ruolo DataEditor per BigQuery. Puoi verificare le autorizzazioni eseguendo il seguente comando:

$ gcloud projects get-iam-policy ${PROJECT_ID}

La risposta di questo comando descrive tutti i binding IAM. In questo caso, il risultato è quello mostrato. Tieni presente che l'identità del writer del sink ha il ruolo di dataEditor:

bindings:
- members:
  - serviceAccount:export-0000001cbe991a08-3434@gcp-sa-cloud-trace.iam.gserviceaccount.com
  role: roles/bigquery.dataEditor
- members:
  [Note, content truncated]

Quota esaurita

Se ricevi dati e improvvisamente si interrompono o i dati sono incompleti, potresti aver esaurito la quota di streaming di BigQuery. Per visualizzare la tua quota, vai alla pagina IAM e amministrazione e seleziona Quote. Cerca l'API BigQuery. Esistono due voci pertinenti: Righe di streaming al minuto per risorsa, Byte di streaming al minuto per risorsa.

Vai a Quote

Passaggi successivi

Per informazioni sullo schema di BigQuery, consulta Esportazione in BigQuery.

Configurare le esportazioni Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Terminologia

Configurazione della destinazione

Elenco dei sink

gcloud

Protocollo

Mostrare i dettagli di un sink specifico

gcloud

Protocollo

Creazione di un sink

gcloud

Protocollo

Eliminazione di un sink

gcloud

Protocollo

Aggiornamento di un sink

gcloud

Protocollo

Esempio end-to-end

Passaggi di configurazione

Configura le variabili di ambiente

Elenca sink

Creazione di un sink

Modificare la destinazione del sink

Eliminazione di un sink

Convalida

Creare un grafico

Creazione di un criterio di avviso

Passaggi per creare un criterio di avviso.

Utilizzo di curl

Autenticazione

Richiamo di curl

Risoluzione dei problemi

Errore relativo a un argomento non valido per il set di dati

Nessun dato di traccia viene ricevuto

Destinazione non valida

Autorizzazioni non valide

Quota esaurita

Passaggi successivi

Configurare le esportazioni

Richiamo di `curl`