In diesem Dokument wird beschrieben, warum wir empfehlen, Ihre Trace-Daten mit der Telemetry API (OTLP) an IhrGoogle Cloud -Projekt zu senden. Diese API implementiert das OpenTelemetry OTLP Protocol. Außerdem wird beschrieben, wie Sie Ihre Anwendungen instrumentieren und wo Sie Ihre Tracedaten 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 folgenden Gründen:
Die API ist mit dem Open-Source-Ökosystem von OpenTelemetry kompatibel und ihre Limits sind oft großzügiger als die Limits der Cloud Trace API, die eine proprietäre Google Cloud API ist.
Ihre Tracedaten werden in einem Format gespeichert, das im Allgemeinen mit den von OpenTelemetry OTLP Protocol definierten Protodateien übereinstimmt. 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 Tracedaten.
Ihre Instrumentierung basiert nicht auf einem Google Cloud-spezifischen Exporttool.
Einige Funktionen wie Application Monitoring basieren auf Informationen, die nur verfügbar sind, wenn Sie Tracedaten an die Telemetry API senden.
OpenTelemetry ist ein von Google Cloudunterstütztes Open-Source-Projekt mit Google CloudEntwicklern, die für die Unterstützung beim Erfassen und Visualisieren Ihrer Telemetriedaten sorgen.
Best Practices
Wenn Sie Ihre Anwendungen so instrumentieren, dass sie Tracedaten an IhrGoogle Cloud -Projekt senden, empfehlen wir, 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, die Telemetrie an die Telemetry API sendet. Es gibt keinen Collector mit dieser Konfiguration.
Informationen zur Verwendung der Telemetry API finden Sie unter Vom 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 IhrenGoogle Cloud Standardanmeldedaten für Anwendungen konfigurieren möchten, fügen Sie Ihrer Anwendung eine sprachspezifische Google Auth Library 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 Impact Level 4 (IL4) haben, sollten Sie die Telemetry API nicht verwenden, um Trace-Spans an Ihr Projekt zu senden.
Wo kann ich aufgenommene Daten ansehen?
Sie können Ihre Trace-Daten auf den Seiten Trace-Explorer und Loganalysen aufrufen. Weitere Informationen finden Sie hier: