Cloud Trace – Übersicht

Cloud Trace ist ein System für verteiltes Tracing für Google Cloud , das die Anfragelatenz erfasst und Ihnen hilft, Leistungsengpässe in Diensten und Anwendungen mit generativer KI zu beheben. Durch das Erfassen von Latenzdaten ausGoogle Cloud -Diensten und instrumentierten Anwendungen hilft Trace Ihnen, die Verarbeitung von Anfragen in einer Mikrodienstarchitektur nachzuvollziehen und relevante Logs zu identifizieren.

Mit Trace können Sie die End-to-End-Anfragelatenz messen, Leistungstrends im Zeitverlauf vergleichen und ermitteln, welche Downstream-Abhängigkeiten Verzögerungen verursachen. Eine Anleitung zum Korrelieren von Traces und Logs finden Sie unter Traces und Logs gemeinsam zur Ursachenanalyse verwenden.

Umgebungsunterstützung

Traces können unter Linux in den folgenden Umgebungen ausgeführt werden:

Komponenten

Trace besteht aus einem Tracing-Client, der Traces erfasst und an Ihr Google Cloud -Projekt sendet. Anschließend können Sie die vom Tracing-Client erfassten Daten in derGoogle Cloud Console ansehen und analysieren. Informationen zum Datenmodell finden Sie unter Traces und Spans.

Tracing-Client

Ein Tracing-Client erfasst Latenz- und Spandaten aus Ihrer Anwendung und exportiert sie in Ihr Google Cloud -Projekt. Je nach Umgebung und Anforderungen können Sie Tracedaten automatisch oder manuell erfassen, indem Sie Ihren Anwendungscode instrumentieren.

Tracing-Schnittstelle

Sie können die Spannen-Daten in derGoogle Cloud Console auf den Seiten Trace Explorer und Observability Analytics ansehen und analysieren:

  • Trace Explorer: Hier werden aggregierte Informationen zu Ihren Tracedaten angezeigt und Sie können einzelne Traces im Detail untersuchen. Die aggregierten Latenzdaten werden in einer Heatmap dargestellt, die Sie mit dem Mauszeiger erkunden können. Sie können Filter hinzufügen, um die angezeigten Daten einzuschränken. Sie können sich auch einzelne Spans und Traces ansehen und sie untersuchen:

  • Observability Analytics: Bietet eine SQL-Abfrageschnittstelle. In Ihren Abfragen können Sie Ihre Trace- und Logdaten zusammenführen und die Abfrageergebnisse entweder als Tabelle oder als Diagramm ansehen. Wenn Sie ein verknüpftes BigQuery-Dataset erstellen, können Sie BigQuery verwenden, um Ihre Tracedaten zu analysieren. Weitere Informationen finden Sie unter Traces abfragen und analysieren.

Konfigurationen mit automatischem Tracing

Bei den folgenden Konfigurationen werden automatisch Tracedaten erfasst:

  • App Engine-Standardumgebung

    • Laufzeiten der ersten Generation fangen automatisch Trace-Spans ab und senden sie an Cloud Trace. Weitere Informationen finden Sie unter Übersicht über Legacy-Dienste.

    • In Laufzeiten der zweiten Generation wird die Gesamtlatenz von Anfragen automatisch erfasst und Anfragen wird der HTTP-Header X-Cloud-Trace-Context hinzugefügt. Weitere Informationen finden Sie im Zeitplan für den Laufzeitsupport.

  • Cloud Run Functions und Cloud Run

    Für eingehende und ausgehende HTTP-Anfragen werden Latenzdaten automatisch an Trace gesendet.

Anwendung instrumentieren

Instrumentieren Sie Ihre Anwendung, um bestimmte Informationen zu erfassen, mit denen Sie die Leistung nachvollziehen und Fehler beheben können. Mit verschiedenen als Open Source veröffentlichten Instrumentierungs-Frameworks können Sie Log-, Messwert- und Trace-Daten erfassen und diese Daten an einen beliebigen Anbieter senden, einschließlich Google Cloud. Bei Ihren Agent-basierten Anwendungen können einige Frameworks Ihre Prompts und Antworten erfassen oder Kontext übergeben, der die Nachverfolgung einiger Remote-Aufrufe von Google Cloud MCP-Servern ermöglicht.

