本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 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 工具的更多信息，请参阅使用亚马逊基岩代码解释器[执行 AgentCore 代码](code-interpreter-tool.md)和分析数据以及使用亚马逊基岩浏览器与网络应用程序[进行交互。 AgentCore ](browser-tool.md)

 **调用工具：**

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

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

SystemErrors  
请求处理期间遇到的服务器端错误的数量。

UserErrors  
由无效请求导致的客户端错误的数量。这需要用户采取行动才能解决。

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

 **创建工具会话：**

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

节流  
由于超过允许的 TPS（每秒交易量）或配额限制而被服务限制的请求数量。这些请求返回 HT ThrottlingException TP 状态码 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 分钟的分辨率提供账户等级和工具级别的指标。亚马逊 CloudWatch 汇总和指标数据保留遵循标准的亚马逊 CloudWatch 数据保留政策。有关更多信息，请参阅 [ https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch\_concepts.html \#Metric ](https://docs.amazonaws.cn/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Metric)。


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

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

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

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

**注意**  
遥测数据是为监控目的而提供的。实际账单是根据计量使用数据计算的，由于汇总时间、对账过程和测量精度，可能与遥测值有所不同。有关权威费用，请参阅您的 Amazon 账单账单。

 **已售日志 ** 

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

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

 **代码解释器 ** 


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

 **浏览器** 


| 日志类型 | 日志字段 | 说明 | 
| --- | --- | --- | 
| 使用日志 | event\_timestamp、resource\_arn、服务名称、云提供商、云区域、账户 ID、区域、资源ID、会话.id、会话.id、elapsed\_time\_seconds、browser.vcpu.hours.used、browser.memory.gb\_hours.used | 用于会话级资源跟踪的资源使用日志。 | 

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

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

**注意**  
遥测数据是为监控目的而提供的。实际账单是根据计量使用数据计算的，由于汇总时间、对账过程和测量精度，可能与遥测值有所不同。有关权威费用，请参阅您的 Amazon 账单账单。

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

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

 **代码解释器 ** 


| 操作名称 | 跨度属性 | 说明 | 
| --- | --- | --- | 
| 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、错误类型、会话持续时间\_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、错误类型、会话持续时间\_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、错误类型、会话持续时间\_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、错误类型、会话持续时间\_s | 如果 StopBrowserSession 未调用代码解释器会话且会话超时，则使该会话过期。 | 

## 应用程序日志数据
<a name="observability-tools-application-log-data"></a>

AgentCore 提供结构化应用程序日志，可帮助您了解代理运行时调用和会话级资源消耗。此日志数据是在代理资源上启用可观察性时提供的。有关步骤和详细信息，请参阅为您的亚马逊 Bedrock AgentCore 资源[添加可观察性](observability-configure.md)。 AgentCore 可以将日志输出到日 CloudWatch 志、亚马逊 S3 或 Firehose 数据流。如果您使用 CloudWatch 日志目标，则这些日志存储在代理的应用程序日志下或您自己的自定义日志组下。


| 日志类型 | 日志字段 | 说明 | 
| --- | --- | --- | 
| 应用程序日志 | 时间戳、resource\_arn、事件时间戳、账户 ID、请求 ID、会话 ID、trace\_id、ssan\_id、span\_id、服务名称、操作、请求负载、响应负载 |  InvokeCodeInterpreter 包含跟踪字段、请求和响应有效载荷的应用程序日志 |