huawei-cloud-ces-ecs-monitoring

用途

本技能用于通过华为云云监控服务（Cloud Eye Service，CES）查询和分析弹性云服务器（ECS）实例的监控指标。它面向需要了解 ECS 运行状态、排查性能问题或分析资源使用趋势的用户，提供从实例列举、指标查询到结果分析的结构化流程。

主要能力

实时监控 CPU、内存、磁盘、网络及系统类指标。
查询历史监控数据，支持按时间范围、统计周期和统计方法聚合。
支持 SYS.ECS 基础监控命名空间（无需 Agent）与 AGT.ECS 操作系统级监控命名空间（需 Telescope Agent）。
当 SYS.ECS 指标无数据时，可按映射关系回退查询对应的 AGT.ECS 指标。
对返回数据进行阈值对比、趋势与异常识别，并给出优化建议。
可选支持查看告警列表与告警模板。

使用方式

使用前需安装并验证华为云 CLI（hcloud），命令为 hcloud --version；随后通过 hcloud configure init 交互式配置凭证（Access Key ID、Secret Access Key、Region，Project ID 可选）。

核心流程：

校验凭证状态：hcloud configure list。若配置无效则需先在终端完成配置后重新运行。
列出当前区域的 ECS 实例：hcloud ECS NovaListServers --cli-region=<region-id> --limit=50。
查询监控指标，例如 SYS.ECS 查询：

hcloud CES BatchListMetricData \
  --metrics.1.namespace="SYS.ECS" \
  --metrics.1.metric_name="cpu_util" \
  --metrics.1.dimensions.1.name="instance_id" \
  --metrics.1.dimensions.1.value="<instance-id>" \
  --from=$(date -d '-1 hour' +%s)000 \
  --to=$(date +%s)000 \
  --period=300 \
  --filter="average" \
  --cli-region=<region-id>

AGT.ECS 查询（SYS.ECS 无数据或仅存在于 AGT.ECS 的指标）：

hcloud CES BatchListMetricData \
  --metrics.1.namespace="AGT.ECS" \
  --metrics.1.metric_name="cpu_usage" \
  --metrics.1.dimensions.1.name="instance_id" \
  --metrics.1.dimensions.1.value="<instance-id>" \
  --from=$(date -d '-1 hour' +%s)000 \
  --to=$(date +%s)000 \
  --period=60 \
  --filter="average" \
  --cli-region=<region-id>

分析对比指标并输出监控报告。

常用默认指标（SYS.ECS）：cpu_util、mem_util、disk_read_bytes_rate、disk_write_bytes_rate、network_incoming_bytes_rate_inband、network_outgoing_bytes_rate_inband、disk_util_inband。

关键参数：--cli-region（区域，必填）、--metrics.1.namespace（命名空间，必填）、--metrics.1.metric_name（指标名，必填）、--metrics.1.dimensions.1.name（维度名，必填）、--metrics.1.dimensions.1.value（维度值，必填）；可选参数包括 --from、--to、--period（默认 300）、--filter（支持 average、variance、min、max、sum，默认 average）、--project-id。

时间范围可选：最近 1 小时（默认）、6 小时、24 小时、7 天或自定义。注意 period=60（1 分钟粒度）仅适用于 AGT.ECS，SYS.ECS 最小周期为 300（5 分钟）。

适用场景

监控 ECS 实例的 CPU、内存、磁盘和网络利用率。
查询历史指标用于性能分析。
搭建基础监控看板。
排查性能瓶颈。
分析资源使用趋势。
检查系统与自定义指标。

权限要求

最低 IAM 权限：ecs:cloudServers:list、ecs:cloudServers:get、ces:metrics:list、ces:metricData:get。可选权限（如 ces:alarms:list、ces:alarmTemplates:list）及策略配置详见参考文档 iam-policies.md。

限制与注意事项

凭证安全：禁止读取、回显或打印 AK/SK，禁止要求用户在对话或命令行中直接输入 AK/SK，仅可通过 hcloud configure list 检查凭证状态。
遵循最小权限原则，仅授予必要 IAM 权限。
存在 API 调用频率限制，监控数据保留时间有限，具体限制见参考文档。
监控数据可能存在 1-2 分钟延迟；新建实例可能需要数分钟才开始上报指标。
SYS.ECS 指标无数据的常见原因：实例镜像未安装 UVP VMTools（影响 mem_util、disk_util_inband、network_*_inband）、实例刚创建尚未生成指标（需等待 5-10 分钟）、实例不处于 ACTIVE 状态。
具体收费、价格与平台支持情况暂未提供。

参考文档

技能包含以下参考文档：cli-installation-guide.md、ces-metrics-reference.md、iam-policies.md、best-practices.md、troubleshooting-guide.md、verification-method.md、acceptance-criteria.md、related-commands.md。

官方文档：https://support.huaweicloud.com/usermanual-ecs/ecs_03_1001.html ；CLI 参考：https://support.huaweicloud.com/function-hcli/index.html