# alibabacloud-elasticsearch-instance-diagnose

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 127 installs · ★ 300 repo stars
- Author: aliyun
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aliyun/alibabacloud-aiops-skills/tree/HEAD/skills/analyticscomputing/elasticsearch/alibabacloud-elasticsearch-instance-diagnose/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/alibabacloud-elasticsearch-instance-diagnose

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-elasticsearch-instance-diagnose -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/alibabacloud-elasticsearch-instance-diagnose/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/alibabacloud-elasticsearch-instance-diagnose/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-elasticsearch-instance-diagnose -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/alibabacloud-elasticsearch-instance-diagnose/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-elasticsearch-instance-diagnose -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/alibabacloud-elasticsearch-instance-diagnose/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aliyun/alibabacloud-aiops-skills skills/analyticscomputing/elasticsearch/alibabacloud-elasticsearch-instance-diagnose
```

2. **Manually: put the files in place**
- File: `.github/skills/alibabacloud-elasticsearch-instance-diagnose/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-elasticsearch-instance-diagnose -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/aliyun/alibabacloud-aiops-skills --path skills/analyticscomputing/elasticsearch/alibabacloud-elasticsearch-instance-diagnose
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/alibabacloud-elasticsearch-instance-diagnose/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-elasticsearch-instance-diagnose -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/aliyun/alibabacloud-aiops-skills/tree/HEAD/skills/analyticscomputing/elasticsearch/alibabacloud-elasticsearch-instance-diagnose/SKILL.md

## When to use it
- 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
- 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

## Similar
- [elasticsearch-cluster-health](https://affpapa.org/en/nevibecode/skills/elasticsearch-cluster-health.md) — skill · 1500 installs
- [elasticsearch-esql](https://affpapa.org/en/nevibecode/skills/elasticsearch-esql.md) — skill · 5300 installs
- [elasticsearch-best-practices](https://affpapa.org/en/nevibecode/skills/elasticsearch-best-practices.md) — skill · 1000 installs
- [elasticsearch-expert](https://affpapa.org/en/nevibecode/skills/elasticsearch-expert.md) — skill · 205 installs
- [elasticsearch-mcp-server](https://affpapa.org/en/nevibecode/mcp/elasticsearch-mcp-server.md) — MCP server · ★ 320 repo stars
- [elasticsearch](https://affpapa.org/en/nevibecode/rules/elasticsearch.md) — rule · ★ 3589 repo stars

From the same set: [aliyun/alibabacloud-aiops-skills](https://affpapa.org/en/nevibecode/by/aliyun/alibabacloud-aiops-skills.md) — 66 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
