Observability Alert Manager 用于为 Claude Code 监控配置和管理 Grafana 告警,基于增强遥测数据实现异常与阈值告警。
用途 该技能面向需要为 Claude Code 会话建立可观测性告警的场景,通过 Loki 中的遥测数据(主数据源为 {job="claude_code_enhanced"})定义告警规则,覆盖会话、错误、上下文使用和子代理等维度。
主要能力 提供四类操作:create-alert(定义新告警规则,参数包括 name、query(LogQL)、threshold、duration、severity、notification)、list-alerts(显示所有已配置告警及其状态)、test-alert(模拟告警条件)、delete-alert(删除告警规则)。
预置告警模板 会话告警:长会话时长(会话超过 1 小时,duration_seconds > 3600)、高轮次数量(会话超过 50 轮,turn_count > 50)、会话错误激增(会话中错误超过 5 个,error_count > 5)。 错误告警:高错误率(每小时超过 5 个错误)、特定工具失败(Bash 错误每小时超过 3 个)。 上下文告警:高上下文使用率(超过 80% 上下文窗口,context_percentage > 80)、自动压缩触发(context_compact,trigger="auto")。 子代理告警:子代理过度生成(每会话超过 10 个子代理,subagents_spawned > 10)。 活动告警:遥测停滞(超过 10 分钟无数据,absent_over_time)、异常活动峰值(每小时超过 100 次工具调用)。 提示模式告警:调试会话激增(每小时调试类提示超过 10 次)。
使用方式
可通过命令行创建告警,例如:
create-alert
--name "High Error Rate"
--query 'count_over_time({job="claude_code_enhanced", event_type="tool_result", status="error"} [1h]) > 5'
--severity warning
--notification slack
也可在 Grafana UI 中操作:进入 Alerting → Alert rules,使用 Loki 数据源创建新规则,输入上述 LogQL 查询,配置条件与通知。或通过 API 提交规则,例如:
curl -X POST http://localhost:3000/api/ruler/grafana/api/v1/rules/claude-code
-H "Content-Type: application/json"
-u admin:admin
-d '{
"name": "claude-code-alerts",
"rules": [
{
"alert": "HighErrorRate",
"expr": "count_over_time({job="claude_code_enhanced", status="error"} [1h]) > 5",
"for": "5m",
"labels": {"severity": "warning"},
"annotations": {"summary": "High error rate detected"}
}
]
}'
通知渠道 支持 Slack(Webhook 集成)、Email(SMTP 配置)、PagerDuty(事件管理)和 Dashboard(屏幕标注)。
告警严重级别 critical:需要立即处理;warning:需要尽快关注;info:信息性,无需操作。
脚本 scripts/create-alert.sh(创建新告警)、scripts/list-alerts.sh(列出所有告警)、scripts/test-alerts.sh(测试告警条件)、scripts/import-alert-templates.sh(导入所有预置模板)。
适用场景 适用于为 Claude Code 建立监控告警的团队或个人,尤其是需要跟踪会话异常、错误率、上下文占用和子代理行为的场景。
限制 资料未提供该技能的安装方式、依赖要求、收费模式、平台兼容性及具体效果说明,这些信息暂未提供。