全部文档
当前文档

热搜词推荐

云服务器 虚拟私有网络 边缘节点计算 对等连接

相关产品

共搜索到 0 条结果

暂无内容

如果没有找到您期望的内容，请尝试其他搜索词

文档中心

云监控

查看更多结果
未找到含当前关键字的文档标题
页面目录
全部展开全部收起
未找到含该关键词的产品
文档中心 云监控 快速入门 AI应用可观测 埋点字段与指标说明

埋点字段与指标说明

最近更新时间：2026-07-06 16:36:31

AI 应用监控针对智能体场景提供一套埋点监控方案，涵盖 分布式追踪（Tracing） 和 指标监控（Metrics） 两大核心模块。这些埋点信息将随 OpenTelemetry 社区的发展而不断更新和优化，本文为您具体介绍埋点相关的详细信息。

Span Attributes

针对大模型的 Trace Span，添加额外 Gen AI attributes 以记录追踪大模型耗时、Token 消耗数等。主要包括以下字段：

字段

类型

说明

trace_id

string

链路追踪 ID

span_id

string

Span ID

name

string

Span 名称，如 ChatOpenAI.chat、POST、execute_tool search_database

kind

int

Span 类型：1=INTERNAL, 2=SERVER, 3=CLIENT, 4=PRODUCER, 5=CONSUMER

start_time_unix_nano

int

开始时间（纳秒时间戳）

end_time_unix_nano

int

结束时间（纳秒时间戳）

duration

int

持续时间（纳秒）

flags

int

标志位

status_code

string

OTEL spec 定义为 string "OK"/"ERROR"，部分后端输出 SDK 内部枚举值。成功的 span 通常不设置 status_code 字段（即 UNSET）。

"0"=UNSET

"1"=OK

"2"=ERROR

error.type

string

错误分类

ConnectionError, RateLimitError

操作与提供商

字段

类型

说明

示例

gen_ai.operation.name

string

操作类型

chat, execute_tool

gen_ai.provider.name

string

提供商

openai, langchain

请求

字段

类型

说明

示例

gen_ai.request.model

string

请求的模型名

deepseek-v4-flash

gen_ai.request.temperature

string

温度参数

"0"

gen_ai.input.messages

string

输入消息（JSON）

[{"role":"user","parts":[{"type":"text","content":"Hello"}]}]

响应

字段

类型

说明

示例

gen_ai.response.model

string

实际返回的模型名

deepseek-v4-flash

gen_ai.response.id

string

响应 ID

873180ef-0a08-47e4-ad6c-f37977fb4bf9

gen_ai.response.finish_reasons

string

结束原因（JSON 数组）

["stop"]

gen_ai.output.messages

string

输出消息（JSON）

[{"role":"assistant","parts":[{"type":"text","content":"ok"}],"finish_reason":"stop"}]

Token 用量

字段

类型

说明

示例

gen_ai.usage.input_tokens

string

输入 token 总数（含缓存）

"11"

gen_ai.usage.output_tokens

string

输出 token 数

"33"

gen_ai.usage.total_tokens

string

总 token 数

"44"

gen_ai.usage.cache_read.input_tokens

string

从缓存读取的输入 token

"0"

Tool

字段

类型

说明

gen_ai.tool.name

string

Tool 名称

gen_ai.tool.type

string

Tool 类型：function

gen_ai.tool.description

string

Tool 描述

gen_ai.tool.call.arguments

string

调用参数（JSON）

会话

字段

类型

说明

gen_ai.conversation.id

string

会话id

Resource

描述服务和 SDK 的元信息，所有 span 共享。

字段

类型

说明

示例

service.name

string

服务名称

error-demo

telemetry.sdk.name

string

SDK 名称

opentelemetry

telemetry.sdk.language

string

SDK 语言

python

telemetry.sdk.version

string

SDK 版本

1.42.0

Scope

描述 instrumentation 来源。

字段

类型

说明

示例

scope_name

string

instrumentor 名称

opentelemetry.instrumentation.langchain

scope_version

string

instrumentor 版本

0.60.0

Metrics

为更好统计大模型的性能和 Token 消耗数，针对大模型记录了相关 Metrics 指标，可以在 AI 应用监控界面上查看，也可以在自定义大盘构建大盘。大模型指标 Label 如下：

服务相关指标

指标名：gen_ai_service_up ，维度列表如下：

维度名称

含义

示例

备注

ingestion_source

接入来源

langfuse

service_name

服务名称

agno-final-langfuse

等价于其他指标中service.name维度

service_type

服务类型

ai agent

telemetry_sdk_language

sdk语言

python

等价于其他指标中telemetry.sdk.language维度

telemetry_sdk_name

sdk名称

opentelemetry

等价于其他指标中telemetry.sdk.name维度

telemetry_sdk_version

sdk版本

1.42.1

等价于其他指标中telemetry.sdk.version维度

user_id

用户id

73401193

会话相关指标

指标名：gen_ai_session_up ，维度列表如下：

维度名称

含义

示例

备注

ingestion_source

接入来源

langfuse

service_name

服务名称

agno-final-langfuse

等价于其他指标中service.name 维度

service_type

服务类型

ai agent

telemetry_sdk_language

sdk语言

python

等价于其他指标中telemetry.sdk.language维度

telemetry_sdk_name

sdk名称

opentelemetry

等价于其他指标中telemetry.sdk.name 维度

telemetry_sdk_version

sdk版本

1.42.1

等价于其他指标中telemetry.sdk.version维度

user_id

用户id

73401193

session_id

会话id

6414c005-8fd5-4b78-98ae-d37915a6bfc7

Token 使用相关指标

指标名：gen_ai_client_token_usage_(count、sum、bucket) ，维度列表如下：

维度名称

含义

示例

备注

gen_ai.provider.name

LLM提供者

openai

gen_ai.response.model

LLM名称

glm-5

service.name

服务名称

agno-final-langfuse

等价于其他指标中service_name维度

gen_ai.token.type

token使用类型

input

telemetry.sdk.language

sdk语言

python

等价于其他指标中telemetry_sdk_language维度

telemetry.sdk.name

sdk名称

opentelemetry

等价于其他指标中telemetry_sdk_name维度

telemetry.sdk.version

sdk版本

1.42.1

等价于其他指标中telemetry_sdk_version维度

server.address

llm地址

https://kspmas.ksyun.com/v1/

可选

gen_ai.operation.name

操作名称

chat

可选

stream

是否流式

false

可选

LLM 操作相关指标

指标名：gen_ai_client_operation_duration_(count、sum、bucket），维度列表如下：

维度名称

含义

示例

备注

gen_ai.provider.name

LLM提供者

openai

gen_ai.response.model

LLM名称

glm-5

service.name

服务名称

agno-final-langfuse

等价于其他指标中service_name维度

gen_ai.token.type

token使用类型

input

telemetry.sdk.language

sdk语言

python

等价于其他指标中telemetry_sdk_language维度

telemetry.sdk.name

sdk名称

opentelemetry

等价于其他指标中telemetry_sdk_name维度

telemetry.sdk.version

sdk版本

1.42.1

等价于其他指标中telemetry_sdk_version维度

server.address

llm地址

https://kspmas.ksyun.com/v1/

可选

gen_ai.operation.name

操作名称

chat

可选

stream

是否流式

false

可选

文档导读
上一篇：服务总览
下一篇：Trace 分析
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