本文为您详细介绍 ArkClaw 暴露的指标，旨在为监控、告警和可观测性分析提供参考。 ## 指标分析以下指标涵盖企业版 Claw 的完整运行链路，覆盖请求进入、网关启停、实例资源、Skill/工具执行、Agent 调用、消息处理、会话状态、Webhook 处理以及 Token 消耗等关键环节。 ### 请求指标 |指标名称 |类型 |单位 |描述 |标签（Label） | |---|---|---|---|---| |arkclaw_enterprise_request_count |Counter |Count |企业版 Claw 请求次数 |* service

* user_email

* user_name

* user_department

* claw_space_id

* channel_id

* from

* conversation_id | |arkclaw_enterprise_request_duration_avg |Histogram |s |企业版 Claw 请求处理平均时延 |* service

* user_email

* user_name

* user_department

* claw_space_id

* channel_id

* from

* conversation_id | |arkclaw_enterprise_request_duration_pct50 |Histogram |s |企业版 Claw 请求处理时延 P50 |* service

* user_email

* user_name

* user_department

* claw_space_id

* channel_id

* from

* conversation_id | |arkclaw_enterprise_request_duration_pct90 |Histogram |s |企业版 Claw 请求处理时延 P90 |* service

* user_email

* user_name

* user_department

* claw_space_id

* channel_id

* from

* conversation_id | |arkclaw_enterprise_request_duration_pct99 |Histogram |s |企业版 Claw 请求处理时延 P99 |* service

* user_email

* user_name

* user_department

* claw_space_id

* channel_id

* from

* conversation_id | ### 网关指标 |指标名称 |类型 |单位 |描述 |标签（Label） | |---|---|---|---|---| |arkclaw_enterprise_gateway_start_count |Counter |Count |企业版 Claw 网关启动次数 |* service

* user_email

* user_name

* user_department

* claw_space_id

* operation

* port | |arkclaw_enterprise_gateway_stop_count |Counter |Count |企业版 Claw 网关停止次数 |* service

* user_email

* user_name

* user_department

* claw_space_id

* operation

* port | ### 实例指标 |指标名称 |类型 |单位 |描述 |标签（Label） | |---|---|---|---|---| |arkclaw_enterprise_disk_read_bandwidth |\- |B/s |企业版 Claw 磁盘 Read 带宽 |* service

* user_email

* user_name

* user_department

* claw_space_id | |arkclaw_enterprise_disk_read_iops |\- |Count/s |企业版 Claw 磁盘 Read IOPS |* service

* user_email

* user_name

* user_department

* claw_space_id | |arkclaw_enterprise_disk_write_bandwidth |\- |B/s |企业版 Claw 磁盘 Write 带宽 |* service

* user_email

* user_name

* user_department

* claw_space_id | |arkclaw_enterprise_disk_write_iops |\- |Count/s |企业版 Claw 磁盘 Write IOPS |* service

* user_email

* user_name

* user_department

* claw_space_id | |arkclaw_enterprise_instance_cpu_usage_ratio |\- |Ratio |企业版 Claw 实例 CPU 使用率 |* service

* user_email

* user_name

* user_department

* claw_space_id | |arkclaw_enterprise_instance_memory_usage_ratio |\- |Ratio |企业版 Claw 实例内存使用率 |* service

* user_email

* user_name

* user_department

* claw_space_id | |arkclaw_enterprise_process_uptime |\- |ms |企业版 Claw 进程启动时长 |* service

* user_email

* user_name

* user_department

* claw_space_id | ### Skill & 工具 |指标名称 |类型 |单位 |描述 |标签（Label） | |---|---|---|---|---| |arkclaw_enterprise_skill_visit_count |Counter |Count |企业版 Claw Skill 访问次数 |* service

* user_email

* user_name

* user_department

* claw_space_id

* skill_name | |arkclaw_enterprise_tool_duration_avg |Histogram |s |企业版 Claw 工具执行平均时延 |* service

* user_email

* user_name

* user_department

* claw_space_id

* tool_name

* error_type

* agent_id

* session_key | |arkclaw_enterprise_tool_duration_pct90 |Histogram |s |企业版 Claw 工具执行时延 P90 |* service

* user_email

* user_name

* user_department

* claw_space_id

* tool_name

* error_type

* agent_id

* session_key | |arkclaw_enterprise_tool_error_count |Counter |Count |企业版 Claw 工具调用失败数 |* service

* user_email

* user_name

* user_department

