AgentCore 產生的內建工具可觀測性資料
可觀測性工具指標
AgentCore 為程式碼解譯器和瀏覽器工具提供下列內建指標。內建工具指標每隔一分鐘批次處理一次。若要進一步了解 AgentCore 工具，請參閱使用 Amazon Bedrock AgentCore Code Interpreter 執行程式碼和分析資料，以及使用 Amazon Bedrock AgentCore 瀏覽器與 Web 應用程式互動。
叫用工具：
- 調用
-
對資料平面 API 提出的請求總數。無論請求承載大小或回應狀態為何，每個 API 呼叫都會計為一個叫用。
- 限流
-
服務因超過允許的 TPS （每秒交易數） 或配額限制而調節的請求數量。這些請求會使用 HTTP 狀態碼 429 傳回 ThrottlingException。
- SystemErrors
-
在請求處理期間遇到的伺服器端錯誤數目。
- UserErrors
-
因請求無效而導致的用戶端錯誤數目。這需要使用者動作才能解決。
- 延遲
-
從服務收到請求到開始傳送第一個回應字符所經過的時間。對於測量初始回應時間很重要。
建立工具工作階段：
- 調用
-
對資料平面 API 提出的請求總數。無論請求承載大小或回應狀態為何，每個 API 呼叫都會計為一個叫用。
- 限流
-
服務因超過允許的 TPS （每秒交易數） 或配額限制而調節的請求數量。這些請求會使用 HTTP 狀態碼 429 傳回 ThrottlingException。
- SystemErrors
-
在請求處理期間遇到的伺服器端錯誤數目。
- UserErrors
-
因請求無效而導致的用戶端錯誤數目。這需要使用者動作才能解決。
- 延遲
-
從服務收到請求到開始傳送第一個回應字符所經過的時間。對於測量初始回應時間很重要。
- 持續時間
-
工具工作階段的持續時間 （操作會變成 CodeInterpreterSession/BrowserSession)。
瀏覽器使用者接管：
- TakerOverCount
-
接管使用者總數
- TakerOverReleaseCount
-
使用者釋出控制項的總數
- TakerOverDuration
-
使用者接管的持續時間
資源用量指標和日誌
Amazon Bedrock AgentCore 內建工具提供全面的資源用量遙測，包括執行時間資源的 CPU 和記憶體耗用指標。
注意
資源用量資料最多可延遲 60 分鐘，且精確度可能因指標而異。
已取代的指標
根據預設，Bedrock AgentCore 內建工具以 1 分鐘的解析度提供帳戶層級和工具層級的指標。Amazon CloudWatch 彙總和指標資料保留遵循標準 Amazon CloudWatch 資料保留政策。如需詳細資訊，請參閱 https：//https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Metric。
| 名稱 | 維度 | 說明 |
|---|---|---|
|
CPUUsed-vCPUHours |
服務；服務、資源 |
vCPU-Hours 單位中消耗的虛擬 CPU 總量，可在資源和帳戶層級取得。適用於資源追蹤和估計帳單可見性。 |
|
MemoryUsed-GBHours |
服務；服務、資源 |
以 GB-Hours 單位為單位耗用的記憶體總量，可用於資源和帳戶層級。適用於資源追蹤和估計帳單可見性。 |
維度說明
-
Service - AgentCore.CodeInterpreter 或 AgentCore.Browser
-
資源 - 內建工具 ID
帳戶層級指標可在內建工具索引標籤下的 Amazon CloudWatch Bedrock AgentCore 可觀測性主控台中使用。主控台上的儀表板將包含記憶體用量圖表和從用量指標產生的 CPU 用量圖表。這些圖表代表 區域中帳戶中所選工具類型之所有工具的總資源使用量。
工具層級指標可在 Amazon CloudWatch Bedrock AgentCore 可觀測性主控台的工具頁面中取得。主控台上的儀表板將包含記憶體用量圖表和從用量指標產生的 CPU 用量圖表。圖表代表所選工具所有工作階段的總資源用量。
注意
提供遙測資料用於監控目的。實際計費是根據計量用量資料計算，並且可能因彙總時間、對帳程序和測量精確度而與遙測值不同。如需授權費用，請參閱您的 AWS 帳單。
已取代的日誌
Amazon Bedrock AgentCore 內建工具可讓您以 1 秒精細程度啟用工作階段層級用量遙測的付費日誌。每個日誌記錄包含 1 秒的資源用量基準。目前支援的指標包括：
-
Code Interprefer codeInterpreter.vcpu.hours.used 和 codeInterpreter.memory.gb_hours.used
-
瀏覽器 瀏覽器.vcpu.hours.used 和 瀏覽器.memory.gb_hours.used
每個資源用量基準將使用日誌記錄中的下列結構描述。
程式碼解譯器
| 日誌類型 | 日誌欄位 | 說明 |
|---|---|---|
|
USAGE_LOGS |
event_timestamp， resource_arn， service.name， cloud.provider， cloud.region， account.id， region， resource.id， session.id， elapsed_time_seconds， codeInterpreter.vcpu.hours.used, codeInterpreter.memory.gb_hours.used |
用於工作階段層級資源追蹤的資源用量日誌。 |
瀏覽器
| 日誌類型 | 日誌欄位 | 說明 |
|---|---|---|
|
USAGE_LOGS |
event_timestamp， resource_arn， service.name， cloud.provider， cloud.region， account.id， region， resource.id， session.id， elapsed_time_seconds， 瀏覽器.vcpu.hours.used， 瀏覽器.memory.gb_hours.used |
用於工作階段層級資源追蹤的資源用量日誌。 |
如需啟用日誌的詳細資訊，請參閱將可觀測性新增至 Amazon Bedrock AgentCore 資源。這些日誌會依設定顯示在目的地中 (AWS LogGroup、Amazon S3 或 Amazon Kinesis Firehose。
在 Amazon CloudWatch Bedrock AgentCore 可觀測性主控台的內建工具工作階段頁面中，您可以查看從這些日誌產生的資源用量指標。若要最佳化指標檢視體驗，請使用右上角的選擇器選取所需的時間範圍，以專注於特定的 CPU 和記憶體用量資料。
注意
提供遙測資料用於監控目的。實際計費是根據計量用量資料計算，並且可能因彙總時間、對帳程序和測量精確度而與遙測值不同。如需授權費用，請參閱您的 AWS 帳單。
提供的跨度資料
為了增強可觀測性，AgentCore 提供結構化範圍，提供內建工具 APIs可見性。若要啟用此跨度資料，您需要在內建工具資源上啟用可觀測性。如需步驟和詳細資訊，請參閱將可觀測性新增至 Amazon Bedrock AgentCore 資源。此跨度資料可在 aws/spans 日誌群組的完整 in AWS CloudWatch Logs 中使用。下表定義建立範圍的操作，以及每個擷取範圍的屬性。
程式碼解譯器
| 操作名稱 | 跨度屬性 | 說明 |
|---|---|---|
|
StartCodeInterpreterSession |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、 latency_ms、 error_type |
啟動程式碼解譯器工作階段。 |
|
StopCodeInterpreterSession |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、 latency_ms、 error_type、 session_duration_s |
停止程式碼解譯器工作階段。 |
|
InvokeCodeInterpreter |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、 latency_ms、 error_type |
使用輸入碼調用程式碼解譯器。 |
|
CodeInterpreterSessionExpire |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、 latency_ms、 error_type、 session_duration_s |
如果未呼叫 StopCodeInterpreterSession 且工作階段逾時，則程式碼解譯器工作階段會過期。 |
-
toolsession.id - 工具工作階段的 ID
-
session_duration_s - 工作階段結束之前的秒數
瀏覽器
| 操作名稱 | 跨度屬性 | 說明 |
|---|---|---|
|
StartBrowserSession |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、 latency_ms、 error_type |
啟動瀏覽器工作階段。 |
|
StopBrowserSession |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、 latency_ms、 error_type、 session_duration_s |
停止瀏覽器工作階段。 |
|
ConnectBrowserAutomationStream |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、 latency_ms、 error_type |
連線至瀏覽器自動化串流。 |
|
BrowserSessionExpire |
aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、aws.xray.origin、aws.resource.type、aws.region、 latency_ms、 error_type、 session_duration_s |
如果未呼叫 StopBrowserSession 且工作階段逾時，則程式碼解譯器工作階段會過期。 |
應用程式日誌資料
AgentCore 提供結構化應用程式日誌，協助您了解客服人員執行期調用和工作階段層級的資源耗用。在代理程式資源上啟用可觀測性時，會提供此日誌資料。如需步驟和詳細資訊，請參閱將可觀測性新增至 Amazon Bedrock AgentCore 資源。AgentCore 可以將日誌輸出到 CloudWatch Logs、Amazon S3 或 Firehose 串流。如果您使用 CloudWatch Logs 目的地，這些日誌會存放在代理程式的應用程式日誌下，或存放在您自己的自訂日誌群組下。
| 日誌類型 | 日誌欄位 | 說明 |
|---|---|---|
|
APPLICATION_LOGS |
時間戳記， resource_arn， event_timestamp， account_id， request_id， session_id， trace_id， span_id， service_name， operation， request_payload， response_payload |
具有追蹤欄位、請求和回應承載的 InvokeCodeInterpreter 應用程式日誌 |
