byted-volcengine-vmp

name	byted-volcengine-vmp
description	火山引擎托管 Prometheus (VMP) 查询技能，用于查询 VMP 工作区，以及查询 Prometheus 指标数据。

火山引擎托管 Prometheus (VMP) 管理 Skill

这个 Skill 用于查询和管理火山引擎的托管 Prometheus (VMP) 工作区，以及查询 Prometheus 指标数据。

何时使用此 Skill

当用户要求：

• 查询 VMP 工作区列表
• 查看工作区详细信息
• 查询 Prometheus 指标数据（PromQL 查询）
• 查询指标名称和标签

前置要求

需要安装火山引擎 Python SDK

pip install --upgrade "volcengine-python-sdk>=5.0.21"

认证配置

推荐在 ~/.openclaw/workspace/.env 中配置：

VOLCENGINE_AK=your_access_key
VOLCENGINE_SK=your_secret_key
VOLCENGINE_REGION=cn-beijing

也可以通过环境变量设置：

export VOLCENGINE_AK=your_access_key
export VOLCENGINE_SK=your_secret_key
export VOLCENGINE_REGION=cn-beijing

认证读取优先级如下：

1. 进程环境变量
2. --env-path 指定的 .env
3. 默认 .env：~/.openclaw/workspace/.env

支持的主要功能

1. 工作区管理

• 查询工作区列表

2. Metrics 查询（新增）

• 即时查询 - 使用 PromQL 查询单个时间点的指标
• 范围查询 - 使用 PromQL 查询时间范围的指标
• 查询指标名称 - 查询工作区中的所有指标名称
• 查询指标标签 - 查询指定指标的所有标签

💡 提示: 常用的火山方舟 PromQL 告警查询可参考 references/README.md 文件，里面包含 15 个常用的监控告警查询语句！

使用示例

查询 VMP 工作区列表

python /root/.openclaw/workspace/skills/byted-volcengine-vmp/scripts/list_workspaces.py

即时查询 Metrics（PromQL）

# 查询当前时间的 CPU 使用率
python /root/.openclaw/workspace/skills/byted-volcengine-vmp/scripts/query_metrics.py \
  --workspace-id <workspace-id> \
  --query "sum(rate(container_cpu_usage_seconds_total[5m]))"

范围查询 Metrics（时间范围）

# 查询最近 1 小时的 CPU 使用率
python /root/.openclaw/workspace/skills/byted-volcengine-vmp/scripts/query_range_metrics.py \
  --workspace-id <workspace-id> \
  --query "sum(rate(container_cpu_usage_seconds_total[5m]))" \
  --start "2026-04-06T20:00:00+08:00" \
  --end "2026-04-06T21:00:00+08:00"

查询指标名称列表

# 查询工作区中的所有指标名称
python /root/.openclaw/workspace/skills/byted-volcengine-vmp/scripts/get_metric_names.py \
  --workspace-id <workspace-id>

# 带匹配条件查询
python /root/.openclaw/workspace/skills/byted-volcengine-vmp/scripts/get_metric_names.py \
  --workspace-id <workspace-id> \
  --match '{job=~"kubelet"}'

查询指标标签列表

# 查询指定指标的所有标签
python /root/.openclaw/workspace/skills/byted-volcengine-vmp/scripts/get_metric_labels.py \
  --workspace-id <workspace-id> \
  --metric-name up

API 说明

工作区管理

ListWorkspaces

查询 VMP 工作区列表

参数说明：

• 无特殊参数

返回： VMP 工作区列表

Metrics 查询

QueryMetrics（即时查询）

执行 PromQL 即时查询

参数说明：

• workspaceId: 工作区 ID
• query: PromQL 查询语句
• time: 查询时间（可选，默认为当前时间）

返回： PromQL 查询结果

QueryMetricsRange（范围查询）

执行 PromQL 范围查询

参数说明：

• workspaceId: 工作区 ID
• query: PromQL 查询语句
• start: 起始时间
• end: 结束时间
• step: 查询步长（可选，自动计算）

返回： PromQL 范围查询结果

GetLabelValues

查询标签值

参数说明：

• workspaceId: 工作区 ID
• label: 标签名称（如 __name__ 表示指标名称）
• match: 匹配条件（可选）

返回： 标签值列表

GetLabels

查询标签名称

参数说明：

• workspaceId: 工作区 ID
• match: 匹配条件（可选）

返回： 标签名称列表

常见 Region

默认地域：cn-beijing

地域	Region ID
华北 2（北京）	cn-beijing
华东 2（上海）	cn-shanghai
华南 1（广州）	cn-guangzhou
中国香港	cn-hongkong
亚太东南（柔佛）	ap-southeast-1
亚太东南（雅加达）	ap-southeast-3