* claw_space_id

* tool_name

* error_type

* agent_id

* session_key | |arkclaw_enterprise_tool_error_rate |\- |Ratio |企业版 Claw 工具执行错误率 |* service

* user_email

* user_name

* user_department

* claw_space_id

* tool_name

* error_type

* agent_id

* session_key | |arkclaw_enterprise_tool_execution_count |Counter |Count |企业版 Claw 工具执行次数 |* service

* user_email

* user_name

* user_department

* claw_space_id

* tool_name

* error_type

* agent_id

* session_key | ### Agent 调用 |指标名称 |类型 |单位 |描述 |标签（Label） | |---|---|---|---|---| |arkclaw_enterprise_active_agent_count |\- |Count |统计指定时间范围内产生数据交互的 Agent 总数（按 agent_id 去重） |* service

* user_email

* user_name

* user_department

* claw_space_id

* agent_id | |arkclaw_enterprise_agent_call_count |Counter |Count |企业版 Claw Agent 调用次数 |* service

* user_email

* user_name

* user_department

* claw_space_id

* channel_id

* agent_id

* session_key

* is_success | |arkclaw_enterprise_agent_duration_avg |Histogram |s |企业版 Claw Agent 调用平均时延 |* service

* user_email

* user_name

* user_department

* claw_space_id

* channel_id

* agent_id

* session_key

* is_success | |arkclaw_enterprise_agent_duration_pct90 |Histogram |s |企业版 Claw Agent 调用时延 P90 |* service

* user_email

* user_name

* user_department

* claw_space_id

* channel_id

* agent_id

* session_key

* is_success | |arkclaw_enterprise_llm_success_rate |\- |Ratio |企业版 Claw LLM 调用成功率 |* service

* user_email

* user_name

* user_department

* claw_space_id

* error_type

* api_type

* model

* provider

* stop_reason

* llm_turn | ### 消息对话 |指标名称 |类型 |单位 |描述 |标签（Label） | |---|---|---|---|---| |arkclaw_enterprise_message_count |Counter |Count |企业版 Claw 消息数量 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_channel

* openclaw_source

* openclaw_outcome | |arkclaw_enterprise_message_duration_avg |Histogram |ms |企业版 Claw 消息处理平均时延 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_channel

* openclaw_source

* openclaw_outcome | |arkclaw_enterprise_message_duration_pct50 |Histogram |ms |企业版 Claw 消息处理时延 P50 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_channel

* openclaw_source

* openclaw_outcome | |arkclaw_enterprise_message_duration_pct90 |Histogram |ms |企业版 Claw 消息处理时延 P90 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_channel

* openclaw_source

* openclaw_outcome | |arkclaw_enterprise_message_duration_pct99 |Histogram |ms |企业版 Claw 消息处理时延 P99 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_channel

* openclaw_source

* openclaw_outcome | |arkclaw_enterprise_message_failure_rate |\- |Ratio |企业版 Claw 消息处理失败率 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_channel

* openclaw_source

* openclaw_outcome | |arkclaw_enterprise_message_received |Counter |Count |企业版 Claw 消息接收数 |* service

* user_email

* user_name

* user_department

* claw_space_id

* from

* channel_id

* conversation_id | |arkclaw_enterprise_message_success_rate |\- |Ratio |企业版 Claw 消息处理成功率 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_channel

* openclaw_source

* openclaw_outcome | |arkclaw_enterprise_queue_depth_avg |Histogram |Count |企业版 Claw 队列平均排队长度 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_channel

* openclaw_source

* openclaw_lane | ### 会话分析 |指标名称 |类型 |单位 |描述 |标签（Label） | |---|---|---|---|---| |arkclaw_enterprise_session_state |Counter |Count |企业版 Claw 会话状态分布 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_state

* openclaw_reason | |arkclaw_enterprise_session_stuck_count |Counter |Count |企业版 Claw 卡顿会话数 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_state | |arkclaw_enterprise_session_stuck_duration_avg |Histogram |ms |企业版 Claw 卡顿会话平均耗时 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_state | ### Webhook |指标名称 |类型 |单位 |描述 |标签（Label） | |---|---|---|---|---| |arkclaw_enterprise_webhook_duration_avg |Histogram |ms |企业版 Claw Webhook 处理平均时延 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_channel

* openclaw_webhook | |arkclaw_enterprise_webhook_duration_pct50 |Histogram |ms |企业版 Claw Webhook 处理时延 P50 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_channel

