文档中心

日志服务

No-coding Agent 日志应用

OpenClaw 观测

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

概述

日志服务支持一键式接入 OpenClaw，快速获取 OpenClaw 应用日志数据，并自动创建日志主题，分类存储数据。

通过日志应用的 OpenClaw 观测大盘、运维可观测、Trace 调用链、CacheTrace 日志分析等仪表盘，可快速观测 OpenClaw 运行状态、进行故障排查、分析 Token 用量等。

使用说明

类别	说明
版本限制	OpenClaw： 2026.3.8 及以后版本。 Node.js：22.x 及以后版本（如果要求更高版本，请以 OpenClaw 提示为准）。
地域限制	部署 OpenClaw 的服务器与日志服务为同一地域（Region）。部署 OpenClaw 详情请参考快速部署 OpenClaw。
鉴权方式	配置 OpenClaw 访问日志服务支持如下鉴权方式： AK/SK：火山引擎账号的 AccessKey ID、AccessKey Secret。支持自动创建日志服务资源（Project/App/Topic），并自动生成日志主题 ID。适合单机试用与联调。 API Key：请求火山日志服务的重要凭证，仅用于 Log、Metric、Trace 的数据上报。严格收敛权限、不支持自动创建日志服务资源。适合多机房与权限管控严格场景。说明 API Key 为邀测功能，若有相关业务需求，可联系客户经理开通白名单。
敏感信息处理	日志服务会对常见敏感字段做 best-effort 脱敏，并对超长内容做截断，降低风险。
依赖服务	已开通火山引擎托管 Prometheus 服务（VMP），详情请参考托管 Prometheus 快速入门。

一接入 OpenClaw 日志应用

登录日志服务控制台。

在顶部导航栏中，选择日志服务所在的地域。

在左侧导航栏中，选择 AgentLoop > AI观测。

在 AI 观测页面，单击接入 AI 观测。

在接入 AI 观测页面，创建应用。

单击 OpenClaw 图标，选中 OpenClaw 应用。

配置接入应用参数，然后单击创建应用。

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

创建应用后，执行下一步安装插件并接入日志应用。

二安装 TLS OpenClaw 插件接入应用数据

登录部署 OpenClaw 的服务器。

根据不同安装方式，执行以下命令。

一键安装
交互式安装
在安装命令中配置鉴权方式和日志主题等信息，系统自动安装插件，无需进行过多的系统交互。
说明
非 OpenClaw 原生支持的自定义 Provider 模型，默认设置了 compat.supportsUsageInStreaming 为 false，即模型不返回 token 消耗等信息。如需采集 token 相关信息，可在一键安装插件时，添加参数--enable-streaming-usage开启。
ApiKey 鉴权方式

npm exec -y --package=@volcengine/diagnostics-tls-install -- diagnostics-tls-install \
--non-interactive \
--region <需手动替换实际 region> \
--api-key <需手动替换实际 api-key> \
--topic-id-app-log <需手动替换实际 App日志 TopicID> \
--topic-id-audit-log <需手动替换实际配置日志 TopicID> \
--topic-id-cache-trace <需手动替换实际 CacheTrace日志 TopicID> \
--topic-id-session <需手动替换实际 Session日志 TopicID> \
--topic-id-trace <需手动替换实际 Trace日志 TopicID> \
--topic-id-metric <需手动替换实际 Metric TopicID> \
--enable-streaming-usage

AK/SK 鉴权方式

npm exec -y --package=@volcengine/diagnostics-tls-install -- diagnostics-tls-install \
--non-interactive \
--region <需手动替换实际 region> \
--project-name <需手动替换实际 project-name> \
--app-name <需手动替换实际 app-name> \
--ak <需手动替换实际 ak> \
--sk <需手动替换实际 sk> \
--enable-streaming-usage
输入安装命令后，需根据提示，手动配置鉴权方式、日志主题等信息来安装插件。
在部署 OpenClaw 的服务器中，执行如下命令（任意路径）：

npm exec -y --package=@volcengine/diagnostics-tls-install -- diagnostics-tls-install

配置安装参数，等待插件安装完成。
根据提示选择 Region、鉴权方式（ApiKey、AK/SK）、App 日志 ID、配置日志 ID 等参数。
显示如下表示已安装完成：

安装插件结束后，执行如下命令重启 OpenClaw Gateway。

openclaw gateway restart

返回日志服务控制台，查看可观测图表数据。

监控图表详情

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

说明

常见分析流程：

在运维可观测定位异常的时间窗与影响范围（实例、渠道、模型、会话等）。

在 Trace 调用链定位慢点发生在 agent/tool/llm/subagent 的哪一段 span，并确认是否存在重试、超时或异常标记。

查看日志详情，用 sessionKey、agentId、kind 等字段定位原始证据，如错误堆栈、命令审计、配置变更等。

类型	图表
OpenClaw 观测大盘	Overview：总 Tokens、总费用、对话次数、Session 总数、Message 分析、Error Message、单次对话平均 Token 消耗、单次对话平均费用、平均 Tokens 消耗、平均费用消耗、模型 Tokens 消耗分布、模型费用分布、Provider Tokens 消耗分布、Provider 费用分布、Agent Tokens 消耗分布、Agent 费用分布、主机 Tokens 消耗分布、主机费用分布、单日 token、单日费用、单日 Top5 主机消耗 token、单日 Top5 主机费用、工具调用分析 Top5、队列深度 P95、消息处理速率性能分析：模型调用延迟 P95、消息处理延迟 P95、阻塞会话时长 P95、阻塞会话告警、会话状态变化次数、队列等待延迟 P95、队列深度 P95、各队列 Lane 吞吐量、Webhook 处理延迟 P95、Webhook 接收速率、Webhook 错误次数安全审计鉴权失败次数、连接失败次数、Pairing 变更次数、访问敏感数据
运维可观测	应用日志应用日志图表（包含 time、level、subsystem、content）运维大盘 gateway 子系统异常日志 Top5、gateway 日志分布、gateway 退出次数、gateway 配置变更次数、gateway 异常总览_Daily、tools 执行失败_Daily、websocket 错误_Daily、配置错误_Daily、gateway 异常分布、tools 执行失败_原因维度、websocket 错误_原因维度、配置错误_原因维度
Trace 调用链	展示指定调用链的 TraceId、状态、总耗时（ms）、开始时间、结束时间等。
CacheTrace 分析	包含 CacheTrace 分析的 RUN ID、Total Token、开始时间、结束时间和内容
Topic 列表	展示当前日志应用产生的日志类型、日志项目和日志主题及描述信息等。包括 App 日志、配置日志、Trace 日志、Metric、Session 日志、CacheTrace（需已配置 CacheTrace 日志）。

管理我的应用

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

AgentLoop

应用市场

登录日志服务控制台。

在顶部导航栏中，选择日志服务所在的地域。

在左侧导航栏中，选择 AgentLoop > AI观测。

在 AI 观测页面，在对应日志应用的操作列，支持如下管理操作：

修改应用信息：单击编辑图标，可修改应用名称和描述信息。

获取使用指引：单击接入配置图标，进入接入配置弹窗，可获取使用指引示例信息。

删除我的应用：单击删除图标，可删除该日志应用。

应用名称_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	自定义的追踪上下文元数据。

最近更新时间：2026.09.08 14:53:43

这个页面对您有帮助吗？

有用

无用