Auf dieser Seite werden Sie durch die folgenden Schritte geführt:
- Installieren Sie die OpenTelemetry-Pakete.
- Anwendung für den Export von Spans nach Cloud Trace konfigurieren
- Konfigurieren Sie Ihre Plattform.
Releaseinformationen finden Sie hier:
Informationen zu OpenTelemetry-Referenzinhalten finden Sie hier:
Aktuelle Informationen zu OpenTelemetry für C++ finden Sie sowie weitere Dokumentation und Beispiele finden Sie OpenTelemetry:
Hinweise
Cloud Trace API aktivieren.
OpenTelemetry-Pakete installieren
- Richten Sie eine C++-Entwicklungsumgebung ein.
- Installieren Sie die Google Cloud C++ OpenTelemetry-Exporter-Bibliothek. Für finden Sie unter OpenTelemetry-Kurzanleitung
Export von Spans nach Cloud Trace konfigurieren
Rufen Sie zum Konfigurieren des Exports von Trace-Daten die Methode
Methode google::cloud::otel::ConfigureBasicTracing(...)
in main()
:
Das Feld project_id
ist das Google Cloud-Projekt, in dem Sie die
Spuren.
Die Methode ConfigureBasicTracing(...)
instanziiert eine
TracerProvider
-Objekt, das
einen Cloud Trace-Exporter. Wenn das vom Aufruf an zurückgegebene Objekt
ConfigureBasicTracing(...)
geht aus dem Geltungsbereich, dann die vorherige
TracerProvider
-Objekt wird wiederhergestellt, wenn ein solches vorhanden ist.
Abtastrate konfigurieren
Anwendungen können ein großes Volumen an Trace-Daten generieren. Die folgenden Das Beispiel zeigt, wie die Abtastrate konfiguriert wird:
Mit einem benutzerdefinierten TracerProvider
nach Cloud Trace exportieren
Einige Anwendungsfälle erfordern möglicherweise ein benutzerdefiniertes TracerProvider
-Objekt. Für
Wenn Sie beispielsweise mehrere Exporter gleichzeitig verwenden möchten, müssen Sie
um ein benutzerdefiniertes TracerProvider
-Objekt zu erstellen. In diesen Fällen können Sie das
Cloud Trace-Exporter direkt ausführen:
Eigene Anwendung instrumentieren
Wie Sie Ihre Anwendung für die Erfassung von Trace-Spans konfigurieren, erfahren Sie unter OpenTelemetry-Tracing. Auf dieser Seite wird beschrieben, wie Sie die folgenden Schritte ausführen:
- Span erstellen
- Verschachtelte Spans erstellen
- Span-Attribute festlegen
- Spans mit Ereignissen erstellen
- Spans mit Links erstellen
Beispielanwendung
Eine Beispielanwendung finden Sie unter den Schnellstart.
Plattform konfigurieren
Sie können Cloud Trace in Google Cloud und auf anderen Plattformen verwenden.
In Google Cloud ausführen
Wenn Ihre Anwendung in Google Cloud ausgeführt wird, müssen Sie für die Clientbibliothek keine Anmeldedaten zur Authentifizierung in der Clientbibliothek angeben. Sie müssen jedoch sicherstellen, dass Ihre Google Cloud Platform Zugriffsbereich der Cloud Trace API aktiviert.
Eine Liste der unterstützten Google Cloud-Umgebungen finden Sie unter Umgebungsunterstützung.
Für die folgenden Konfigurationen wird die Cloud Trace API über die Standardeinstellungen für den Zugriffsbereich aktiviert:
- Flexible App Engine-Umgebung
App Engine-Standardumgebung
Google Kubernetes Engine (GKE)
Compute Engine
Cloud Run
Wenn Sie benutzerdefinierte Zugriffsbereiche verwenden, Zugriffsbereich der Cloud Trace API aktiviert ist:
Weitere Informationen zur Konfiguration des Zugriffsbereiche für Ihre Umgebung mithilfe der Google Cloud Console erstellen, finden Sie unter Google Cloud-Projekt konfigurieren
Geben Sie für
gcloud
-Nutzer mithilfe des Flags--scopes
Zugriffsbereiche an und beziehen Sie den Zugriffsbereich der Cloud Trace APItrace.append
ein. So erstellen Sie beispielsweise einen GKE-Cluster, für den nur die Cloud Trace API aktiviert ist:gcloud container clusters create example-cluster-name --scopes=https://www.googleapis.com/auth/trace.append
Lokal und extern ausführen
Wenn Ihre Anwendung außerhalb von Google Cloud ausgeführt wird, müssen Sie Anmeldedaten zur Authentifizierung in Form eines Dienstkontos für die Clientbibliothek angeben. Das Dienstkonto muss die Rolle "Cloud Trace-Agent" enthalten. Informationen dazu finden Sie unter Dienstkonto erstellen.
Google Cloud-Clientbibliotheken verwenden Standardanmeldedaten für Anwendungen für die Suche nach den Anmeldedaten Ihrer Anwendung.
Sie haben drei Möglichkeiten, diese Anmeldedaten anzugeben:
Führen Sie
gcloud auth application-default login
ausPlatzieren Sie das Dienstkonto in einem Standardpfad für Ihr Betriebssystem. Im Folgenden sind die Standardpfade für Windows und Linux aufgeführt:
Windows:
%APPDATA%/gcloud/application_default_credentials.json
Linux:
$HOME/.config/gcloud/application_default_credentials.json
Legen Sie die Umgebungsvariable
GOOGLE_APPLICATION_CREDENTIALS
auf Pfad zu Ihrem Dienstkonto:
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"
Traces ansehen
Rufen Sie in der Google Cloud Console die Seite Trace Explorer auf:
Sie können diese Seite auch über die Suchleiste finden.
Fehlerbehebung
Informationen zur Fehlerbehebung bei Cloud Trace finden Sie auf der Seite Fehlerbehebung.
Informationen zum Debuggen des C++ Cloud Trace-Exporters finden Sie in der Abschnitt Fehlerbehebung der Referenz Dokumentation.
Ressourcen
- https://opentelemetry.io/
- open-telemetry/opentelemetry-cpp GitHub-Repository
- google-cloud-cpp OpenTelemetry Exporters Library GitHub-Repository