# AgentCore 產生的內建工具可觀測性資料
<a name="observability-tool-metrics"></a>

**Topics**
+ [可觀測性工具指標](#observability-tools-metrics-one)
+ [資源用量指標和日誌](#observability-tools-resource-usage-metrics-logs)
+ [提供的跨度資料](#observability-tools-span-data)
+ [應用程式日誌資料](#observability-tools-application-log-data)

## 可觀測性工具指標
<a name="observability-tools-metrics-one"></a>

AgentCore 為程式碼解譯器和瀏覽器工具提供下列內建指標。內建工具指標每隔一分鐘批次處理一次。若要進一步了解 AgentCore 工具，請參閱[使用 Amazon Bedrock AgentCore Code Interpreter 執行程式碼和分析資料](code-interpreter-tool.md)，以及[使用 Amazon Bedrock AgentCore 瀏覽器與 Web 應用程式互動](browser-tool.md)。

 **叫用工具：**

調用  
對資料平面 API 提出的請求總數。無論請求承載大小或回應狀態為何，每個 API 呼叫都會計為一個叫用。

限流  
服務因超過允許的 TPS （每秒交易數） 或配額限制而調節的請求數量。這些請求會使用 HTTP 狀態碼 429 傳回 ThrottlingException。

SystemErrors  
在請求處理期間遇到的伺服器端錯誤數目。

UserErrors  
因請求無效而導致的用戶端錯誤數目。這需要使用者動作才能解決。

延遲  
從服務收到請求到開始傳送第一個回應字符所經過的時間。對於測量初始回應時間很重要。

 **建立工具工作階段：**

調用  
對資料平面 API 提出的請求總數。無論請求承載大小或回應狀態為何，每個 API 呼叫都會計為一個叫用。

限流  
服務因超過允許的 TPS （每秒交易數） 或配額限制而調節的請求數量。這些請求會使用 HTTP 狀態碼 429 傳回 ThrottlingException。

SystemErrors  
在請求處理期間遇到的伺服器端錯誤數目。

UserErrors  
因請求無效而導致的用戶端錯誤數目。這需要使用者動作才能解決。

延遲  
從服務收到請求到開始傳送第一個回應字符所經過的時間。對於測量初始回應時間很重要。

持續時間  
工具工作階段的持續時間 （操作會變成 CodeInterpreterSession/BrowserSession)。

 **瀏覽器使用者接管：**

TakerOverCount  
接管使用者總數

TakerOverReleaseCount  
使用者釋出控制項的總數

TakerOverDuration  
使用者接管的持續時間

## 資源用量指標和日誌
<a name="observability-tools-resource-usage-metrics-logs"></a>

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](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 資源](observability-configure.md)。這些日誌會依設定顯示在目的地中 (AWS LogGroup、Amazon S3 或 Amazon Kinesis Firehose。

在 Amazon CloudWatch Bedrock AgentCore 可觀測性主控台的內建工具工作階段頁面中，您可以查看從這些日誌產生的資源用量指標。若要最佳化指標檢視體驗，請使用右上角的選擇器選取所需的時間範圍，以專注於特定的 CPU 和記憶體用量資料。

**注意**  
提供遙測資料用於監控目的。實際計費是根據計量用量資料計算，並且可能因彙總時間、對帳程序和測量精確度而與遙測值不同。如需授權費用，請參閱您的 AWS 帳單。

## 提供的跨度資料
<a name="observability-tools-span-data"></a>

為了增強可觀測性，AgentCore 提供結構化範圍，提供內建工具 APIs可見性。若要啟用此跨度資料，您需要在內建工具資源上啟用可觀測性。如需步驟和詳細資訊，請參閱將[可觀測性新增至 Amazon Bedrock AgentCore 資源](observability-configure.md)。此跨度資料可在 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 且工作階段逾時，則程式碼解譯器工作階段會過期。 | 

## 應用程式日誌資料
<a name="observability-tools-application-log-data"></a>

AgentCore 提供結構化應用程式日誌，協助您了解客服人員執行期調用和工作階段層級的資源耗用。在代理程式資源上啟用可觀測性時，會提供此日誌資料。如需步驟和詳細資訊，請參閱將[可觀測性新增至 Amazon Bedrock AgentCore 資源](observability-configure.md)。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 應用程式日誌 |