# 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 为代码解释器和浏览器工具提供了以下内置指标。 Built-in 工具指标每隔一分钟进行批处理。要了解有关 AgentCore 工具的更多信息，请参阅使用 Amazon B [edrock 代码解释器执行 AgentCore 代码和分析数据以及使用 Amazon Bed](code-interpreter-tool.md) [rock AgentCore 浏览器与 Web 应用程序交互](browser-tool.md)。

 **调用工具：**

Invocations  
向数据平面 API 发出的请求总数。无论请求负载大小或响应状态如何，每个 API 调用都算作一次调用。

节流  
由于超过允许的 TPS（每秒交易量）或配额限制而被服务限制的请求数。这些请求返回时 ThrottlingException 带有 HTTP 状态码 429。

SystemErrors  
请求处理过程中遇到的服务器端错误的数量。

UserErrors  
因无效请求而导致的客户端错误数。这需要用户执行操作才能解决。

延迟  
从服务收到请求到开始发送第一个响应令牌之间经过的时间。对于测量初始响应时间很重要。

 **创建工具会话：**

Invocations  
向数据平面 API 发出的请求总数。无论请求负载大小或响应状态如何，每个 API 调用都算作一次调用。

节流  
由于超过允许的 TPS（每秒交易量）或配额限制而被服务限制的请求数。这些请求返回时 ThrottlingException 带有 HTTP 状态码 429。

SystemErrors  
请求处理过程中遇到的服务器端错误的数量。

UserErrors  
因无效请求而导致的客户端错误数。这需要用户执行操作才能解决。

延迟  
从服务收到请求到开始发送第一个响应令牌之间经过的时间。对于测量初始响应时间很重要。

Duration  
刀具会话的持续时间（操作变为 CodeInterpreterSession/BrowserSession）。

 **浏览器用户接管：**

TakerOverCount  
接管的用户总数

TakerOverReleaseCount  
释放控制权的用户总数

TakerOverDuration  
用户接管的持续时间

## 资源使用指标和日志
<a name="observability-tools-resource-usage-metrics-logs"></a>

Amazon Bedrock T AgentCore Built-in ools 提供全面的资源使用遥测功能，包括运行时资源的 CPU 和内存消耗指标。

**注意**  
资源使用情况数据最多可能延迟 60 分钟，并且精度可能因指标而异。

 **已售指标** 

