alibabacloud-elasticsearch-instance-diagnose — Claude Code skill
alibabacloud-elasticsearch-instance-diagnose — a skill for analyzing Elasticsearch cluster health on Alibaba Cloud. Collects data from OpenAPI and REST API, identifies root causes of failures, and suggests remediation steps.
no license 127 installs ★ 300 updated 2026-10-23
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-elasticsearch-instance-diagnose -a claude-codeWhat alibabacloud-elasticsearch-instance-diagnose does
This skill combines Alibaba Cloud OpenAPI (control plane), CloudMonitor (metrics), and Elasticsearch REST API (data plane) to diagnose cluster faults. It takes a symptom description (red or yellow status, slow searches, write failures, thread pool saturation, disk pressure) and outputs an evidence chain, root-cause analysis, prioritized remediation actions, and a timeline of events if the incident spans multiple dimensions.
Internally, the skill runs Python scripts to fetch data via aliyun CLI, references a SOP knowledge base in references/, and validates IAM permissions. It requires Aliyun CLI ≥ 3.3.1, a configured authentication profile with access to your Elasticsearch instance, and optionally ES REST API credentials for direct node connection.
Security is built in: the skill never outputs AccessKeys, passwords, or secrets; all sensitive data must be set locally via aliyun configure or environment variables. If you attempt to paste credentials in chat, the skill halts diagnosis and redirects you to local configuration.
What it helps with
- Find why your Elasticsearch cluster switched to red or yellow status
- Trace the root cause of slow searches or write rejections
- Detect node overload, thread pool exhaustion, or memory and disk pressure
- Analyze unassigned shards and disconnected nodes
- Build a timeline of events when multiple services collapse on one cluster
Example prompts for the agent
- Diagnose my Elasticsearch cluster on Alibaba Cloud — it turned red after deployment and I need to know why
- The cluster is rejecting writes with HTTP 429 — is the thread pool full and how do I check
- Why did my index become read-only and which shards are not assigned
How to install alibabacloud-elasticsearch-instance-diagnose
1Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-elasticsearch-instance-diagnose -a claude-code2Manually: put the files in place
~/.claude/skills/alibabacloud-elasticsearch-instance-diagnose/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/alibabacloud-elasticsearch-instance-diagnose/
1Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-elasticsearch-instance-diagnose -a codex2Manually: put the files in place
.agents/skills/alibabacloud-elasticsearch-instance-diagnose/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-elasticsearch-instance-diagnose -a cursor2Manually: put the files in place
.cursor/skills/alibabacloud-elasticsearch-instance-diagnose/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install aliyun/alibabacloud-aiops-skills skills/analyticscomputing/elasticsearch/alibabacloud-elasticsearch-instance-diagnose2Manually: put the files in place
.github/skills/alibabacloud-elasticsearch-instance-diagnose/SKILL.md1Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-elasticsearch-instance-diagnose -a gemini-cli2Platform CLI
gemini skills install https://github.com/aliyun/alibabacloud-aiops-skills --path skills/analyticscomputing/elasticsearch/alibabacloud-elasticsearch-instance-diagnoseManually: put the files in place
.devin/skills/alibabacloud-elasticsearch-instance-diagnose/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-elasticsearch-instance-diagnose -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about alibabacloud-elasticsearch-instance-diagnose
How do I install the alibabacloud-elasticsearch-instance-diagnose skill in Claude Code?
Run npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-elasticsearch-instance-diagnose -a claude-code in your terminal, then open ~/.claude/skills/alibabacloud-elasticsearch-instance-diagnose/SKILL.md to verify.
What does the alibabacloud-elasticsearch-instance-diagnose skill do?
The skill gathers diagnostic data from Alibaba Cloud OpenAPI, CloudMonitor metrics, and Elasticsearch REST API, then analyzes cluster status, faulty nodes, thread pool state, disk space, and memory usage. It returns a root cause, evidence chain, and prioritized action list.
What do I need before using this skill?
You need Aliyun CLI version ≥ 3.3.1, a configured authentication profile via aliyun configure, access to the Elasticsearch OpenAPI on Alibaba Cloud, and optionally ES REST API credentials set in local environment variables for direct node access.