Cloud Trace – Übersicht

Cloud Trace ist ein System für verteiltes Tracing fürGoogle Cloud, mit dem Sie nachvollziehen können, wie lange Ihre Anwendung für die Verarbeitung eingehender Anfragen von Nutzern oder anderen Anwendungen benötigt und wie lange es dauert, bis Vorgänge abgeschlossen sind, wie beispielsweise RPC-Aufrufe, die bei der Verarbeitung der Anfragen ausgeführt werden. Trace kann Ihnen auch bei der Entwicklung eines Dienstes, einer agentenbasierten Anwendung oder bei der Fehlerbehebung helfen. So können Sie beispielsweise nachvollziehen, wie Anfragen in einer komplexen Mikrodienstarchitektur verarbeitet werden, und herausfinden, welche Logs Sie untersuchen müssen.

Da Trace Latenzdaten von Google Cloud -Diensten wie App Engine und von Anwendungen, die Sie instrumentieren, empfängt, kann es Ihnen bei der Beantwortung der folgenden Fragen helfen:

  • Wie lange braucht meine Anwendung zum Verarbeiten einer bestimmten Anfrage?
  • Warum braucht meine Anwendung so lange zum Verarbeiten einer Anfrage?
  • Warum dauern manche meiner Anfragen länger als andere?
  • Wie hoch ist die Gesamtlatenz für Anfragen an meine Anwendung?
  • Ist die Latenz für meine Anwendung im Lauf der Zeit gestiegen oder gesunken?
  • Was kann ich tun, um die Latenz der Anwendung zu verringern?
  • Welche Abhängigkeiten hat meine Anwendung?

Wenn Sie wissen möchten, wie Sie Trace zur Verwaltung Ihrer Anwendungen verwenden können, lesen Sie den Blogbeitrag Fehlerbehebung bei verteilten Anwendungen: Traces und Logs gemeinsam zur Ursachenanalyse verwenden.

Informationen zur Profilerstellung für Ihre Anwendung finden Sie unter Cloud Profiler.

Umgebungsunterstützung

Trace kann unter Linux in folgenden Umgebungen ausgeführt werden:

Trace stellt Clientbibliotheken für die Instrumentierung Ihrer Anwendung zur Erfassung von Trace-Informationen bereit. Eine Anleitung zum Einrichten von Cloud Trace finden Sie unter Instrumentierung für Trace.

Konfigurationen mit automatischem Tracing

Einige Konfigurationen führen zu einer automatischen Erfassung von Trace-Daten:

  • App Engine-Standardumgebung

    Java 8-, Python 2- und PHP 5-Anwendungen müssen nicht die Trace-Clientbibliotheken verwenden. Diese Laufzeiten senden automatisch Latenzdaten für Anfragen an Anwendungs-URIs an Trace. Die Anfragen umfassen Latenzdaten für Round-Trip-RPC-Aufrufe an App Engine-Dienste. Trace kann mit allen App Engine Admin APIs verwendet werden, mit Ausnahme von Cloud SQL.

  • Cloud Run-Funktionen und Cloud Run

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

APIs, die Trace-Daten aufnehmen

Sie können Trace-Daten mit der Telemetry API oder der 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 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.

  • Beim Collector-basierten Export von Trace-Daten ist für die Instrumentierung kein Google Cloud-spezifischer Exporter 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. Wenn Sie die Cloud Trace API deaktivieren, hat das folgende Auswirkungen:

  • Google Cloud -Dienste senden keine Trace-Daten an Ihr Projekt.
  • Google Cloud antwortet auf Anfragen, die an einen Cloud Trace API-Endpunkt gesendet werden, mit einem Fehlercode.
  • 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.

Cloud Trace und agentenbasierte 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 Tool-Aufrufe aufgezeichnet werden, helfen Ihnen, Tool-Aufrufe, 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.

Informationen dazu, welche Remote-Google Cloud-MCP-Server die Trace-Generierung unterstützen und wie Sie Ihre Anwendung so konfigurieren, dass diese Server Spans erstellen, finden Sie unter MCP-Aufrufe mit Trace untersuchen.

Anwendung instrumentieren

Instrumentieren Sie Ihre Anwendung, um bestimmte Informationen zu erfassen, die Ihnen helfen, die Leistung zu analysieren und Fehler zu beheben. 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 agentenbasierten Anwendungen können einige Frameworks Ihre Prompts und Antworten erfassen oder Kontext übergeben, der das Tracing 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:

  • Informationen dazu, welche Remote-Google Cloud-MCP-Server die Erstellung von Traces unterstützen und wie Sie Ihre Anwendung so konfigurieren, dass diese Server Spans erstellen, finden Sie unter MCP-Aufrufe mit Trace untersuchen.

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

Komponenten

Trace besteht aus einem Tracing-Client, der Traces erfasst und an Ihr Google Cloud -Projekt sendet. Sie können dann dieGoogle Cloud Console verwenden, um die vom Agent erfassten Daten anzusehen und zu analysieren. Informationen zum Datenmodell finden Sie unter Traces und Spans.

Tracing-Client

Wenn eine OpenTelemetry-Bibliothek für Ihre Programmiersprache verfügbar ist, können Sie das Erstellen und Senden von Trace-Daten mithilfe von OpenTelemetry vereinfachen. Neben der einfacheren Verwendung implementiert OpenTelemetry auch Batchverarbeitung, wodurch die Leistung verbessert werden kann.

Wenn keine OpenTelemetry-Bibliothek vorhanden ist, instrumentieren Sie den Code, indem Sie die Trace SDK-Bibliothek importieren und die Cloud Trace API verwenden. Die Cloud Trace API sendet Trace-Daten an Ihr Google Cloud -Projekt.

Tracingschnittstelle

Sie können Ihre Trace-Daten nahezu in Echtzeit in der Trace-Oberfläche ansehen und analysieren.

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 zusammengefasste Informationen zu Ihren Trace-Daten 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. Auf dieser Seite können Sie auch einzelne Spans und Traces ansehen und untersuchen:

  • Observability Analytics: Auf dieser Seite können Sie Abfragen ausführen, mit denen eine aggregierte Analyse Ihrer Spans mit SQL durchgeführt wird. In Ihren SQL-Abfragen können Sie auch Ihre Trace- und Logdaten zusammenführen. Sie können die Ergebnisse Ihrer Abfrage in Tabellenform oder in Diagrammen ansehen. Wenn Sie ein verknüpftes Dataset erstellen, können Sie Ihre Spans mit BigQuery analysieren. Weitere Informationen finden Sie unter Traces abfragen und analysieren.

Unterstützung durch VPC Service Controls

Cloud Trace ist ein von VPC Service Controls unterstützter Dienst. Der Name des Trace-Dienstes ist cloudtrace.googleapis.com. Alle VPC Service Controls-Einschränkungen, die Sie für den Trace-Dienst erstellen, gelten nur für diesen Dienst. Diese Einschränkungen gelten nicht für andere Dienste, einschließlich Dienste wie telemetry.googleapis.com, in die auch Tracedaten aufgenommen werden können.

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. Wenn Sie die Cloud Trace API deaktivieren, hat das folgende Auswirkungen:

  • Google Cloud -Dienste senden keine Trace-Daten an Ihr Projekt.
  • Google Cloud antwortet auf Anfragen, die an einen Cloud Trace API-Endpunkt gesendet werden, mit einem Fehlercode.
  • 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.

Preise

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

Nächste Schritte