默认情况下，Bedrock AgentCore Built-in Tools 以 1 分钟的分辨率出售账户级别和工具级别的指标。Amazon CloudWatch 聚合和指标数据保留遵循标准的亚马逊 CloudWatch 数据保留政策。有关更多信息，请参阅 [https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch\_concepts.html\#Metric](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Metric).


| Name | Dimensions | 说明 | 
| --- | --- | --- | 
| CPUUsed-vCPUHours | 服务；服务、资源 | 以 v 为CPU-Hours 单位消耗的虚拟 CPU 总量，在资源和账户级别可用。对于资源跟踪和预估账单可见性很有用。 | 
| MemoryUsed-GBHours | 服务；服务、资源 | 以单位为 GB-Hours 单位消耗的内存总量，在资源和账户级别上可用。对于资源跟踪和预估账单可见性很有用。 | 

维度说明
+  **服务**- AgentCore.CodeInterpreter 或 AgentCore.Browser
+  **资源**- Built-in 工具 ID

账户级别指标可在 Amazon B CloudWatch edrock 可 AgentCore 观察性控制台的 “**Built-in 工具**” 选项卡下找到。控制台上的仪表板将包含内存使用率图表和根据使用率指标生成的 CPU 使用率图表。这些图表显示了该地区账户中选定工具类型的所有工具的总资源使用情况。

工具级指标可在 Amazon B CloudWatch edrock 可 AgentCore 观察性控制台的 “**工具**” 页面中找到。控制台上的仪表板将包含内存使用率图表和根据使用率指标生成的 CPU 使用率图表。这些图表表示所选工具在所有会话中的总资源使用情况。

**注意**  
提供遥测数据是为了进行监控。实际账单是根据计量使用数据计算的，由于聚合时间、对账流程和测量精度，可能与遥测值不同。有关权威费用，请参阅您的 AWS 账单。

 **已售日志** 

Amazon Bedrock T AgentCore Built-in ools 能够以 1 秒的粒度为会话级别的使用情况遥测启用销售日志。每条日志记录包含 1 秒的资源使用数据。目前支持的指标包括：
+ 代码解释器代码Interpreter.vcpu.hours.used 和代码 Interpreter.memory.gb \_hours.used
+ 浏览器浏览器.vcpu.hours.used 和 browser.memory.gb\_hours.used

每个资源使用数据将在日志记录中使用以下架构。

 **代码解释器** 


| 日志类型 | 日志字段 | 说明 | 
| --- | --- | --- | 
| 使用日志 | event\_timestamp、resource\_arn、service.name、cloud.provider、cloud.region、accod.id、region.id、session.id、elapsed\_time\_seconds、code \_hours.used Interpreter.vcpu.hours.used Interpreter.memory.gb | 用于会话级资源跟踪的资源使用日志。 | 

 **浏览器** 


| 日志类型 | 日志字段 | 说明 | 
| --- | --- | --- | 
| 使用日志 | event\_timestamp、resource\_arn、service.name、cloud.provider、cloud.region、account.id、session.id、elapsed\_time\_seconds、浏览器.vcpu.hours.used、browser.memory.gb\_hours.used、browser.memory. | 用于会话级资源跟踪的资源使用日志。 | 

有关启用日志的更多信息，请参阅为您的 [Amazon Bedrock AgentCore 资源添加可观察性](observability-configure.md)。这些日志按照配置显示在目标（AWS LogGroup、Amazon S3 或 Amazon Kinesis Firehose）中。

在 Amazon B CloudWatch edrock 可 AgentCore 观察性控制台的 Built-in 工具会话页面中，您可以看到从这些日志生成的资源使用量指标。要优化指标查看体验，请使用右上角的选择器选择所需的时间范围，重点关注特定的 CPU 和内存使用率数据。

**注意**  
提供遥测数据是为了进行监控。实际账单是根据计量使用数据计算的，由于聚合时间、对账流程和测量精度，可能与遥测值不同。有关权威费用，请参阅您的 AWS 账单。

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

为了增强可观察性， AgentCore 提供了结构化跨度，以提供对内置工具 API 的可见性。要启用此跨度数据，您需要在内置工具资源上启用可观察性。有关步骤和详细信息[，请参阅为您的 Amazon Bedrock AgentCore 资源添加可观察性](observability-configure.md)。此跨度数据在日志组的 “ AWS CloudWatch 日 aws/spans 志” 中完整提供。下表定义了为其创建跨度的操作以及每个捕获的跨度的属性。

 **代码解释器** 


| 操作名称 | 跨度属性 | 说明 | 
| --- | --- | --- | 
| StartCodeInterpreterSession | aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、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.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.resource.type、aws.region、latency\_ms、error\_type | 使用输入代码调用代码解释器。 | 
| CodeInterpreterSessionExpire | aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、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.resource.type、aws.region、latency\_ms、error\_type | 启动浏览器会话。 | 
| StopBrowserSession | aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、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.resource.type、aws.region、latency\_ms、error\_type | Connect 连接到浏览器自动化流。 | 
| BrowserSessionExpire | aws.operation.name、aws.resource.arn、aws.request.id、aws.account.id、toolsession.id、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 志、Amazon S3 或 Firehose 流。如果您使用 CloudWatch 日志目标，则这些日志将存储在代理的应用程序日志下或您自己的自定义日志组下。


| 日志类型 | 日志字段 | 说明 | 
| --- | --- | --- | 
| 应用程序日志 | 时间戳、resource\_arn、event\_timestamp、账户 ID、request\_id、session\_id、trace\_id、span\_id、span\_id、service\_name、操作、请求负载、响应负载 |  InvokeCodeInterpreter 包含跟踪字段、请求和响应负载的应用程序日志 |