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 Messwert-Telemetriedaten entweder über den Metrics Explorer oder direkt in einzelnen Agents über den Tab Messwerte 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 geben die Leistung, die Ressourcennutzung oder das Verhalten eines Systems wieder. Entwickler verwenden Messwerte, um den Systemzustand zu überwachen, Trends zu erkennen und Benachrichtigungen auszulösen.

Hinweis

Sie benötigen Folgendes:

  • Die Gemini Enterprise-Administratorrolle oder die Google Cloud Gemini Enterprise-Nutzerrolle in der Console.

  • 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 Einstellung zur 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-Agent) oder auf dem Tab Beobachtbarkeit des Agents (für von Mitarbeitern erstellte Agent Designer-Agents und Deep Research-Agents). Weitere Informationen finden Sie unter Einstellungen zur Beobachtbarkeit verwalten.

Datenaufbewahrung

Von Ihrer Gemini Enterprise-App generierte Messwerte werden in Cloud Monitoring in Ihrem Google Cloud Projekt gespeichert. Die Aufbewahrung wird von Cloud Monitoring verwaltet. Gemini Enterprise-Messwerte werden unter dem Präfix discoveryengine.googleapis.com/ veröffentlicht, das unter die Stufe „Alle anderen Google Cloud-Messwerte“ fällt und standardmäßig 6 Wochen lang aufbewahrt wird. 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-App 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 Aufrufe von Tools durch den Gemini Enterprise Agent.
    Gemini Enterprise Agent – Anzahl der Gemini Enterprise Agent-Runden 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 des 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).

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

  6. Optional können Sie zusätzliche Label-Filter 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-spezifischen und Sitzungsmesswerten direkt für einzelne Agents auf dem Tab Messwerte des Agents in der Google Cloud Console aufrufen.

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

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

Der Tab Messwerte enthält wichtige Betriebs-Telemetriedaten, 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 Zeit pro Sitzung: Durchschnittliche Zeit, die während einer Sitzung verstrichen ist.
  • 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 des Tabs „Messwertübersicht“ in der Google Cloud -Konsole 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 Agent verbunden sind, darunter:

  • Gesamtzahl der Aufrufe: Anzahl der Tool-Ausführungsanfragen.
  • P95-Dauer nach Tool: Die Latenz des 95. Perzentils 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