In questa pagina vengono illustrati i seguenti passaggi:
- Installare i pacchetti OpenTelemetry.
- Configura la tua applicazione per esportare gli intervalli in Cloud Trace.
- Configura la tua piattaforma.
Per informazioni sulla release, consulta le pagine seguenti:
Per i contenuti di riferimento di OpenTelemetry, vedi quanto segue:
Per i dettagli più recenti su OpenTelemetry per C++, insieme alla documentazione e agli esempi aggiuntivi, consulta OpenTelemetry.
Prima di iniziare
Attiva l'API richiesta.
Installare i pacchetti OpenTelemetry
- Configura un ambiente di sviluppo C++.
- Installa la libreria di esportazione OpenTelemetry C++ di Google Cloud. Per informazioni sull'installazione, consulta la guida rapida di OpenTelemetry.
Configura l'esportazione di intervalli in Cloud Trace
Per configurare l'esportazione dei dati di traccia, chiama il metodo google::cloud::otel::ConfigureBasicTracing(...)
nel tuo metodo main()
:
Il campo project_id
è il progetto Google Cloud in cui vuoi archiviare le tracce.
Il metodo ConfigureBasicTracing(...)
crea un'istanza 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 frequenza di campionamento
Le applicazioni potrebbero generare un grande volume di dati di traccia. Il seguente esempio illustra come configurare la frequenza di campionamento:
Esporta 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 intervalli di traccia, consulta OpenTelemetry Tracciamento. In questa pagina viene descritto come effettuare tutte le seguenti operazioni:
- Crea un intervallo
- Crea intervalli nidificati
- Imposta attributi intervallo
- Creare intervalli con eventi
- Creare intervalli con link
Applicazione di esempio
Per un'applicazione di esempio, consulta la quickstart.
Configura la tua piattaforma
Puoi utilizzare Cloud Trace su Google Cloud e altre piattaforme.
In esecuzione su Google Cloud
Quando la tua applicazione è in esecuzione su Google Cloud, non è necessario fornire alla libreria client le credenziali di autenticazione sotto forma di account di servizio. Tuttavia, devi assicurarti che l'ambito di accesso all'API Cloud Trace sia abilitato per la tua piattaforma Google Cloud.
Per un elenco degli ambienti Google Cloud supportati, consulta la pagina relativa all'assistenza per gli ambienti.
Per le seguenti configurazioni, le impostazioni predefinite dell'ambito di accesso abilitano 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 all'API Cloud Trace sia abilitato:
Per informazioni su come configurare gli ambiti di accesso per il tuo ambiente utilizzando la console Google Cloud, consulta Configurazione del progetto Google Cloud.
Per gli utenti
gcloud
, specifica gli ambiti di accesso utilizzando il flag--scopes
e includi l'ambito di accesso all'Cloud Trace APItrace.append
. Ad esempio, per creare un cluster GKE in cui è abilitata solo l'Cloud Trace API:gcloud container clusters create example-cluster-name --scopes=https://www.googleapis.com/auth/trace.append
Esecuzione in locale e altrove
Se la tua applicazione viene eseguita al di fuori di Google Cloud, devi fornire alla libreria client le credenziali di autenticazione sotto forma di account di servizio. L'account di servizio deve contenere il ruolo agente Cloud Trace. Per le istruzioni, vedi Creazione di 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 uno dei tre modi seguenti:
Esegui
gcloud auth application-default login
Inserisci l'account di servizio in un percorso predefinito per il tuo 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 al 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 traccia:
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'utilità di esportazione Cloud Trace C++, consulta la sezione Risoluzione dei problemi della documentazione di riferimento.
Risorse
- https://opentelemetry.io/
- open-telemetry/opentelemetry-cpp Repository GitHub
- Libreria OpenTelemetry Exporters di google-cloud-cpp Repository GitHub.