Questa pagina ti guida nei seguenti passaggi:
- Installa i pacchetti OpenTelemetry.
- Configura l'applicazione per esportare gli span in Cloud Trace.
- Configura la tua piattaforma.
Per informazioni sulle release, consulta quanto segue:
Per i contenuti di riferimento di OpenTelemetry, consulta quanto segue:
Per i dettagli più recenti su OpenTelemetry per C++, insieme a documentazione ed esempi aggiuntivi, consulta OpenTelemetry.
Prima di iniziare
Enable the Cloud Trace API.
Installa i pacchetti OpenTelemetry
- Configura un ambiente di sviluppo C++.
- Installa la libreria dell'esportatore OpenTelemetry di Google Cloud per C++. Per informazioni sull'installazione, consulta la guida rapida di OpenTelemetry.
Configurare l'esportazione degli span in Cloud Trace
Per configurare l'esportazione dei dati di traccia, chiama il metodo google::cloud::otel::ConfigureBasicTracing(...)
nel metodo main()
:
Il campo project_id
è il progetto Google Cloud in cui vuoi archiviare le tracce.
Il metodo ConfigureBasicTracing(...)
esegue l'inizializzazione di un oggetto
TracerProvider
che implementa un esportatore Cloud Trace. Se l'oggetto restituito dalla chiamata a
ConfigureBasicTracing(...)
esce dall'ambito, l'oggetto
TracerProvider
precedente viene reintegrato, se esistente.
Configura la frequenza di campionamento
Le applicazioni potrebbero generare un volume elevato di dati traccia. L'esempio seguente illustra come configurare la frequenza di campionamento:
Esportare in Cloud Trace con un TracerProvider
personalizzato
Potresti avere casi d'uso che richiedono un oggetto TracerProvider
personalizzato. Ad esempio, se vuoi utilizzare più esportatori contemporaneamente, devi creare un oggetto TracerProvider
personalizzato. In questi casi, puoi utilizzare direttamente l'esportatore Cloud Trace:
Instrumenta la tua applicazione
Per informazioni su come configurare l'applicazione per acquisire gli span di traccia, consulta Monitoraggio delle tracce OpenTelemetry. Questa pagina descrive come eseguire tutte le seguenti operazioni:
- Creare un intervallo
- Creare intervalli nidificati
- Imposta gli attributi dell'intervallo
- Creare intervalli con eventi
- Creare intervalli con link
Applicazione di esempio
Per un'applicazione di esempio, consulta la guida rapida.
Configura la tua piattaforma
Puoi utilizzare Cloud Trace su Google Cloud e su altre piattaforme.
In esecuzione su Google Cloud
Quando l'applicazione è in esecuzione su Google Cloud, non è necessario fornire le credenziali di autenticazione sotto forma di account di servizio alla libreria client. Tuttavia, devi assicurarti che sulla tua piattaforma Google Cloud sia attivato lo scopo di accesso dell'API Cloud Trace.
Per un elenco degli ambienti Google Cloud supportati, consulta Supporto dell'ambiente.
Per le seguenti configurazioni, le impostazioni dell'ambito di accesso predefinite attivano l'Cloud Trace API:
- Ambiente flessibile di App Engine
Ambiente standard di App Engine
Google Kubernetes Engine (GKE)
Compute Engine
Cloud Run
Se utilizzi ambiti di accesso personalizzati, devi assicurarti che l'ambito di accesso dell'API Cloud Trace sia abilitato:
Per informazioni su come configurare gli ambiti di accesso per il tuo ambiente utilizzando la console Google Cloud, consulta Configurare il progetto Google Cloud.
Per gli utenti
gcloud
, specifica gli ambiti di accesso utilizzando il flag--scopes
e includi l'ambito di accesso dell'Cloud Trace APItrace.append
. Ad esempio, per creare un cluster GKE con solo l'Cloud Trace API abilitata, procedi nel seguente modo:gcloud container clusters create example-cluster-name --scopes=https://www.googleapis.com/auth/trace.append
Esecuzione locale e altrove
Se la tua applicazione è in esecuzione al di fuori di Google Cloud, devi fornire le credenziali di autenticazione sotto forma di account di servizio alla libreria client. L'account di servizio deve contenere il ruolo Agente Cloud Trace. Per le istruzioni, vedi Creare un account di servizio.
Le librerie client di Google Cloud utilizzano le credenziali predefinite dell'applicazione (ADC) per trovare le credenziali della tua applicazione.
Puoi fornire queste credenziali in tre modi:
Esegui
gcloud auth application-default login
Posiziona l'account di servizio in un percorso predefinito per il sistema operativo. Di seguito sono elencati i percorsi predefiniti per Windows e Linux:
Windows:
%APPDATA%/gcloud/application_default_credentials.json
Linux:
$HOME/.config/gcloud/application_default_credentials.json
Imposta la variabile di ambiente
GOOGLE_APPLICATION_CREDENTIALS
sul percorso del tuo account di servizio:
Linux/macOS
export GOOGLE_APPLICATION_CREDENTIALS=path-to-your-service-accounts-private-key
Windows
set GOOGLE_APPLICATION_CREDENTIALS=path-to-your-service-accounts-private-key
PowerShell:
$env:GOOGLE_APPLICATION_CREDENTIALS="path-to-your-service-accounts-private-key"
Visualizza tracce
Nella console Google Cloud, vai alla pagina Esplora tracce.
Puoi trovare questa pagina anche utilizzando la barra di ricerca.
Risoluzione dei problemi
Per informazioni sulla risoluzione dei problemi relativi a Cloud Trace, vai alla pagina Risoluzione dei problemi.
Per eseguire il debug dell'esportatore di Cloud Trace in C++, consulta la sezione Risoluzione dei problemi della documentazione di riferimento.
Risorse
- https://opentelemetry.io/
- open-telemetry/opentelemetry-cpp Repository GitHub
- libreria degli esportatori OpenTelemetry google-cloud-cpp nel repository GitHub.