This topic describes the metrics exposed by ArkClaw. You can use these metrics as a reference for monitoring, alerting, and observability analysis.

Metric analysis

The following metrics cover the end-to-end operation flow of Claw Enterprise, including key stages such as request ingress, gateway startup and shutdown, instance resources, Skill/tool execution, agent call, message processing, session state, Webhook processing, and token consumption.

Request metrics

Metric Name	Type	Unit	Description	Label
arkclaw_enterprise_request_count	Counter	Count	Claw Enterprise request count	service user_email user_name user_department claw_space_id channel_id from conversation_id
arkclaw_enterprise_request_duration_avg	Histogram	s	Average request processing latency of Claw Enterprise	service user_email user_name user_department claw_space_id channel_id from conversation_id
arkclaw_enterprise_request_duration_pct50	Histogram	s	Request processing latency of Claw Enterprise (P50)	service user_email user_name user_department claw_space_id channel_id from conversation_id
arkclaw_enterprise_request_duration_pct90	Histogram	s	Request processing latency of Claw Enterprise (P90)	service user_email user_name user_department claw_space_id channel_id from conversation_id
arkclaw_enterprise_request_duration_pct99	Histogram	s	Request processing latency of Claw Enterprise (P99)	service user_email user_name user_department claw_space_id channel_id from conversation_id

Gateway metrics

Metric Name	Type	Unit	Description	Label
arkclaw_enterprise_gateway_start_count	Counter	Count	Gateway startup count of Claw Enterprise	service user_email user_name user_department claw_space_id operation port
arkclaw_enterprise_gateway_stop_count	Counter	Count	Gateway shutdown count of Claw Enterprise	service user_email user_name user_department claw_space_id operation port

Instance metrics

Metric Name	Type	Unit	Description	Label
arkclaw_enterprise_disk_read_bandwidth	-	B/s	Disk read bandwidth of Claw Enterprise	service user_email user_name user_department claw_space_id
arkclaw_enterprise_disk_read_iops	-	Count/s	Disk read IOPS of Claw Enterprise	service user_email user_name user_department claw_space_id
arkclaw_enterprise_disk_write_bandwidth	-	B/s	Disk write bandwidth of Claw Enterprise	service user_email user_name user_department claw_space_id
arkclaw_enterprise_disk_write_iops	-	Count/s	Disk write IOPS of Claw Enterprise	service user_email user_name user_department claw_space_id
arkclaw_enterprise_instance_cpu_usage_ratio	-	Ratio	Instance CPU utilization of Claw Enterprise	service user_email user_name user_department claw_space_id
arkclaw_enterprise_instance_memory_usage_ratio	-	Ratio	Instance memory usage rate of Claw Enterprise	service user_email user_name user_department claw_space_id
arkclaw_enterprise_process_uptime	-	ms	Process startup time of Claw Enterprise	service user_email user_name user_department claw_space_id

Skills and tools

