Auf Messwerte zugreifen

In diesem Dokument wird beschrieben, wie Sie auf die Messwerte zugreifen, die von Ihrer Gemini Enterprise-App generiert werden. Diese Messwerte liefern Einblicke in die Leistung und den Zustand Ihrer Anwendung.

Sie können die Messwerttelemetrie entweder über den Metrics Explorer oder direkt in einzelnen Agents über den Tab Beobachtbarkeit des Agents aufrufen.

Wichtige Konzepte

In diesem Abschnitt werden die wichtigsten Konzepte im Zusammenhang mit der Beobachtbarkeit in Gemini Enterprise vorgestellt.

Konzept Beschreibung
Messwerte Messwerte sind numerische Messungen, die von Systemen im Laufe der Zeit erfasst werden. Diese Messungen stellen die Leistung, die Ressourcennutzung oder das Verhalten eines Systems dar. Entwickler verwenden Messwerte, um den Systemzustand zu überwachen, Trends zu erkennen und Benachrichtigungen auszulösen.
Messwerte auf Agentenebene Messwerte, die die Aktivität eines einzelnen Agents messen, z. B. seine Sitzungen, Unterhaltungsrunden und Tool-Aufrufe. Sie werden unter dem Ressourcentyp Gemini Enterprise Agent aufgeführt und nur erfasst, wenn die Beobachtbarkeitseinstellung Instrumentierung von OpenTelemetry-Traces und ‑Logs aktivieren für diesen Agenten aktiviert ist.
Messwerte auf Anwendungsebene Messwerte, die den gesamten Traffic zu einer Anwendung und nicht zu einem einzelnen Agenten messen, z. B. die Anzahl der Anfragen und die End-to-End-Latenz. Sie werden unter dem Ressourcentyp Gemini Enterprise Engine aufgeführt, wobei Engine der API-Name für eine Gemini Enterprise-Anwendung ist. Sie werden unabhängig von den Beobachtbarkeitseinstellungen erfasst.

Hinweis

