In diesem Dokument wird beschrieben, wie Sie auf Traces und Spans zugreifen und sie ansehen können, die von Ihrer Gemini Enterprise-App generiert wurden. Traces und Spans liefern detaillierte Einblicke in die Leistung und den Ausführungsablauf von Anfragen in Ihrer Anwendung, z. B. bei der Verwendung des Assistenten oder von KI-Agenten.
Sie können Trace-Daten entweder im Trace Explorer oder direkt in einzelnen KI-Agenten auf dem Tab Traces des Agenten ansehen.
Wichtige Konzepte
In diesem Abschnitt werden wichtige Konzepte im Zusammenhang mit der Beobachtbarkeit in Gemini Enterprise vorgestellt.
| Konzept | Beschreibung |
|---|---|
| Trace |
Ein Trace ist eine Sammlung von Spans, die eine einzelne Anfrage oder
Transaktion darstellt, während sie verschiedene Dienste und Komponenten durchläuft.
Ein Trace stellt beispielsweise den gesamten Lebenszyklus einer Anfrage dar. Dazu gehören eine Frage eines Nutzers an den Gemini Enterprise-Assistenten, die Antwort des Gemini Enterprise-Assistenten und alle nachfolgenden Aktionen, die durch die Antwort ausgelöst werden, z. B. das Senden einer E-Mail. |
| Span | Ein Span ist eine einzelne, zeitlich begrenzte Arbeitseinheit innerhalb eines Trace. Er stellt eine spezifische Operation dar, z. B. einen Funktionsaufruf, eine API-Anfrage oder eine Datenbankabfrage. Jeder Span enthält Details wie Start- und Endzeit, eine eindeutige ID und die Beziehung zu anderen Spans. Diese Beziehungen bilden zusammen einen Trace. |
| Span-Logs | Span-Logs sind mit Zeitstempeln versehene Nachrichten oder Ereignisse in freiem Format, die mit einem bestimmten Span verknüpft sind. Sie liefern detaillierte, kontextbezogene Informationen zur Ausführung eines Spans und helfen Nutzern, Probleme zu beheben und den Ablauf einer Anfrage zu verstehen. |
Hinweis
Sie benötigen Folgendes:
Die Rolle „Gemini Enterprise-Administrator “ oder die Rolle „Gemini Enterprise-Nutzer“ in derconsole. Google Cloud
Eine vorhandene Gemini Enterprise-Webanwendung. Informationen zum Erstellen einer neuen Anwendung finden Sie unter Anwendung erstellen.
Für den Zugriff auf Traces benötigen Sie die Rolle „Cloud Trace-Nutzer“ (
roles/cloudtrace.user).Aktivieren Sie die Einstellung für die Beobachtbarkeit Instrumentierung von OpenTelemetry-Traces und ‑Logs aktivieren. Je nach Agent-Typ aktivieren Sie diese Einstellung in den Konfigurationen auf App-Ebene (für den Core Assistant-Agenten) oder auf dem Tab Konfiguration des Agenten (für von Mitarbeitern erstellte Agent Designer-Agenten und Deep Research-Agenten). Weitere Informationen finden Sie unter Einstellungen für die Beobachtbarkeit verwalten.
Datenaufbewahrung
Von Ihrer Gemini Enterprise-App generierte Traces und Spans werden in Cloud Trace in Ihrem Google Cloud Projekt gespeichert. Die Aufbewahrung unterliegt Cloud Trace. Standardmäßig werden Spandaten in Cloud Trace 30 Tage lang aufbewahrt; Daten, die älter als der Aufbewahrungszeitraum sind, werden automatisch gelöscht. Die maßgeblichen und aktuellsten Aufbewahrungswerte finden Sie in der Cloud Trace-Dokumentation unter Aufbewahrungszeiträume für Cloud Trace im Abschnitt Kontingente und Limits für Cloud Trace.
Auf Traces im Trace Explorer zugreifen
So greifen Sie mit dem Trace Explorer auf Traces und Spans zu:
Rufen Sie in der Google Cloud console die Seite Trace Explorer auf.
Wählen Sie das Google Cloud Projekt aus, in dem Ihre Gemini Enterprise-App erstellt wurde. Alle Spans für Ihr Projekt werden angezeigt.
Klicken Sie in der Tabelle auf eine Span-ID, um die Trace-Details aufzurufen, einschließlich der Dauer des Spans und anderer Attribute.
Auf Traces für KI-Agenten zugreifen
Sie können Trace-Spans auch direkt für einzelne KI-Agenten auf dem Tab Traces des Agenten ansehen. Dort wird eine detaillierte chronologische Zusammenfassung der Span-Trace-Einträge und der Ausführungsstrukturen mit über- und untergeordneten Elementen angezeigt.
So greifen Sie auf Traces für einen Agenten zu:
- Rufen Sie in der Google Cloud console Ihre App auf und klicken Sie dann auf KI-Agenten.
- Wählen Sie den Agenten aus, den Sie untersuchen möchten, und klicken Sie dann auf den Tab Traces.
Tabelle mit der Trace-Zusammenfassung
In der Haupttabelle auf dem Tab Traces werden die folgenden Informationen für jeden Trace-Span angezeigt:
- Status: Der aktuelle Status des Trace (derzeit wird Nicht festgelegt angezeigt).
- Trace-Span-ID: Die eindeutige Kennung für den Trace-Span. Klicken Sie auf den Link zur Span-ID, um die Details aufzurufen.
- Span-Name: Eine kurze Beschreibung der Arbeit, die der Span ausführt.
- Span-Typ: Der Typ des Spans. Folgende Optionen sind verfügbar:
Agent to Tool: Ein Aufruf vom Agenten an ein externes Tool.Invoke Agent: Ein Aufruf eines Agenten.Agent to Model: Eine Anfrage vom Agenten an ein Large Language Model.
- Dauer: Die Zeit, die für den Trace-Span benötigt wurde (in Minuten).
- Eingabe: Die Eingabedaten oder die Nachricht, die an den Span gesendet wurde (falls vorhanden).
- Ausgabe: Das vom Span zurückgegebene Ausgaberesultat (falls vorhanden).
- Startzeit: Der genaue Zeitstempel, als die Ausführung des Spans begann.
Detaillierte Trace-Ansicht
Wenn Sie auf eine Trace-Span-ID klicken, wird eine Detailseite mit folgenden Informationen geöffnet:
- Zusammenfassung: Hier sehen Sie die grundlegenden Metadaten, einschließlich Startzeit, Dauer und der Gesamtzahl der Spans. Sie können auf In Cloud Trace ansehen klicken oder zwischen den Schaltflächen Diagramm und Zeitachse wechseln.
- Visualisierungen: Wechseln Sie zwischen einer grafischen Hierarchie und einer Zeitachsenansicht, in der die Beziehungen zwischen über- und untergeordneten Elementen aller Trace-Spans dargestellt werden.
- Details zum ausgewählten Span: Wählen Sie einen einzelnen Span aus, um detaillierte Abschnitte anzuzeigen, die Folgendes enthalten können:
- Zusammenfassung: Hier werden der Name des Spans, der Zieldienst, die Anzahl der Spans mit dieser Aktion und die Gesamtdauer (in Sekunden) angezeigt.
- Logs: Hier sehen Sie relevante Ereignisdetails, falls konfiguriert. Klicken Sie auf Logs ansehen , um direkt zu den Standardlogs zu gelangen.
- Bewertung: Hier werden alle Bewertungsergebnisse angezeigt, falls konfiguriert.
- Ein- und Ausgabe: Vollständige Anfrage- und Antwortnutzlasten.
- Logs und Ereignisse: Liste der Ereignisse, die während der Ausführung dieses Spans aufgetreten sind.
- Stacktraces: Fehlerdetails, wenn die Ausführung eines Spans fehlschlägt.
- Metadaten und Links: Links zu verknüpften Cloud Explorer-Entitäten.
- Attribute: Ressourcentags und zusätzliche Parameter für die Beobachtbarkeit in Form von Schlüssel-Wert-Paaren.