Metric Name	Type	Unit	Description	Label
arkclaw_enterprise_skill_visit_count	Counter	Count	Skill access count of Claw Enterprise	service user_email user_name user_department claw_space_id skill_name
arkclaw_enterprise_tool_duration_avg	Histogram	s	Average tool execution latency of Claw Enterprise	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	Tool execution latency of Claw Enterprise (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	Tool call failure count of Claw Enterprise	service user_email user_name user_department claw_space_id tool_name error_type agent_id session_key
arkclaw_enterprise_tool_error_rate	-	Ratio	Tool execution error rate of Claw Enterprise	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	Tool execution count of Claw Enterprise	service user_email user_name user_department claw_space_id tool_name error_type agent_id session_key

Agent call

Metric Name	Type	Unit	Description	Label
arkclaw_enterprise_active_agent_count	-	Count	The total number of agents that generated data interactions within a specified time range, deduplicated by agent_id.	service user_email user_name user_department claw_space_id agent_id
arkclaw_enterprise_agent_call_count	Counter	Count	Agent call count of Claw Enterprise	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	Average agent call latency of Claw Enterprise	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	Agent call latency of Claw Enterprise (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	LLM call success rate of Claw Enterprise	service user_email user_name user_department claw_space_id error_type api_type model provider stop_reason llm_turn

Message conversation

Metric Name	Type	Unit	Description	Label
arkclaw_enterprise_message_count	Counter	Count	Message count of Claw Enterprise	service user_email user_name user_department claw_space_id openclaw_channel openclaw_source openclaw_outcome
arkclaw_enterprise_message_duration_avg	Histogram	ms	Average message processing latency of Claw Enterprise	service user_email user_name user_department claw_space_id openclaw_channel openclaw_source openclaw_outcome
arkclaw_enterprise_message_duration_pct50	Histogram	ms	Message processing latency of Claw Enterprise (P50)	service user_email user_name user_department claw_space_id openclaw_channel openclaw_source openclaw_outcome
arkclaw_enterprise_message_duration_pct90	Histogram	ms	Message processing latency of Claw Enterprise (P90)	service user_email user_name user_department claw_space_id openclaw_channel openclaw_source openclaw_outcome
arkclaw_enterprise_message_duration_pct99	Histogram	ms	Message processing latency of Claw Enterprise (P99)	service user_email user_name user_department claw_space_id openclaw_channel openclaw_source openclaw_outcome
arkclaw_enterprise_message_failure_rate	-	Ratio	Message processing failure rate of Claw Enterprise	service user_email user_name user_department claw_space_id openclaw_channel openclaw_source openclaw_outcome
arkclaw_enterprise_message_received	Counter	Count	Received message count of Claw Enterprise	service user_email user_name user_department claw_space_id from channel_id conversation_id
arkclaw_enterprise_message_success_rate	-	Ratio	Message processing success rate of Claw Enterprise	service user_email user_name user_department claw_space_id openclaw_channel openclaw_source openclaw_outcome
arkclaw_enterprise_queue_depth_avg	Histogram	Count	Average queue length of Claw Enterprise	service user_email user_name user_department claw_space_id openclaw_channel openclaw_source openclaw_lane

Session analysis

Metric Name	Type	Unit	Description	Label
arkclaw_enterprise_session_state	Counter	Count	Session status distribution of Claw Enterprise	service user_email user_name user_department claw_space_id openclaw_state openclaw_reason
arkclaw_enterprise_session_stuck_count	Counter	Count	Claw Enterprise stuck session count	service user_email user_name user_department claw_space_id openclaw_state
arkclaw_enterprise_session_stuck_duration_avg	Histogram	ms	Claw Enterprise average duration of stuttering sessions	service user_email user_name user_department claw_space_id openclaw_state

Webhook

Metric Name	Type	Unit	Description	Label
arkclaw_enterprise_webhook_duration_avg	Histogram	ms	Average Webhook processing latency of Claw Enterprise	service user_email user_name user_department claw_space_id openclaw_channel openclaw_webhook
arkclaw_enterprise_webhook_duration_pct50	Histogram	ms	Webhook processing latency of Claw Enterprise (P50)	service user_email user_name user_department claw_space_id openclaw_channel openclaw_webhook
arkclaw_enterprise_webhook_duration_pct90	Histogram	ms	Webhook processing latency of Claw Enterprise (P90)	service user_email user_name user_department claw_space_id openclaw_channel openclaw_webhook
arkclaw_enterprise_webhook_duration_pct99	Histogram	ms	Webhook processing latency of Claw Enterprise (P99)	service user_email user_name user_department claw_space_id openclaw_channel openclaw_webhook
arkclaw_enterprise_webhook_error_rate	-	Ratio	Webhook processing error rate of Claw Enterprise	service user_email user_name user_department claw_space_id openclaw_channel openclaw_webhook

Token usage (ArkClaw gateway)

Metric Name	Type	Unit	Description	Label
arkclaw_enterprise_apig_cache_hit_rate	-	Ratio	Token cache hit rate of Claw Enterprise	service user_email user_name uid user_department claw_space_id openclaw_model
arkclaw_enterprise_apig_cache_read_token_usage_sum	Counter	Count	Cache token usage of Claw Enterprise	service user_email user_name uid user_department claw_space_id openclaw_model
arkclaw_enterprise_apig_input_token_usage_sum	Counter	Count	Input token usage of Claw Enterprise	service user_email user_name uid user_department claw_space_id openclaw_model
arkclaw_enterprise_apig_output_token_usage_sum	Counter	Count	Output token usage of Claw Enterprise	service user_email user_name uid user_department claw_space_id openclaw_model
arkclaw_enterprise_apig_total_token_usage_sum	Counter	Count	Claw Enterprise total tokens for input and output	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 Enterprise total tokens for input, output, and cache	service user_email user_name uid user_department claw_space_id openclaw_model

Token usage (self-managed gateway)

Metric Name	Type	Unit	Description	Label
custom_gateway_token_used	Counter	1 (number)	Token consumption tip For details about reporting Token usage data for self-managed gateways and for descriptions of the metrics and labels, see Reporting usage data from self-managed gateways.	service user_email user_name user_department claw_space_id model from provider token_type apmplus_business_carrier

Tag descriptions

Labels used in the above metrics are listed below. By utilizing these metrics to build monitoring dashboards, you can gain a comprehensive understanding of the ArkClaw system running status, promptly identify and resolve issues, optimize system performance, and enhance user experience.

Label	Label name in English
service	Service name
user_email	User email
user_name	User Name
user_department	User Department
claw_space_id	Claw space ID
channel_id	Channel ID
from	Sender
conversation_id	Conversation ID
operation	Operation
port	Gateway port
skill_name	Skill name
tool_name	Tool name
error_type	Error flag
agent_id	Agent ID
session_key	Session key
is_success	Is success
api_type	API type
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
openclaw_provider	Provider
openclaw_model	Model
openclaw_token	Token type

Observability Platform