View a markdown version of this page

檢視 Amazon Bedrock AgentCore 代理程式的可觀測性資料 - Amazon Bedrock AgentCore
在 Amazon CloudWatch 中使用生成式 AI 可觀測性檢視資料在 CloudWatch 中檢視其他資料

檢視 Amazon Bedrock AgentCore 代理程式的可觀測性資料

在代理程式中實作可觀測性之後，您可以在 CloudWatch 主控台生成式 AI 可觀測性頁面和 CloudWatch Logs 中檢視收集的指標和追蹤。請參閱下列各節，了解如何檢視客服人員的指標。

在 Amazon CloudWatch 中使用生成式 AI 可觀測性檢視資料

CloudWatch 生成式 AI 可觀測性頁面會顯示 AgentCore 代理程式執行時間輸出的所有服務提供的指標，以及如果您已在代理程式程式碼中啟用檢測，則會顯示跨度和追蹤衍生的資料。若要在 CloudWatch 中檢視可觀測性儀表板，請開啟 Amazon CloudWatch GenAi 可觀測性頁面。

透過 CloudWatch 中的生成式 AI 可觀測性，您可以檢視具有圖形和其他資料視覺化的自訂儀表板，以及錯誤明細、追蹤視覺化等。若要進一步了解如何在 CloudWatch 中使用生成式 AI 可觀測性，包括如何查看代理程式的個別工作階段和追蹤資料，請參閱《Amazon CloudWatch 使用者指南》中的 Amazon Bedrock AgentCore 代理程式。 Amazon CloudWatch

在 CloudWatch 中檢視其他資料

所有服務提供的指標和範圍也可以在 CloudWatch 中檢視，以及檢測代理程式程式碼輸出的任何指標。

若要檢視此資料，請參閱下列各節。

日誌

  1. 開啟 CloudWatch 主控台。

  2. 在左側導覽窗格中，展開日誌，然後選取日誌群組

  3. 使用搜尋欄位來尋找代理程式、記憶體或閘道資源的日誌群組。

    AgentCore 代理程式日誌群組的格式如下：

    • 標準日誌 - stdout/stderr 輸出

      • 位置 ：/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>/【runtime-logs】 <UUID>

      • 包含 ：執行時間錯誤、應用程式日誌、偵錯陳述式

      • 範例用量：

        • print("處理請求... ") # 出現在標準日誌中

        • logging.info("成功處理請求") # 出現在標準日誌中

    • OTEL 結構化日誌 - 詳細操作資訊

      • 位置 ：/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>/otel-rt-logs

      • 包含 ：執行詳細資訊、錯誤追蹤、效能資料

      • 自動收集 ：不需要其他程式碼 - 由 ADOT 檢測產生

      • 優點：可以包含將日誌連結至相關追蹤的相互關聯 IDs

追蹤和跨度

追蹤可透過您的代理程式提供請求執行路徑的可見性：

  • 位置：客服人員日誌群組 (/aws/bedrock-agentcore/runtimes/<agent_id>-<endpoint_name>) spans 中的default日誌串流，或是使用共用跨度目的地的客服人員日誌群組中的aws/spans日誌串流。如需詳細資訊，請參閱 Amazon Bedrock AgentCore 執行時間中託管之代理程式的範圍目的地。

  • 存取方式：CloudWatch 交易搜尋主控台

  • 需求：必須啟用 CloudWatch 交易搜尋

追蹤會自動擷取：

  • 代理程式調用序列

  • 與架構元件 (LangChain 等） 整合

  • LLM 呼叫和回應

  • 工具調用和結果

  • 錯誤路徑和例外狀況

對於跨 服務的分散式追蹤，您可以使用標準 HTTP 標頭：

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

  • W3C 格式： traceparent: 00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01

若要檢視追蹤：

  • 導覽至 CloudWatch 主控台

  • 從左側導覽選取交易搜尋

  • 依服務名稱或其他條件篩選

  • 選取追蹤以檢視詳細的執行圖表

指標

如果您已如啟用 AgentCore 可觀測性 所述，透過檢測您的代理程式程式碼來啟用可觀測性，您的代理程式會自動產生 OTEL 指標，並使用增強型指標格式 (EMF) 傳送到 CloudWatch：

  • 命名空間：bedrock-agentcore

  • 透過 存取：CloudWatch Metrics 主控台

  • 內容：您的代理程式程式碼和架構所產生的自訂指標

  • 自動收集：不需要其他程式碼 - 由 ADOT 檢測產生

除了代理程式發出的指標之外，AgentCore 服務還會將標準服務指標發佈至 CloudWatch。如需這些指標的清單，請參閱 AgentCore 產生的執行時間可觀測性資料。