Metrics Dashboard

核心功能：支持记录计数器、时长、错误等多类代理运营指标，生成文本式仪表盘，可按时段查看指定指标，还能导出JSON/CSV格式数据。典型场景：监控代理全天候运营状态，如任务完成量、错误率、API响应时长等。通过Python脚本命令操作，数据存储为本地每日JSON文件，无需数据库，可与合规审计日志集成，助力全面掌握运营健康。

Trypto1019

热度 60.31

最近更新 2026-02-26 06:25:35

分类：数据依赖：代码执行 / 读写文件应用场景：数据处理 / 报告撰写

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add arc-metrics-dashboard

Metadata

name: metrics-dashboard
description: Track and visualize your agent's operational metrics. Record API calls, task completions, uptime, errors, and custom counters. Generate text-based dashboards and export data for analysis.
user-invocable: true
metadata: {"openclaw":{"emoji":"📊","os":["darwin","linux"],"requires":{"bins":["python3"]}}}

Metrics Dashboard

Track your agent's operational health. Record events, count things, measure durations, and generate reports.

Why This Exists

Agents run 24/7 but have no way to answer basic questions: How many tasks did I complete? What's my error rate? How long do API calls take? Which skills do I use most? Without metrics, you're flying blind.

Commands

Record a metric

python3 {baseDir}/scripts/metrics.py record --name api_calls --value 1 --tags '{"provider": "openrouter", "model": "gpt-4"}'

Record a duration

python3 {baseDir}/scripts/metrics.py timer --name task_duration --seconds 12.5 --tags '{"task": "scan_skill"}'

Increment a counter

python3 {baseDir}/scripts/metrics.py counter --name posts_published --increment 1

Record an error

python3 {baseDir}/scripts/metrics.py error --name moltbook_verify_fail --message "Challenge solver returned wrong answer"

View dashboard

python3 {baseDir}/scripts/metrics.py dashboard

View metrics for today

python3 {baseDir}/scripts/metrics.py view --period day

View specific metric history

python3 {baseDir}/scripts/metrics.py view --name api_calls --period week

Export metrics

python3 {baseDir}/scripts/metrics.py export --format json > metrics.json
python3 {baseDir}/scripts/metrics.py export --format csv > metrics.csv

Dashboard Output

The text-based dashboard shows:

Uptime since first metric recorded
Total events today
Top metrics by count
Error rate
Average durations for timed operations
Custom counter values

Metric Types

counter — Things you count (posts published, skills scanned, comments made)
timer — Things you measure in seconds (API response time, task duration)
event — Things that happened (errors, deployments, restarts)
gauge — Current values (karma, budget remaining, queue depth)

Storage

Metrics are stored in ~/.openclaw/metrics/ as daily JSON files. Lightweight, no database required.

Integration

Works with the compliance audit trail — log metrics events alongside audit entries for full operational visibility.