Wir empfehlen, für die Instrumentierung Ihrer Anwendung ein anbieterneutrales als Open Source veröffentlichtes Instrumentierungs-Framework wie OpenTelemetry anstelle von anbieter- und produktspezifischen APIs oder Clientbibliotheken zu verwenden. Informationen zu diesen Frameworks finden Sie unter Instrumentierung und Beobachtbarkeit und Instrumentierungsansatz auswählen.

In den von uns bereitgestellten Instrumentierungsbeispielen wird OpenTelemetry verwendet:

  • Beispiele für den Collector-basierten Export finden Sie unter:

    In diesen Beispielen werden Messwert- und Trace-Daten, die dem OpenTelemetry Protocol (OTLP) entsprechen, mithilfe der Telemetry API an Ihr Projekt gesendet. In den Beispielen wird ein Google Cloud Exporter für Log-Daten verwendet.

  • Informationen zur Verwendung eines direkten Exports von Trace-Daten und zum Senden dieser Daten an die Telemetry API finden Sie unter Vom Trace-Exporter zum OTLP-Endpunkt migrieren.

  • Beispiele für die Konfiguration einer agentischen Anwendung zum Erfassen von Prompts und Antworten finden Sie unter Generative KI-Anwendungen instrumentieren.

Sie können zwar Cloud Trace-Clientbibliotheken verwenden, um Ihre Anwendung zu instrumentieren, wir empfehlen jedoch, OpenTelemetry zu verwenden. OpenTelemetry-Bibliotheken sind Trace-Clientbibliotheken vorzuziehen, da sie einfacher sind und Tracedaten im OTLP-Format exportieren, das von OpenTelemetry definiert wird. Weitere Informationen finden Sie unter Für Trace instrumentieren und Clientbibliotheken für Cloud Trace.

Cloud Trace und agentische Anwendungen

Um das Verhalten Ihrer agentenbasierten Anwendungen nachzuvollziehen, konfigurieren Sie sie so, dass sie Prompts und Antworten erfassen oder Spans generieren, wenn sie Remote-Google Cloud MCP-Server aufrufen. Mithilfe von Prompts und Antworten können Sie nachvollziehen, welche Argumentation Ihre Anwendung mit KI-Agenten verwendet. Spans, in denen Toolaufrufe aufgezeichnet werden, helfen Ihnen, Toolaufrufe, Anrufstatus und Anfragelatenzen zu bestätigen.

Mehrere Instrumentierungsbeispiele zeigen, wie Sie eine Anwendung so konfigurieren, dass Prompts und Antworten erfasst werden. Diese Beispiele basieren auf OpenTelemetry. Weitere Informationen finden Sie unter Generative KI-Anwendungen instrumentieren.

Google Cloud-MCP-Server können Trace-Spans generieren. Weitere Informationen finden Sie unter MCP-Aufrufe mit Trace untersuchen.

APIs, die Trace-Daten aufnehmen

Sie können Trace-Daten entweder über die Telemetry API oder die Cloud Trace API an Ihr Projekt senden. Wir empfehlen die Telemetry API aus folgenden Gründen:

  • Die API ist mit dem Open-Source-Ökosystem von OpenTelemetry kompatibel und ihre Kontingente sind oft großzügiger als die Kontingente 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 OTLP definierten Protodateien übereinstimmt. Einige Felder werden möglicherweise vor der Speicherung von einem OpenTelemetry-spezifischen Datentyp in einen JSON-Datentyp konvertiert. Informationen zum Speicherformat finden Sie unter Schema für Trace-Daten.

  • Beim Collector-basierten Export von Tracedaten ist für die Instrumentierung kein Google Cloud-spezifischer Exporteur erforderlich.

  • Einige Funktionen wie Application Monitoring basieren auf Informationen, die nur verfügbar sind, wenn Sie Tracedaten an die Telemetry API senden.

