名称： prometheus
描述： 查询 Prometheus 监控数据以检查服务器指标、资源使用情况和系统健康状况。当用户询问服务器状态、磁盘空间、CPU/内存使用率、网络统计信息或 Prometheus 收集的任何指标时使用。支持通过环境变量配置 HTTP 基本认证。

Prometheus 技能

查询 Prometheus 监控数据，获取基础设施的洞察信息。

环境变量

在 .env 文件中设置：
- PROMETHEUS_URL - Prometheus 服务器 URL（例如：http://localhost:9090）
- PROMETHEUS_USER - HTTP 基本认证用户名（可选）
- PROMETHEUS_PASSWORD - HTTP 基本认证密码（可选）

使用方法

查询指标

使用 CLI 运行 PromQL 查询：

source .env && node scripts/cli.js query '<promql_query>'

常用示例

磁盘空间使用率：

node scripts/cli.js query '100 - (node_filesystem_avail_bytes / node_filesystem_size_bytes * 100)'

CPU 使用率：

node scripts/cli.js query '100 - (avg by (instance) (irate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)'

内存使用率：

node scripts/cli.js query '(node_memory_MemTotal_bytes - node_memory_MemAvailable_bytes) / node_memory_MemTotal_bytes * 100'

系统负载：

node scripts/cli.js query 'node_load1'

列出指标

查找匹配指定模式的可用指标：

node scripts/cli.js metrics 'node_memory_*'

发现时间序列

通过标签选择器查找时间序列：

node scripts/cli.js series '{__name__=~"node_cpu_.*", instance=~".*:9100"}'

获取标签

列出所有标签名称：

node scripts/cli.js labels

列出特定标签的值：

node scripts/cli.js label-values instance

输出格式

所有命令均输出 JSON 格式以便解析。使用 jq 进行美化输出：

node scripts/cli.js query 'up' | jq .

常用查询参考

注意事项

• 即时查询默认时间范围为最近 1 小时
• 速率计算请使用范围查询 [5m]
• 所有查询返回的 JSON 中，data.result 包含结果数据
• 实例标签通常显示为 主机:端口 格式