Observability Dashboard Creator 是一个面向 Claude Code 可观测性的技能,用于在 Grafana 中创建和管理仪表盘。它既可导入预构建仪表盘,也可创建自定义可视化。
【用途】 在可观测性技术栈运行之后使用,用于导入预构建的 Claude Code 仪表盘、创建自定义仪表盘,以及导出或备份现有仪表盘。
【主要能力】 提供五种预构建仪表盘:
- Claude Code Overview:面板包括最近 24 小时会话数、Token 总用量、总成本、最近 1 小时错误率、Token 用量时间序列、按工具划分的工具调用频率、近期错误日志表。适用于每日健康检查、快速状态概览、异常检测。
- Tool Performance Matrix:针对每种工具(Read、Write、Edit、Bash 等)展示调用次数、平均时长、P95 延迟、P99 延迟、成功率、失败率、Top 错误信息。适用于识别慢工具、发现高失败率工具、性能优化。
- Cost Analysis:面板包括每日成本趋势、每周成本对比、月度预测、Token 用量拆分(输入与输出)、每次会话成本、预算告警(阈值可配置)、最昂贵会话。适用于预算跟踪、成本优化、用量预测。
- Error Tracking:面板包括错误时间线(最近 24 小时)、错误类型分布(饼图)、按工具错误(柱状图)、近期错误表(含详情)、错误率趋势、Top 错误信息(按频率)。适用于调试、错误模式检测、质量监控。
- Session Analysis:面板包括会话时长分布(直方图)、每日/每周会话数(时间序列)、活跃时间与空闲时间、对话深度(每会话轮次)、按小时会话频率、平均会话时长趋势。适用于使用模式分析、用户参与度指标、生产力洞察。
所有仪表盘均包含:时间范围选择器(15 分钟、1 小时、6 小时、24 小时、7 天、30 天)、自动刷新(30 秒、1 分钟、5 分钟、关闭)、过滤变量(tool_name、session_id 等)、重要事件标注、相关仪表盘之间的链接。
【使用方式】 提供以下操作:
- import-all:连接 Grafana API(localhost:3000),创建 “Claude Code” 仪表盘文件夹,通过 Grafana API 导入全部 5 个仪表盘,设置仪表盘链接和导航,验证导入是否成功。
- import-dashboard:按名称导入指定仪表盘,参数 name 可取 overview、tool-performance、cost-analysis、error-tracking、session-analysis;例如:import-dashboard --name overview。
- create-custom:基于模板创建自定义仪表盘,参数包括 name(仪表盘名称)、type(overview、tool-specific、cost、error、session)、panels(逗号分隔的面板类型);例如:create-custom --name "Bash Tool Deep Dive" --type tool-specific --panels "duration,errors,frequency,success-rate"。
- export-dashboards:将所有 Claude Code 仪表盘导出为 JSON 备份,输出到 .observability/backups/dashboards-YYYYMMDD_HHMMSS/*.json。
- list-dashboards:列出 Grafana 中所有 Claude Code 仪表盘。
【参考与脚本】 参考文件包括:references/dashboards/claude-code-overview.json、tool-performance-matrix.json、cost-analysis.json、error-tracking.json、session-analysis.json,以及 references/grafana-api-guide.md。脚本包括:scripts/import-all-dashboards.sh(导入全部预构建仪表盘)、scripts/export-dashboards.sh(备份仪表盘为 JSON)、scripts/create-folder.sh(创建 “Claude Code” 仪表盘文件夹)。
【限制】 资料未说明所需前置条件、Grafana 版本要求、鉴权方式、收费或价格信息,暂未提供。