In diesem Dokument wird die Telemetry (OTLP) API beschrieben, die das OpenTelemetry OTLP Protocol implementiert. Diese API ist für Anwendungen konzipiert, die mit einem der OpenTelemetry SDKs instrumentiert sind.
Vorteile der Telemetry API
Die Telemetry API unterstützt die Aufnahme von Trace-Daten im OTLP-Format. Wenn Sie die Telemetry API verwenden, werden Ihre Daten im OTLP-Format gespeichert, ohne dass sie in ein proprietäres Format konvertiert werden. Dabei gelten die Grenzwerte für die Telemetry API. Diese Limits sind oft großzügiger als die für die Cloud Trace API. Außerdem ist für die Instrumentierung kein Google Cloud-spezifischer Exporter erforderlich.
OpenTelemetry ist ein von Google Cloudunterstütztes Open-Source-Projekt mit Google CloudEntwicklern, die für die Aufnahme und Visualisierung Ihrer Trace-Daten zuständig sind.
Wann sollte die Telemetry API verwendet werden?
Wenn Sie Ihre Anwendungen instrumentieren, um Trace-Daten an Ihr Google Cloud-Projekt zu senden, empfehlen wir Ihnen, einen der folgenden Schritte auszuführen:
- Verwenden Sie einen Exporter, der OTLP in einen Collector schreibt, der Ihre Trace-Daten dann an die Telemetry API sendet.
- Verwenden Sie einen In-Process-OTLP-Exporteur, der von einer OpenTelemetry-Bibliothek unterstützt wird, die Telemetry-Daten 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.
Wo Sie aufgenommene Daten aufrufen
Trace-Daten, die über die Telemetrie API aufgenommen werden, können auf der Seite Trace Explorer angezeigt werden. Informationen zum Ansehen Ihrer Trace-Daten finden Sie unter Traces suchen und untersuchen.
Trace-Daten, die über die alte Seite Trace Explorer der Telemetrie API aufgenommen wurden. Weitere Informationen finden Sie unter Alte Trace Explorer-Version: Bekannte Probleme.
Unterstützung durch VPC Service Controls
Der Telemetry API-Dienst mit dem Dienstnamen telemetry.googleapis.com ist ein von VPC Service Controls unterstützter Dienst. Alle VPC Service Controls-Einschränkungen, die Sie für den Telemetry API-Dienst erstellen, gelten nur für diesen Dienst. Diese Einschränkungen gelten nicht für andere Dienste, einschließlich Dienste wie den cloudtrace.googleapis.com-Dienst, in den auch Trace-Daten aufgenommen werden können.
Hier finden Sie weitere Informationen: