TITLE:火山引擎云监控 Skill
用途:查询火山引擎云监控的监控时序数据。当用户需要通过云监控查询产品监控数据时使用。
主要能力:
- 监控时序数据查询:完全控制所有参数,支持灵活的时间范围查询与多种监控指标,默认查询最近5分钟数据。
- 配置与调用方式:支持环境变量配置 AK/SK、.env 文件配置、命令行直接使用、Python 代码调用以及 JSON 格式输出。
处理逻辑:根据客户提供的实例信息确定产品,识别产品类型(如 ECS、云服务器等);通过产品确定 namespace,自动映射到对应产品命名空间;通过监控指标确定 metric_name/sub_namespace,根据监控指标关键词自动确定;结合 dimension 查询监控时序数据;未指定时间范围时按默认五分钟查询。
前置要求:需要安装火山引擎 Python SDK: pip install --upgrade "volcengine-python-sdk>=5.0.21"
配置方式:需配置火山引擎 Access Key 和 Secret Key,推荐三种方式之一。 方式1 环境变量: export VOLCENGINE_AK="your-ak" export VOLCENGINE_SK="your-sk" 方式2 .env 文件:在 ~/.openclaw/workspace/.env 中配置: VOLCENGINE_AK=your-ak VOLCENGINE_SK=your-sk
核心参数:namespace(产品命名空间,如 VCM_ECS)、metric_name(监控指标名称,如 DiskUsageUtilization)、sub_namespace(子命名空间,如 Instance)、dimension_name(维度名称,如 ResourceID)、dimension_value(维度值,如实例 ID)、start_time(开始时间戳,可选,默认5分钟前)、end_time(结束时间戳,可选,默认当前时间)、duration(查询时长分钟,默认5)。命令行简写:-n、-m、-s、-d、-v;可选 --start-time、--end-time、--duration、--ak、--sk、--region(默认 cn-beijing)、--json。时间戳为 Unix 秒级时间戳。
使用方式:高级模式示例(指定时间范围): python get_metric_data.py -n VCM_ECS -m DiskUsageUtilization -s Instance -d ResourceID -v i-yejc26eo744c5qwjqtgb --start-time 1632903801 --end-time 1632904801 指定查询时长: python get_metric_data.py -n VCM_ECS -m DiskUsageUtilization -s Instance -d ResourceID -v i-yejc26eo744c5qwjqtgb --duration 30
获取监控参数:查询支持的产品命名空间可通过接口 ListMetricProducts;确定 namespace 后通过 ListMetricDocs 查询该产品指标定义。
API 说明:GetMetricData 查询监控时序数据,参数 end_time、start_time、namespace、metric_name、sub_namespace、instances(实例列表,含维度信息)均为必填,返回监控时序数据。
适用场景:通过命令行或 Python 精确查询指定实例的监控指标数据,适合自动化或需精确控制参数的场景(高级模式),以及只需提供产品、指标和实例 ID 的智能模式。
限制:需自行获取产品命名空间与监控指标,此项暂未提供自动发现外的更多辅助;收费、价格、平台效果等信息暂未提供。