In diesem Dokument wird beschrieben, warum wir empfehlen, Ihre Trace-Daten mit der Telemetry (OTLP) API an Ihr Google Cloud Projekt zu senden. Diese API implementiert das OpenTelemetry OTLP-Protokoll. Außerdem finden Sie hier eine Anleitung zum Instrumentieren Ihrer Anwendungen und Informationen dazu, wo Sie Ihre Trace-Daten ansehen können. Sie können die Telemetry API verwenden, wenn Sie Ihre Anwendungen mit einem der OpenTelemetry SDKs instrumentieren oder einen OpenTelemetry Collector verwenden.
Wir empfehlen die Telemetry API aus folgendem Grund:
Die API ist mit dem Open-Source-Ökosystem von OpenTelemetry kompatibel und ihre Limits sind oft großzügiger als die der Cloud Trace API, die eine proprietäre Google Cloud API ist.
Ihre Trace-Daten werden in einem Format gespeichert, das im Allgemeinen mit den Protobuf-Dateien übereinstimmt, die vom OpenTelemetry OTLP-Protokoll definiert werden. Einige Felder werden möglicherweise vor der Speicherung von einem OpenTelemetry-spezifischen Datentyp in einen JSON-Datentyp konvertiert. Weitere Informationen zum Speicherformat finden Sie unter Schema für Trace-Daten.
Ihre Instrumentierung ist nicht von einem Google Cloudbestimmten Exporter abhängig.
Einige Funktionen wie Application Monitoring basieren auf Informationen, die nur verfügbar sind, wenn Sie Trace-Daten an die Telemetry API senden.
OpenTelemetry ist ein Google Cloud-unterstütztes Open-Source-Projekt, für das Google Cloud Entwickler bereitstehen, um die Aufnahme und Visualisierung Ihrer Telemetriedaten zu unterstützen.
Google Cloud Observability prüft, ob die Cloud Trace API in Ihrem Projekt aktiviert ist , bevor Trace-Daten gespeichert werden Google Cloud . Wenn Sie die Cloud Trace API deaktivieren, verwirft Google Cloud Observability Trace-Daten, die Sie an die Telemetry API senden.
Best Practices
Wenn Sie Ihre Anwendungen instrumentieren, um Trace-Daten an Ihr Google Cloud Projekt zu senden, empfehlen wir Ihnen, eine der folgenden Aktionen auszuführen:
- Verwenden Sie einen Exporter, der OTLP in einen Collector schreibt, der dann Ihre Trace-Daten an die Telemetry API sendet.
- Verwenden Sie einen In-Process-OTLP-Exporter, der von einer OpenTelemetry-Bibliothek unterstützt wird und Telemetriedaten an die Telemetry API sendet. Bei dieser Konfiguration ist kein Collector vorhanden.
Informationen zur Verwendung der Telemetry API finden Sie unter Von Cloud Trace-Exporter zum OTLP-Endpunkt migrieren.
Authentifizierung
Sie müssen Ihre Exporter mit den Anmeldedaten konfigurieren, die zum Senden von Trace Daten an Ihr Google Cloud Projekt erforderlich sind. Wenn Sie den Exporter beispielsweise mit Ihren Google Cloud Standardanmeldedaten für Anwendungen (ADC) konfigurieren möchten, fügen Sie Ihrer Anwendung eine sprachspezifische Google Auth-Bibliothek hinzu. Weitere Informationen und Beispielcode finden Sie unter Authentifizierung konfigurieren.
Cloud Trace und Datenstandort
Wenn Sie Assured Workloads verwenden, weil Sie Anforderungen an den Datenstandort oder an das Impact Level 4 (IL4) haben, verwenden Sie die Telemetry API nicht, um Trace-Spans an Ihr Projekt zu senden.
Aufgenommene Daten ansehen
Sie können Ihre Trace-Daten auf den Seiten Trace-Explorer und Observability Analytics ansehen. Weitere Informationen: