使用 OpenTelemetry 在 Elastic 中实现 Claude 平台的人工智能 agent 可观测性

将 Claude 平台的追踪数据发送到 Elastic，整个交互轮次就会呈现在 Kibana 中。该服务会与技术栈中的其他服务一起出现在服务清单中，方便你观测它、创建告警规则和服务等级目标。

在你的数据所在之处构建和观测人工智能 agent。从 Elastic agent 构建器开始。你也可以立即开始免费云试用，或在你的本地计算机上试用 Elastic。

Claude 平台现已推出公开测试版的 agent 追踪导出功能，以遵循生成式人工智能语义约定的 OpenTelemetry 追踪数据形式导出。在 Claude 控制台中将 Elastic 添加为目标位置，你的托管 agent 交互轮次和消息接口调用就会传入 Elastic，无需修改应用代码。

打开一个交互轮次，即可按顺序查看模型请求、工具调用和模型上下文协议调用。每个跨度都包含耗时和词元计数，启用完整内容记录后，还会包含提示词和回复。你可以查看时间花在了哪里，甚至包括你无法控制的模型上下文协议服务器内部。

如果同时通过 Claude 软件开发工具包发送跨度，你自己的服务就能在同一条追踪中包裹 Claude 跨度。随后，claude-platform 会与技术栈中的其他服务一起出现在服务清单中，方便你观测它、创建告警规则和服务等级目标。

Claude 平台的人工智能 agent 可观测性在 Elastic 中如何呈现

在服务清单中打开 claude-platform，即可找到这些追踪数据。每个跨度都包含状态、时间信息和词元计数。

服务概览会显示延迟、吞吐量和事务失败率，服务地图则会显示哪个服务调用了它。

打开一条追踪，查看一个交互轮次的完整过程。

该跨度会呈现在**生成式人工智能（GenAI）**选项卡中，此功能在无服务器服务和 Elastic Cloud 托管服务 9.6 中以技术预览版提供，包含操作、模型、提供商和工具调用等详细信息。启用完整内容记录后，还会显示对话内容。在较旧版本中，相同数据以键值对形式显示。

你还可以在发现中使用 ES|QL 查询和探索追踪数据。

ini 复制代码

`

1.  FROM traces-*
2.  | WHERE service.name == "claude-platform"

`AI代码解释

从 Claude 控制台、你的应用程序或同时从两者发送追踪数据。使用 Claude 控制台了解应用程序编程接口执行的操作，使用软件开发工具包了解你自己的代码执行的步骤。如果你希望自己的追踪片段与 Claude 的追踪片段出现在同一条追踪中，请同时配置两者。

	从 Claude 控制台发送	从 Claude 软件开发工具包发送
采集的内容	托管 agent 的交互轮次和消息应用程序编程接口调用	在你自己的进程中执行的步骤，例如工具运行器、自定义工具或在你托管的沙箱中运行的工具
代码改动	无	在你的应用程序中配置导出器
追踪片段的来源	Anthropic，服务名称为 `claude-platform`	你自己的服务，包裹 `claude-platform` 的追踪片段
适用场景	你想了解应用程序编程接口执行的操作	你想了解自己的代码执行的步骤

将 Elastic 添加为目标后，Claude 就会发送托管 agent 和消息应用程序编程接口的追踪片段，无需更改你的应用程序代码。

你需要拥有 Claude 组织的管理员角色、托管 OTLP 端点，以及 Elastic 中可写入追踪数据的应用程序编程接口密钥。

打开你所在组织的 OpenTelemetry 设置，然后点击添加目标（Add destination）。
将提供商设置为 Elastic。
在 Kibana 的添加数据（Add data） → 应用程序（Application） → OpenTelemetry（OpenTelemetry） 下，复制托管 OTLP 端点并将其粘贴到相应位置。
点击端点旁边的创建密钥（Create key），然后粘贴获取的应用程序编程接口密钥。
选择内容模式（完整内容会保留对话，仅元数据则不包含对话），以及此目标应涵盖的工作区。
保存并点击测试（Test）。

点击测试后，在发现中运行以下查询。

ini 复制代码

`

1.  FROM traces-*
2.  | WHERE service.name == "claude-platform" AND span.name == "anthropic.test"

`AI代码解释

如果你看到一行结果，说明来自 Claude 控制台的测试追踪片段已到达 Elastic。

打开一条追踪，了解执行了哪些操作，并查看哪些方面可以优化。

模型请求、工具调用和所有模型上下文协议调用均按顺序排列，每个追踪片段都包含耗时和词元数量。你可以看到时间花在了模型、工具还是模型上下文协议服务器上。

打开该追踪片段的生成式人工智能选项卡，了解为什么会生成这样的回答。

运行的模型及追踪片段的其他详细信息。 操作、模型和词元数量可以告诉你运行了哪个模型，以及它消耗了多少词元。

完整内容会显示从头到尾的对话。下面重点介绍其中的几个内容块：

Claude 控制台的追踪数据会显示在服务 claude-platform 下。将软件开发工具包指向同一个端点后，你的追踪片段就会包裹 Claude 的追踪片段，从而让你的服务显示在服务地图上。

现在，它已与你技术栈的其他部分集中呈现，你可以针对 claude-platform 创建失败和延迟等告警规则，以便在某轮交互失败或耗时过长时收到通知。此外，你还可以为失败和延迟创建服务级别目标，以便持续观察是否有过多交互轮次失败或耗时过长。