功能介绍
AgentArts观测功能支持统计三类数据来源：
| 数据来源 | 上报方式 | 说明 |
|---|---|---|
| 在AgentArts平台内创建的智能体 | 平台自动上报 | 智能体通过API调用后，系统自动采集并上报观测数据。 |
| 本地代码开发并托管至AgentArts平台运行的智能体 | 托管至AgentArts平台后上报 | 部署至AgentArts运行时后上报。通过API或AgentArts SDK调用后，自动采集并上报观测数据。如需查看上报的运行数据，请参考查看托管智能体数据。 |
| 非AgentArts平台开发的第三方智能体 | 通过OpenTelemetry上报 | 在平台创建智能体获取接入凭证，通过API接入（手动埋点）或SDK接入（安装可观测探针自动采集）将数据上报至AgentArts。 |
本章节介绍第三类：第三方智能体的观测数据上报。
如果您的智能体不是在AgentArts平台上开发或部署在AgentArts平台，可以通过以下两种方式将观测数据上报至平台：
- API接入：通过观测OpenAPI，手动埋点上报Trace（调用链）、Metric（指标）和Log（日志）数据。数据格式遵循OpenTelemetry（OTel）协议。
- SDK接入：安装华为云可观测探针（huaweicloud-instrument-python）并配置接入凭证，通过探针命令启动应用后，自动完成埋点与数据采集，无需修改业务代码。
| 对比维度 | API接入 | SDK接入 |
|---|---|---|
| 上报数据类型 | Trace、Metric、Log（三种独立上报） | Trace + Metric（自动采集上报） |
| 对OpenTelemetry的了解要求 | 需了解OTel基本概念（Span、Attribute、Metric等） | 无需了解，SDK内部封装处理 |
| Log上报 | 支持，通过LTS REST API上报 | 暂不支持，如需上报Log请使用API接入方式 |
- 如果您使用LangChain/LangGraph、AgentScope等主流框架开发智能体，推荐使用SDK接入，无需理解OpenTelemetry协议细节，接入成本更低。
- 如果您使用其他语言或框架，或需要上报Log数据，或需要精细控制上报字段，请使用API接入方式。
- 如果您不熟悉OpenTelemetry，可参考官方文档、OpenTelemetry字段映射进行了解，理解数据结构后再进行代码接入。
上报的数据类型
| 数据类型 | 说明 | API接入 | SDK接入 |
|---|---|---|---|
| Trace（调用链） | 记录一次完整请求的调用路径，包括各节点的调用顺序、耗时、输入输出等详情。 | √ | √ |
| Metric（指标） | 记录聚合统计信息，如请求次数、Token消耗量、成功率等。 | √ | √ |
| Log（日志） | 记录智能体运行过程中产生的日志信息，便于排查异常、追踪运行状态。 | √ | × |
数据上报流程
通过观测OpenAPI或SDK将数据上报至AgentArts的完整流程如下：
第一步：接入准备
登录AgentArts平台，在观测页面创建智能体实体，获取该智能体的接入地址、鉴权Token、智能体ID等凭证信息。无论选择API接入还是SDK接入，均需先完成此步骤。
第二步：选择接入方式，配置接入参数
根据您的开发框架和实际需求，选择以下任一方式：
- API接入：在智能体代码中手动配置OTel接入参数，通过创建Span、设置Attribute等方式埋点采集Trace和Metric数据，并通过LTS REST API上报Log数据。适用于任意语言或框架，支持Trace、Metric、Log三类数据的上报。
- SDK接入：安装华为云可观测探针并配置接入凭证，SDK将自动完成埋点与数据采集，无需手动创建Span。目前支持LangChain/LangGraph、AgentScope框架，支持Trace和Metric数据的自动上报。
第三步：查看上报数据
数据上报成功后，登录AgentArts平台，在"观测与优化 > 观测"页面各页签中查看和分析数据，包括调用链分析、智能体概览、会话分析等。
① 接入准备：在AgentArts平台创建智能体，获取接入地址、鉴权信息、智能体ID等
│
┌─────────────┴──────────────┐
▼ ▼
② API接入 ② SDK接入
手动埋点采集观测数据 集成SDK，自动采集观测数据
支持Trace / Metric / Log 支持Trace + Metric
│ │
└─────────────┬──────────────┘
▼
③ 在AgentArts观测页面查看数据（调用链分析、智能体概览、会话分析等） 典型场景：
- API接入场景：您使用自研框架或开源框架开发了智能体应用，希望通过手动埋点将运行数据精确上报至AgentArts进行监控分析。
- SDK接入场景：您使用LangChain/LangGraph/AgentScope构建了智能体应用，希望以最低成本快速接入AgentArts的观测能力，无需手动创建Span或设置Attribute，只需引入SDK并配置凭证即可自动采集调用链和指标数据。
上报的数据可以在AgentArts平台的观测页面各页签中查看和分析。