Wenn Sie verhindern möchten, dass in Ihrem Google Cloud -Projekt Trace-Daten gespeichert werden, deaktivieren Sie die Cloud Trace API. Das Deaktivieren der Cloud Trace API hat folgende Auswirkungen:

  • Google Cloud -Dienste senden keine Trace-Daten an Ihr Projekt.
  • Google Cloud Antworten auf Anfragen, die mit einem Fehlercode an einen Cloud Trace API-Endpunkt gesendet werden.
  • Google Cloud Observability verwirft Trace-Daten, die an den Trace-spezifischen Telemetry API-Endpunkt gesendet werden. Deaktivieren Sie die Telemetry API nicht, da über diese API Log-, Messwert- und Tracedaten empfangen werden können.

Wenn Sie eine Organisation verwalten und die Verwendung von Cloud Trace verhindern möchten, erstellen Sie eine Einschränkung für die Organisationsrichtlinie.

Unterstützung durch VPC Service Controls

Google Cloud -Dienste und Ihre Anwendungen können Trace-Daten an Ihr Projekt senden, indem sie entweder die Cloud Trace API oder die Telemetry API verwenden. Visualisierungsdienste, die von Cloud Trace bereitgestellt werden, verwenden die Cloud Trace API, um die angezeigten Tracedaten abzurufen:

  • Cloud Trace ist ein von VPC Service Controls unterstützter Dienst. Der Name des Trace-Dienstes ist cloudtrace.googleapis.com. Weitere Informationen und Einschränkungen finden Sie unter Unterstützte Produkte: Cloud Trace.

  • Die Telemetry API ist ein von VPC Service Controls unterstützter Dienst. Der Dienstname ist telemetry.googleapis.com. Weitere Informationen und Einschränkungen finden Sie unter Unterstützte Produkte: Telemetry API.

Wenn Sie Standardeinstellungen festlegen möchten, mit denen die Google Cloud Region angegeben wird, in der Ihre Tracedaten gespeichert werden, und ob die Daten mit einem vom Kunden verwalteten Schlüssel verschlüsselt werden, verwenden Sie die Observability API. Mit dieser API können Sie auch verknüpfte BigQuery-Datasets konfigurieren, mit denen Sie Ihre Tracedaten mit BigQuery-Diensten abfragen können, und Trace-Bereiche konfigurieren, mit denen Sie Tracedaten aggregieren können, die in mehreren Projekten gespeichert sind.

  • Die Observability API ist ein von VPC Service Controls unterstützter Dienst. Der Dienstname lautet observability.googleapis.com. Weitere Informationen und Einschränkungen finden Sie unter Unterstützte Produkte: Observability API.

Hier finden Sie weitere Informationen:

Cloud Trace und Datenstandort

Wenn Sie Assured Workloads verwenden, weil Sie Anforderungen an den Datenstandort oder Impact Level 4 (IL4) haben, sollten Sie die Cloud Trace API nicht zum Senden von Trace-Spans verwenden.

Wenn Sie verhindern möchten, dass in Ihrem Google Cloud -Projekt Trace-Daten gespeichert werden, deaktivieren Sie die Cloud Trace API. Deaktivieren Sie die Telemetry API nicht, da über diese API Log-, Messwert- und Tracedaten empfangen werden können.

Trace-Aufbewahrung

Kategorie Aufbewahrungsdauer
Spans, die im Bucket _Trace gespeichert sind 30 Tage

IAM-Rollen

Cloud Trace verwendet Identity and Access Management (IAM), um den Zugriff auf Ressourcen zu steuern. Eine Liste der Rollen für die Cloud Trace API und die Telemetry API finden Sie unter Zugriff mit IAM steuern.

Da die Telemetry API eine Consumer-API ist, müssen Sie zum Senden von Daten an die Telemetry API ein Kontingentprojekt angeben und dem Dienstkonto der Anwendung die Berechtigung zur Verwendung dieses Kontingents erteilen. Weitere Informationen finden Sie unter Telemetry API: Authentication.

Preise

Informationen zu den Preisen für Cloud Trace finden Sie auf der Seite Google Cloud Observability-Preise.

Nächste Schritte