用途:监控 OmniRoute 系统健康、提供商熔断器、按提供商的延迟分位(p50/p95/p99)、配额用量,并可设置预算护栏。使用前需配置环境变量 OMNIROUTE_URL 和 OMNIROUTE_KEY。
主要能力与用法: 系统健康:curl $OMNIROUTE_URL/api/health -H "Authorization: Bearer $OMNIROUTE_KEY",返回 uptime、内存、活跃连接、熔断器状态、速率限制状态、缓存统计;未认证快速检查 curl $OMNIROUTE_URL/api/health 返回 {"ok":true}。 提供商熔断器:curl $OMNIROUTE_URL/api/monitoring/health -H "Authorization: Bearer $OMNIROUTE_KEY",响应含 circuitBreakers 数组,每个提供商状态与 resetAt 时间戳。状态有 CLOSED(正常)、OPEN(阻断)、HALF_OPEN(探测模式,自动恢复)。 按提供商指标:curl $OMNIROUTE_URL/api/providers/metrics -H "Authorization: Bearer $OMNIROUTE_KEY",返回 provider、requests、successRate、latency 的 p50/p95/p99、circuitState、tokensUsed。 配额检查:curl $OMNIROUTE_URL/api/quota -H "Authorization: Bearer $OMNIROUTE_KEY",返回按提供商/账户的已用与总 tokens、请求数,以及 resetAt 时间戳。 预算护栏:POST $OMNIROUTE_URL/api/budget/guard,JSON 体含 limitUsd、action、degradeTo;action 可选 degrade(超限切换到更便宜模型)、block(超限返回 429)、alert(继续但加 X-Budget-Warning 头)。 MCP 方式(若 OmniRoute 为 MCP 服务器):omniroute_get_health、omniroute_get_provider_metrics、omniroute_get_session_snapshot、omniroute_check_quota、omniroute_db_health_check。 MCP 审计日志:curl "$OMNIROUTE_URL/api/mcp/status" -H "Authorization: Bearer $OMNIROUTE_KEY",返回服务器状态、心跳、近期审计活动摘要。
限制与错误:health 端点返回 503 表示正在启动,5 秒后重试;熔断器 OPEN 表示提供商被临时阻断,可查看 resetAt 了解自动恢复时间;429 budget_exceeded 表示预算护栏超限,需提高限额或等待重置。具体安装与入口设置详见入口 SKILL,其他细节资料暂未提供。