本章节介绍日志服务应用市场提供的大模型观测日志应用 HermesAgent 观测。

概述

通过接入 HermesAgent 观测应用观察数据，提供 HermesAgent 观测大盘、Trace 调用链等服务。

前提条件

类别	说明
地域限制	部署 HermesAgent 的服务器与日志服务为同一地域（Region），确保网络连通。
鉴权方式	根据不同的鉴权方式，获取用户 Access Key ID、Secret Access Key 或 APIKey。 AK/SK：火山引擎账号的 AccessKey ID、AccessKey Secret。在火山引擎控制台密钥管理页面获取。推荐使用 IAM 用户密钥，请确认该用户具备相关的操作权限，详情可参考IAM 概述。支持自动创建日志服务资源（Project/App/Topic），并自动生成日志主题 ID。 API Key：请求火山日志服务的重要凭证，仅用于 Log、Metric、Trace 的数据上报。严格收敛权限、不支持自动创建日志服务资源。适合多机房与权限管控严格场景。说明 API Key 为邀测功能，若有相关业务需求，可联系客户经理开通白名单。

一接入 HermesAgent 日志应用

参数	说明
Region	接入日志应用数据存放的地域。
日志项目	选择存放日志应用数据的日志项目。说明日志应用创建成功后，将会在该日志项目中，自动创建携带HERMESAGENT标签的日志主题，用于存放 trace 数据和日志数据。该日志主题相关信息如下：日志主题名称：应用名称_trace、应用名称_log 分区数量：2 日志存储时长：标准存储 90 天索引：自动配置键值索引。
应用名称	输入 HermesAgent 日志应用的名称。长度为3-64个字符。只能包含中文、小写字母、数字、下划线_和连字符-。不能以连字符-和下划线_开头/结尾。不能tls_、tos_以及部分预留字段开头。
描述	日志应用描述信息。长度限制为0-128个字符。

二安装 HermesAgent 插件接入应用数据

监控图表详情

日志服务 HermesAgent 观测应用观测监控图表详情如下：

类型	图表
Hermes 观测大盘	模型调用：总 Tokens、单日 Tokens、输入 Tokens、输出 Tokens、Cache Read Tokens、Cache Write Tokens、Reasoning Tokens、Prompt Tokens、模型 Tokens 消耗分布、Provider Tokens 消耗分布、Platform Tokens 消耗分布、请求次数、单日模型调用次数、模型调用耗时P90 Session 分析：新增 Session 数、单日新建 Session 数、单日对话次数、新建 Session Platform 分布、新建 Session 模型分布、对话 Platform 分布、对话模型分布、对话数、对话耗时P90 工具调用工具调用总次数、单日工具调用次数、工具调用耗时P90、工具调用耗时P90分布、工具调用分布、工具调用失败分布、工具调用成功次数、工具调用失败次数运维分析 Error 日志分布、单日 Error 日志
Trace 调用链	Trace 分析展示指定调用链的 TraceId、状态、总耗时（ms）、开始时间、结束时间等。
Topic 列表	展示当前日志应用产生的日志类型、日志项目和日志主题及描述信息等。

管理我的应用

日志应用接入成功后，支持对已接入的日志应用进行相关管理操作：

AgentLoop

应用市场

应用名称_trace（日志主题）日志字段

字段	类型	说明
Attributes	json	Span 上挂载的自定义键值对，记录业务相关信息。
Duration	long	Span 持续时长（End - Start），衡量该操作的耗时。
End	long	Span 结束时间。
Events	text	Span 生命周期内发生的事件。
Host	text	运行服务的主机。
Kind	text	Span 的类型。
Links	text	关联其他 Span 的引用（用于跨 Trace 关联，比如异步任务场景）。
Name	text	Span 的名称，通常是操作描述。
OTLPName	text	通过 OTLP 协议上报时的原始名称（OTLP = OpenTelemetry Line Protocol）。
OTLPVersion	text	使用的 OTLP 协议版本号。
ParentSpanID	text	父 Span 的 ID，表示当前操作是被哪个操作触发的，根节点此字段为空。
Resource	json	一组描述服务本身的属性集合（比 ServiceName 更全），如服务名、版本、运行环境等。
ServiceName	text	产生这条 Span 的服务名称。
SpanID	text	当前 Span 的唯一 ID。
Start	long	Span 开始时间。
StatusCode	text	Span 的执行结果。
StatusDescription	text	Span 的执行结果的补充说明。
TracelD	text	整条调用链的 TracelD，同一次请求的所有 Span 共享同一个 TraceID。
TraceState	text	自定义的追踪上下文元数据。

Attributes

字段	类型	说明
gen_ai.platform.name	text	AI 观测平台名称。
gen_ai.provider.name	text	模型服务商名称。
gen_ai.request.model	text	请求指定的模型名。
gen_ai.usage.cache_read_tokens	long	命中 KV Cache 的读取 Token 数。
gen_ai.usage.cache_write_tokens	long	命中 KV Cache 的写入 Token 数。
gen_ai.usage.input_tokens	long	本次请求消耗的输入 Token 数。
gen_ai.usage.output_tokens	long	本次请求消耗的输出 Token 数。
gen_ai.usage.prompt_tokens	long	Prompt 部分的 token 数。
gen_ai.usage.reasoning_tokens	long	Reasoning 消耗的输出 Token 数。
gen_ai.usage.request_count	long	本次 span/trace 中累计发起的模型请求次数。
gen_ai.usage.total_tokens	long	总 Token 数。
hermes.end_hook	text	Agent 执行结束时触发的 hook 名称。
hermes.model	text	Agent 框架层面记录的模型标识。
hermes.platform	text	Agent 运行所在的平台标识。
hermes.start_hook	text	Agent 执行开始时触发的 hook 名称。
tool.error	text	工具执行失败时的错误信息。
tool.name	text	被调用的工具名称。