Sie benötigen Folgendes:

  • Die Rolle „Gemini Enterprise Admin “ oder die Rolle „Gemini Enterprise User“ in derConsole. Google Cloud

  • Eine vorhandene Gemini Enterprise-Webanwendung. Informationen zum Erstellen einer neuen Anwendung finden Sie unter Anwendung erstellen.

  • Sie benötigen die Rolle „Monitoring-Betrachter“ (roles/monitoring.viewer), um auf den Metrics Explorer zuzugreifen.

  • Aktivieren Sie die Beobachtbarkeitseinstellung Instrumentierung von OpenTelemetry-Traces und ‑Logs aktivieren. Je nach Agententyp aktivieren Sie diese Einstellung in den Konfigurationen auf Anwendungsebene (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 Beobachtbarkeitseinstellungen verwalten. Diese Einstellung ist für die Messwerte auf Agentenebene erforderlich. Die Messwerte auf Anwendungsebene, die unter dem Ressourcentyp Gemini Enterprise Engine aufgeführt sind, werden ohne diese Einstellung erfasst.

Datenaufbewahrung

Von Ihrer Gemini Enterprise-Anwendung generierte Messwerte werden in Cloud Monitoring in Ihrem Google Cloud Projekt gespeichert. Die Aufbewahrung wird von Cloud Monitoring verwaltet. Gemini Enterprise-Messwerte werden mit dem discoveryengine.googleapis.com/ Präfix veröffentlicht. Sie fallen unter die Stufe „Alle anderen Google Cloud Messwerte“ und werden standardmäßig 6 Wochen lang aufbewahrt. Daten, die älter als der Aufbewahrungszeitraum sind, werden automatisch gelöscht. Die maßgeblichen und aktuellsten Aufbewahrungswerte finden Sie unter Datenaufbewahrung in der Dokumentation zu Kontingenten und Limits von Cloud Monitoring.

Auf Messwerte im Metrics Explorer zugreifen

So greifen Sie auf die Messwerte zu:

  1. Wechseln Sie in der Google Cloud Console zur Seite Metrics Explorer.

    Zum Metrics Explorer

  2. Wählen Sie das Google Cloud Projekt aus, in dem Ihre Gemini Enterprise-Anwendung erstellt wurde.

  3. Klicken Sie auf Messwert auswählen , um eine Suchleiste zu öffnen.

  4. Suchen Sie in der Suchleiste nach den folgenden Messwerten:

    Name des Messwerts Beschreibung
    Gemini Enterprise Agent – Anzahl der Gemini Enterprise Agent-Sitzungen Die Anzahl der Sitzungen, die vom Gemini Enterprise Agent verarbeitet wurden.
    Gemini Enterprise Agent – Anzahl der Gemini Enterprise Agent-Tools Die Anzahl der Tool-Aufrufe durch den Gemini Enterprise Agent.
    Gemini Enterprise Agent – Anzahl der Gemini Enterprise Agent-Unterhaltungsrunden Die Anzahl der Unterhaltungsrunden in Gemini Enterprise Agent-Sitzungen.
    Gemini Enterprise Agent – Gesamtlatenz des Gemini Enterprise Agent Die Gesamtlatenz der Antworten des Gemini Enterprise Agent.
    Gemini Enterprise Agent – Gesamtlatenz der Gemini Enterprise Agent-Tools Die Gesamtlatenz, die durch Tool-Ausführungen im Gemini Enterprise Agent entsteht.
    Gemini Enterprise DataConnector – Anzahl der Gemini Enterprise DataConnector-Anfragen Die Gesamtzahl der Anfragen an die Gemini Enterprise-Daten connectors (in der Google Cloud Console auch als Datenspeicher bezeichnet).
    Gemini Enterprise DataConnector – Latenzen der Gemini Enterprise DataConnector-Anfragen (Beta) Die Latenz von Anfragen an die Gemini Enterprise-Daten connectors (in der Google Cloud Console auch als Datenspeicher bezeichnet) in Millisekunden.
    Gemini Enterprise Engine – Anzahl der Gemini Enterprise Engine-Anfragen Die Gesamtzahl der Anfragen, die von Ihrer Gemini Enterprise-Anwendung empfangen wurden, über den gesamten Traffic zur Anwendung und nicht zu einem einzelnen Agenten. Aufgeschlüsselt nach API-Methode, kanonischem gRPC Antwortcode, Antwortcodeklasse, Abfragetyp und Modell.
    Gemini Enterprise Engine – Gesamtlatenz der Gemini Enterprise Engine-Anfragen Die Verteilung der End-to-End-Anfragelatenz für Ihre Gemini Enterprise-Anwendung. Für jede Anfrage aufgezeichnet, einschließlich Anfragen, die einen Fehler zurückgeben.
    Gemini Enterprise Engine – Latenz bis zur ersten Antwort der Gemini Enterprise Engine Die Verteilung der Latenz zwischen dem Empfang einer Anfrage und Streaming des ersten Antworttokens. Wird nur für Anfragen aufgezeichnet, die mindestens ein Antworttoken erzeugen.
    Gemini Enterprise Engine – Latenz bis zum ersten Token der Gemini Enterprise Engine Die Verteilung der Latenz zwischen dem Empfang einer Anfrage und dem Streaming des ersten Tokens, unabhängig davon, ob dieses Token Teil des Denkprozesses des Modells oder eine endgültige Antwort ist. Wird nur für Anfragen aufgezeichnet, die mindestens ein gestreamtes Token erzeugen.

  5. Wählen Sie den Messwert aus, den Sie untersuchen möchten, und klicken Sie auf Übernehmen.

  6. Optional können Sie zusätzliche Labelfilter und Aggregationselemente festlegen und den Zeitraum anpassen.

    Screenshot des Metrics Explorer in der Google Cloud Console mit Messwerten für Gemini Enterprise-Agents.

Auf Messwerte für Agents zugreifen

Sie können auch Dashboards mit Betriebs-, Tool- und Sitzungsmesswerten direkt für einzelne Agents auf dem Tab Beobachtbarkeit des Agents in der Google Cloud Console aufrufen.

So greifen Sie auf Messwerte für einen Agenten zu:

  1. Rufen Sie in der Google Cloud Console Ihre Anwendung auf und klicken Sie dann auf Agents.
  2. Wählen Sie den Agenten aus, den Sie untersuchen möchten, und klicken Sie dann auf den Tab Beobachtbarkeit.

Auf dem Tab Beobachtbarkeit finden Sie wichtige Betriebsdaten, die in zwei Ansichten unterteilt sind: Übersicht und Tools.

Übersichtsmesswerte

Diese Ansicht enthält ein Dashboard mit einer Zusammenfassung der Standarddaten zu Sitzungen und zum Zustand des Agents, darunter:

  • Sitzungen: Gesamtzahl der Nutzersitzungen.
  • Durchschnittliche Dauer pro Sitzung: Durchschnittliche Dauer einer Sitzung.
  • Agent-Aufrufe: Gesamtzahl der Aufrufe des Agents.
  • Agent-Latenz: Latenz im Zeitverlauf und für bestimmte Messwerte.
  • Agent-Traffic: Volumen eingehender Anfragen.
  • Fehlerrate des Agents: Prozentsatz der fehlgeschlagenen Agent-Aufrufe.

Screenshot der Übersicht des Tabs „Beobachtbarkeit“ in der Google Cloud Console mit Sitzungen, durchschnittlichen Turns pro Sitzung, Agent-Aufrufen, Latenz, Traffic und Fehlerrate

Tool-Messwerte

Diese Ansicht konzentriert sich speziell auf die Nutzung und Latenz von Tools, die mit Ihrem Agenten verbunden sind, darunter:

  • Gesamtzahl der Aufrufe: Anzahl der Anfragen zur Tool-Ausführung.
  • P95-Dauer nach Tool: Die Latenz im 95. Perzentil der Ausführungen, kategorisiert nach Tool.
  • Anzahl der Aufrufe nach Tool: Gesamtzahl der Aufrufe, aufgeteilt auf verschiedene Tools.
  • Fehlerrate nach Tool: Die Fehlerrate der Ausführungen nach Tool.
  • Rate „Kein Tool aufgerufen“: Die Rate, mit der Interaktionen keine Tool-Ausführung ausgelöst haben.

Nächste Schritte