View a markdown version of this page

Beobachtbarkeitsdaten für Ihre Amazon AgentCore Bedrock-Agenten anzeigen - Amazon Grundgestein AgentCore
Daten mithilfe generativer KI-Observability in Amazon anzeigen CloudWatchWeitere Daten finden Sie in CloudWatch

Beobachtbarkeitsdaten für Ihre Amazon AgentCore Bedrock-Agenten anzeigen

Nachdem Sie Observability in Ihrem Agenten implementiert haben, können Sie die gesammelten Metriken und Traces sowohl auf der generativen KI-Observability-Seite der CloudWatch Konsole als auch in CloudWatch Logs einsehen. In den folgenden Abschnitten erfahren Sie, wie Sie Metriken für Ihre Agenten einsehen können.

Daten mithilfe generativer KI-Observability in Amazon anzeigen CloudWatch

Auf der CloudWatch generativen KI-Observabilitätsseite werden alle vom Service bereitgestellten Metriken angezeigt, die von der AgentCore Agentenlaufzeit ausgegeben werden, sowie von Span- und Trace-Daten abgeleitete Daten, sofern Sie die Instrumentierung in Ihrem Agentencode aktiviert haben. Um das Observability-Dashboard in aufzurufen CloudWatch, öffnen Sie die Amazon CloudWatch GenAi Observability-Seite.

Wenn generative KI-Observability aktiviert ist CloudWatch, können Sie maßgeschneiderte Dashboards mit Grafiken und anderen Visualisierungen Ihrer Daten sowie Fehleraufschlüsselungen, Trace-Visualisierungen und mehr anzeigen. Weitere Informationen zur Verwendung generativer KI-Observability in CloudWatch, einschließlich der Anzeige der individuellen Sitzungs- und Ablaufverfolgungsdaten Ihrer Agenten, finden Sie unter Amazon Bedrock AgentCore Agents im CloudWatch Amazon-Benutzerhandbuch.

Weitere Daten finden Sie in CloudWatch

Alle vom Service bereitgestellten Metriken und Zeitspannen können ebenfalls angezeigt werden CloudWatch, zusammen mit allen Metriken, die Ihr instrumentierter Agentencode ausgibt.

Informationen zum Anzeigen dieser Daten finden Sie in den folgenden Abschnitten.

Protokolle

  1. Öffnen Sie die CloudWatch-Konsole.

  2. Erweitern Sie im linken Navigationsbereich die Option Protokolle und wählen Sie Protokollgruppen aus

  3. Verwenden Sie das Suchfeld, um die Protokollgruppe für Ihre Agenten-, Speicher- oder Gateway-Ressource zu finden.

    AgentCore Agent-Protokollgruppen haben das folgende Format:

    • Standardprotokolle — stdout/stderr Ausgabe

      • Ort:/aws/bedrock-/<agent_id>- agentcore/runtimes<endpoint_name>/[Runtime-Logs] <UUID>

      • Enthält: Laufzeitfehler, Anwendungsprotokolle, Debugging-Anweisungen

      • Beispiel für eine Verwendung:

        • print („Anfrage wird bearbeitet...“) # Erscheint in Standardprotokollen

        • logging.info („Anfrage erfolgreich verarbeitet“) # Erscheint in Standardprotokollen

    • Strukturierte OTEL-Protokolle — Detaillierte Betriebsinformationen

      • Ort:/aws/bedrock-agentcore/runtimes/<agent_id>- <endpoint_name>/otel-rt-logs

      • Enthält: Ausführungsdetails, Fehlerverfolgung, Leistungsdaten

      • Automatische Erfassung: Kein zusätzlicher Code erforderlich — generiert durch ADOT-Instrumentierung

      • Vorteile: Kann Korrelations-IDs enthalten, die Logs mit relevanten Traces verknüpfen

Spuren und Spannweiten

Traces bieten Einblick in die Pfade zur Ausführung von Anfragen durch Ihren Agenten:

  • Speicherort: der spans Protokollstream in der Protokollgruppe des Agenten (/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>) oder der default Protokollstream in der aws/spans Protokollgruppe für Agenten, die das gemeinsame Span-Ziel verwenden. Weitere Informationen finden Sie unter Span-Ziel für Agenten, die in Amazon Bedrock AgentCore Runtime gehostet werden.

  • Zugriff über: CloudWatch Transaction Search Console

  • Anforderungen: Die CloudWatch Transaktionssuche muss aktiviert sein

Traces erfassen automatisch:

  • Sequenzen beim Aufrufen von Agenten

  • Integration mit Framework-Komponenten (LangChainusw.)

  • LLM-Anrufe und Antworten

  • Tool-Aufrufe und Ergebnisse

  • Fehlerpfade und Ausnahmen

Für die verteilte Ablaufverfolgung über Dienste hinweg können Sie standardmäßige HTTP-Header verwenden:

  • AWS X-Ray Format: X-Amzn-Trace-Id: Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1

  • W3C-Format: traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

Um Traces anzusehen:

  • Navigieren Sie zur CloudWatch Konsole

  • Wählen Sie in der linken Navigationsleiste Transaktionssuche aus

  • Filtern Sie nach dem Namen des Dienstes oder nach anderen Kriterien

  • Wählen Sie einen Trace aus, um das detaillierte Ausführungsdiagramm anzuzeigen

Kennzahlen

Wenn Sie Observability aktiviert haben, indem Sie Ihren Agentencode wie unter AgentCore Observability aktivieren beschrieben instrumentiert haben, generiert Ihr Agent automatisch OTEL-Metriken, die CloudWatch über das Enhanced Metric Format (EMF) an folgende Empfänger gesendet werden:

  • Namespace: bedrock-agentcore

  • Zugriff über: Metrics-Konsole CloudWatch

  • Inhalt: Benutzerdefinierte Metriken, die durch Ihren Agentencode und Ihre Frameworks generiert werden

  • Automatische Erfassung: Kein zusätzlicher Code erforderlich — generiert durch ADOT-Instrumentierung

Zusätzlich zu den von Agenten ausgegebenen Metriken veröffentlicht der AgentCore Service Standard-Servicemetriken für. CloudWatch Eine Liste dieser Metriken finden Sie in den AgentCore generierten Daten zur Laufzeitbeobachtbarkeit.