* openclaw_webhook | |arkclaw_enterprise_webhook_duration_pct90 |Histogram |ms |企业版 Claw Webhook 处理时延 P90 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_channel

* openclaw_webhook | |arkclaw_enterprise_webhook_duration_pct99 |Histogram |ms |企业版 Claw Webhook 处理时延 P99 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_channel

* openclaw_webhook | |arkclaw_enterprise_webhook_error_rate |\- |Ratio |企业版 Claw Webhook 处理错误率 |* service

* user_email

* user_name

* user_department

* claw_space_id

* openclaw_channel

* openclaw_webhook | ### Token 用量（ArkClaw 网关） |**指标名称** |**类型** |**单位** |**描述** |**标签（Label）** | |---|---|---|---|---| |arkclaw_enterprise_apig_cache_hit_rate |\- |Ratio |企业版 Claw Token 缓存命中率 |* service

* user_email

* user_name

* uid

* user_department

* claw_space_id

* openclaw_model | |arkclaw_enterprise_apig_cache_read_token_usage_sum |Counter |Count |企业版 Claw 缓存 Token 用量 |* service

* user_email

* user_name

* uid

* user_department

* claw_space_id

* openclaw_model | |arkclaw_enterprise_apig_input_token_usage_sum |Counter |Count |企业版 Claw 输入 Token 用量 |* service

* user_email

* user_name

* uid

* user_department

* claw_space_id

* openclaw_model | |arkclaw_enterprise_apig_output_token_usage_sum |Counter |Count |企业版 Claw 输出 Token 用量 |* service

* user_email

* user_name

* uid

* user_department

* claw_space_id

* openclaw_model | |arkclaw_enterprise_apig_total_token_usage_sum |Counter |Count |企业版 Claw 输入和输出 Token 总量 |* service

* user_email

* user_name

* uid

* user_department

* claw_space_id

* openclaw_model | |arkclaw_enterprise_apig_total_token_with_cache_usage_sum |Counter

|Count

|企业版 Claw 输入、输出和缓存 Token 总量 |* service

* user_email

* user_name

* uid

* user_department

* claw_space_id

* openclaw_model | ### Token 用量（自建网关） |**指标名称** |**类型** |**单位** |**描述** |**标签（Label）** | |---|---|---|---|---| |custom_gateway_token_used |Counter |1（number） |Token 使用消耗

说明

自建网关的 Token 用量数据上报，以及指标和标签（Label）的详细说明参见：自建网关用量数据上报。

|* service

* user_email

* user_name

* user_department

* claw_space_id

* model

* from

* provider

* token_type

* apmplus_business_carrier | ## 标签说明以下详细介绍上述指标中使用的标签。合理利用这些指标搭建监控看板，可以全面了解 ArkClaw 系统的运行状态，及时发现和解决问题，优化系统性能，提高用户体验。

说明

除以下标签外，可观测指标支持联动 ArkClaw 实例自定义标签进行数据筛选或分组。ArkClaw 实例自定义标签相关更多说明参见：标签管理。

|**标签 (Label)** |标签英文名称 |标签中文名称 | |---|---|---| |service |Service name |服务名 | |user_email |User email |用户邮箱 | |user_name |User Name |用户名称 | |user_department |User Department |用户部门 | |claw_space_id |Claw space ID |Claw 空间 ID | |channel_id |Channel ID |渠道 ID | |from |Sender |发送方 | |conversation_id |Conversation ID |会话 ID | |operation |Operation |操作 | |port |Gateway port |网关端口 | |skill_name |Skill name |Skill 名称 | |tool_name |Tool name |工具名称 | |error_type |Error flag |是否错误 | |agent_id |Agent ID |Agent ID | |session_key |Session key |会话 Key | |is_success |Is success |是否成功 | |api_type |API type |API 类型 | |model |Model name |模型名称 | |provider |Provider name |模型提供商 | |stop_reason |Stop reason |停止原因 | |llm_turn |LLM turn |推理轮次 | |openclaw_channel |Channel |渠道 | |openclaw_source |Source |来源 | |openclaw_outcome |Outcome |结果 | |openclaw_lane |Queue lane |队列泳道 | |openclaw_state |Session state |会话状态 | |openclaw_reason |Session state reason |会话状态原因 | |openclaw_webhook |Webhook type |Webhook 类型 | |openclaw_provider |Provider |服务提供方 | |openclaw_model |Model |模型 | |openclaw_token |Token type |Token 类型 |

全栈可观测平台