AI Agent指标定义文档
指标分类：
llm-client
实体分类：系统服务
覆盖实体模型：服务 / 服务实例
一、MCP 客户端指标
1.1 MCP 客户端耗时
| 属性 | 说明 |
|---|---|
| 指标 ID（服务实例） | one.service.instance.mcp.client.operation.duration |
| 指标 ID（服务） | one.service.mcp.client.operation.duration |
| 指标名称 | MCP 客户端耗时 |
| 指标类型 | Histogram |
| 显示 / 上报单位 | 秒（s） |
| 保留小数位数 | 2 |
| 指标来源 | OTEL 协议原生指标 |
| 基本判断 | 越低越好 |
| 异常类型 | 缓慢 |
| 相关实体 | 服务、服务实例、主机（服务实例级）；服务（服务级） |
描述
发送端观测到的 MCP 请求或通知耗时：从发送消息起，至收到响应或确认应答为止的时长。
The duration of the MCP request or notification as observed on the sender from the time it was sent until the response or ack is received.
相关维度
| 维度字段 | 说明 |
|---|---|
mcp.method.name | MCP 调用的方法名称 |
error.type | 错误类型 |
gen_ai.prompt.name | Prompt 名称 |
gen_ai.tool.name | 工具名称 |
rpc.response.status_code | RPC 响应状态码 |
gen_ai.operation.name | 操作类型 |
jsonrpc.protocol.version | JSON-RPC 协议版本 |
mcp.protocol.version | MCP 协议版本 |
network.protocol.name | 网络协议名称 |
network.protocol.version | 网络协议版本 |
network.transport | 传输层协议 |
mcp.resource.uri | MCP Resource URI |
1.2 MCP 客户端调用次数
| 属性 | 说明 |
|---|---|
| 指标 ID（服务实例） | one.service.instance.mcp.client.call.count |
| 指标 ID（服务） | one.service.mcp.client.call.count |
| 指标名称 | MCP 客户端调用次数 |
| 指标类型 | SUM |
| 显示 / 上报单位 | 次 |
| 保留小数位数 | 2 |
| 指标来源 | ONE 平台新增指标 |
| 基本判断 | 越高越好 |
| 异常类型 | 吞吐 |
| 相关实体 | 服务、服务实例、主机（服务实例级）；服务（服务级） |
描述
MCP 客户端发起请求的次数。
MCP client request count.
相关维度
与 1.1 MCP 客户端耗时 相同，共享维度字段。
二、生成式 AI 客户端指标
2.1 生成式 AI Token 消耗
| 属性 | 说明 |
|---|---|
| 指标 ID（服务实例） | one.service.instance.gen_ai.client.token.usage |
| 指标 ID（服务） | one.service.gen_ai.client.token.usage |
| 指标名称 | 生成式 AI Token 消耗 |
| 指标类型 | Histogram |
| 显示 / 上报单位 | token |
| 保留小数位数 | 2 |
| 基本判断 | 无 |
| 异常类型 | 资源 |
| 相关实体 | 服务、服务实例、主机（服务实例级）；服务（服务级） |
描述
AI 工具的 Token 消耗量。
AI Tool Token Consumption.
相关维度
| 维度字段 | 说明 |
|---|---|
gen_ai.operation.name | 操作类型，如 chat / embeddings 等 |
gen_ai.provider.name | AI 提供商，如 openai、anthropic 等 |
gen_ai.token.type | Token 类型（输入 / 输出） |
gen_ai.request.model | 请求使用的模型名称 |
2.2 生成式 AI 客户端耗时
| 属性 | 说明 |
|---|---|
| 指标 ID（服务实例） | one.service.instance.gen_ai.client.operation.duration |
| 指标 ID（服务） | one.service.gen_ai.client.operation.duration |
| 指标名称 | 生成式 AI 客户端耗时 |
| 指标类型 | Histogram |
| 显示 / 上报单位 | 秒（s） |
| 保留小数位数 | 2 |
| 基本判断 | 越低越好 |
| 异常类型 | 缓慢 |
| 相关实体 | 服务、服务实例、主机（服务实例级）；服务（服务级） |
描述
客户端发起交互到接受服务端响应完成的请求耗时。
Request Duration from Client Initiation to Server Response Completion.
相关维度
| 维度字段 | 说明 |
|---|---|
gen_ai.operation.name | 操作类型 |
gen_ai.provider.name | AI 提供商 |
error.type | 错误类型 |
gen_ai.request.model | 请求使用的模型名称 |
2.3 生成式 AI 请求次数
| 属性 | 说明 |
|---|---|
| 指标 ID（服务实例） | one.service.instance.gen_ai.client.call.count |
| 指标 ID（服务） | one.service.gen_ai.client.call.count |
| 指标名称 | 生成式 AI 请求次数 |
| 指标类型 | SUM |
| 显示 / 上报单位 | 次 |
| 保留小数位数 | 2 |
| 基本判断 | 越高越好 |
| 异常类型 | 吞吐 |
| 相关实体 | 服务、服务实例、主机（服务实例级）；服务（服务级） |
描述
发起大模型调用的次数。
Number of Large Model Invocations.
相关维度（服务实例级，含用户维度）
| 维度字段 | 说明 |
|---|---|
gen_ai.operation.name | 操作类型 |
gen_ai.provider.name | AI 提供商 |
error.type | 错误类型 |
gen_ai.request.model | 请求使用的模型名称 |
gen_ai.session.id | 会话 ID |
gen_ai.user.id | 用户 ID |
注：服务级（
one.service.gen_ai.client.call.count）不包含gen_ai.session.id和gen_ai.user.id维度。
三、指标汇总
| 指标名称 | 服务实例指标 ID | 服务指标 ID | 类型 | 单位 |
|---|---|---|---|---|
| MCP 客户端耗时 | one.service.instance.mcp.client.operation.duration | one.service.mcp.client.operation.duration | Histogram | s |
| MCP 客户端调用次数 | one.service.instance.mcp.client.call.count | one.service.mcp.client.call.count | SUM | 次 |
| 生成式 AI Token 消耗 | one.service.instance.gen_ai.client.token.usage | one.service.gen_ai.client.token.usage | Histogram | token |
| 生成式 AI 客户端耗时 | one.service.instance.gen_ai.client.operation.duration | one.service.gen_ai.client.operation.duration | Histogram | s |
| 生成式 AI 请求次数 | one.service.instance.gen_ai.client.call.count | one.service.gen_ai.client.call.count | SUM | 次 |