用途:面向阿里云 Elasticsearch 实例的健康检查、故障排查与性能分析,综合控制面 OpenAPI、云监控(CMS)与数据面 Elasticsearch REST API 信号,结合 references/ 下的 SOP 知识库,输出根因分析、证据链、优先级修复建议;多个维度同时触发时给出按时间排序的事件时间线。
主要能力:只读诊断,不调用变更类 API(创建、扩容、重启、删除等)。MUST 触发条件包括 ClusterStatus 为 Yellow/Red、NodeCPUUtilization 超过 80%、NodeHeapMemoryUtilization 超过 85%、线程池拒绝数大于 0、节点间资源 CV 大于 0.3、写入失败或索引只读、间歇性 ES API 超时且 CMS CPU 超过 80% 等,对应采集 allocation/explain、_cat/shards、_nodes/hot_threads、_nodes/stats/thread_pool 等证据。
使用方式:需先确认 instance-id、region 等参数。控制面命令使用插件形态,如 aliyun elasticsearch describe-instance、aliyun cms describe-metric-list(kebab-case 参数),并运行 aliyun version 确认 CLI 不低于 3.3.1。数据面通过 curl 直连,需在本地终端设置 ES_ENDPOINT、ES_USERNAME、ES_PASSWORD 后访问 GET /_cluster/health 等接口。可运行 python3 scripts/check_es_instance_health.py 获取标准控制面加 CMS 组合结果。
限制与安全:AccessKey 与 ES_PASSWORD 不得在对话中粘贴、回显或写入脚本;只能使用本地已配置的 CLI profile 或本地环境变量。region 与 instance-id 不得猜测,ES_ENDPOINT 必须与诊断实例一致。HTTPS 需证书或指纹配置,HTTP 端点不要误用 https。具体 RAM 权限、SOP 细节与部分限制本资料未完整列出。