# 功能介绍
AgentArts观测功能支持统计三类数据来源：
表1AgentArts观测数据来源 
| 数据来源                        | 上报方式              | 说明                                                                                                                                                        |
|:---|:---|:---|
| 在AgentArts平台内创建的智能体         | 平台自动上报            | 智能体通过API调用后，系统自动采集并上报观测数据。                                                                                                                                |
| 本地代码开发并托管至AgentArts平台运行的智能体 | 托管至AgentArts平台后上报 | 部署至AgentArts运行时后上报。通过API或AgentArts SDK调用后，自动采集并上报观测数据。如需查看上报的运行数据，请参考[查看高代码应用运行数据](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0014.html)。 |
| 非AgentArts平台开发的第三方智能体       | 对接观测OpenAPI上报     | 通过对接观测OpenAPI进行数据上报。                                                                                                                                      |
   
**本章节介绍第三类：第三方智能体的观测数据上报。**
如果您的智能体不是在AgentArts平台上开发或部署在AgentArts平台，可以通过观测OpenAPI，将智能体的Trace（调用链）、Metric（指标）和Log（日志）数据上报至平台。其中Trace和Metric数据格式遵循OpenTelemetry（OTel）协议（一种开源的可观测性标准协议），开发者可以使用OTel SDK进行对接；Log数据通过调用LTS REST API进行上报。
**典型场景**：您已使用LangChain等框架开发了智能体应用，希望借助AgentArts的观测能力监控其调用链路、分析Token消耗和排查异常，此时可通过OpenTelemetry协议将运行数据上报至AgentArts。
![](https://support.huaweicloud.com/ops-agentarts/public_sys-resources/note_3.0-zh-cn.png)
**如果您不熟悉OpenTelemetry，可参考[官方文档](https://opentelemetry.io/docs/what-is-opentelemetry/)、[OpenTelemetry字段映射](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0127.html)了解，理解数据结构后再进行代码接入。**
#### 上报的数据类型
表2上报的数据类型 
| 数据类型       | 说明                                   |
|:---|:---|
| Trace（调用链） | 记录一次完整请求的调用路径，包括各节点的调用顺序、耗时、输入输出等详情。 |
| Metric（指标） | 记录聚合统计信息，如请求次数、Token消耗量、成功率等。        |
| Log（日志）    | 记录智能体运行过程中产生的日志信息，便于排查异常、追踪运行状态。     |
   
#### 数据上报流程
通过观测OpenAPI上报数据时，开发者需要在智能体代码中埋点采集观测数据（例如创建Span、设置Attribute等），并通过OpenAPI将数据发送至AgentArts。这种方式需要开发者对OpenTelemetry的基本概念和使用方式（如Span、Attribute、Metric）有一定了解，并需要修改业务代码添加上报逻辑。
数据上报流程如下：
```
① 在AgentArts平台创建智能体，获取接入地址、鉴权信息、智能体ID等信息
        │
        ▼
② 在外部智能体代码中配置接入参数，埋点采集观测数据
        │
        ▼
③ 在AgentArts观测页面查看数据（调用链分析、智能体概览、会话分析等）
```
上报的数据可以在AgentArts平台的观测页面各页签中查看和分析。
![](https://support.huaweicloud.com/ops-agentarts/public_sys-resources/note_3.0-zh-cn.png)
上报的Trace和Metric数据将分别上报至应用性能管理APM和应用运维管理AOM服务，上报的Log数据将写入云日志服务LTS，**可能产生相应费用** 。APM和AOM采用按需计费并提供一定量的免费额度，超出部分按实际使用量计费。详细计费规则请参考[APM计费说明](https://support.huaweicloud.com/price-apm2/apm_07_0019.html)、[AOM计费说明](https://support.huaweicloud.com/price-aom2/aom_07_0004.html)和[LTS计费说明](https://support.huaweicloud.com/price-lts/lts-03216.html)。