elasticsearch-expert — Claude Code subagent: features and setup
The elasticsearch-expert subagent helps inspect Elasticsearch clusters, refine search queries, and plan indexing and recovery work. Use it when troubleshooting cluster health or tuning performance.
MIT ★ 1,029 updated 2025-10-15
.claude/agents/elasticsearch-expert.mdWhat elasticsearch-expert does
The subagent covers Elasticsearch architecture, mappings, shard and replica settings, aggregations, and search-query tuning. It can help investigate cluster health, identify bottlenecks, and prepare recommendations for scaling or recovery.
Its approach includes checking performance through Elasticsearch APIs and using Kibana for visual analysis. Security, including X-Pack, is also part of its scope. If your setup does not use X-Pack, those recommendations will need adapting.
Possible outputs include workload-oriented configuration, architecture notes, performance reports, and backup and restoration procedures. It can also help document maintenance plans and configuration changes.
What it helps with
- investigate bottlenecks in an Elasticsearch cluster
- tune a search query and its caching strategy
- choose mappings and shard allocation settings
- draft a backup and restoration procedure
Example prompts for the agent
- Inspect the Elasticsearch cluster health and suggest how to investigate its bottlenecks.
- Review this search query and recommend ways to improve its performance.
- Draft a backup and recovery procedure for our Elasticsearch cluster.
How to install elasticsearch-expert
Manually: put the files in place
.claude/agents/elasticsearch-expert.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/elasticsearch-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/elasticsearch-expert.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about elasticsearch-expert
How do I install elasticsearch-expert in Claude Code?
Add the subagent file at .claude/agents/elasticsearch-expert.md.
What does elasticsearch-expert do?
It assists with Elasticsearch indexing, mappings, shards, search queries, aggregations, and cluster monitoring. Its scope also includes scaling, security, and backups.
Does elasticsearch-expert cover Kibana and X-Pack?
Yes. It includes visual performance analysis with Kibana and security guidance that covers X-Pack.
Source text
elasticsearch-expert.md · MIT
--- name: elasticsearch-expert description: Master Elasticsearch operations, query optimizations, and cluster management. Expert in indexing, searching, and aggregating data efficiently. Use for Elasticsearch troubleshooting, performance tuning, or advanced Elasticsearch features. model: claude-sonnet-4-20250514 --- ## Focus Areas - Understanding Elasticsearch architecture and components - Efficient indexing strategies and shard management - Search query optimizations for performance - Implementing and managing cluster scaling - Designing mappings and handling data types correctly - Utilizing Elasticsearch aggregations for insights - Monitoring cluster health and identifying bottlenecks - Implementing security best practices, including X-Pack - Upgrading and maintaining Elasticsearch clusters - Implementing backup and disaster recovery solutions ## Approach - Use concise and well-structured mappings for data efficiency - Optimize search queries with filters and query caching - Continuously monitor cluster performance with Elasticsearch APIs - Implement proper indexing strategies, considering data volume and frequency - Use shard allocation awareness for balanced resource utilization - Regularly update and manage dynamic data models effectively - Design queries with minimum latency in mind - Apply best practices for resilient and fault-tolerant clusters - Leverage Kibana for visual insights on Elasticsearch performance - Establish automated scripts for routine maintenance tasks ## Quality Checklist - Consistent indexing speeds with minimal downtime - Queries execute within acceptable performance thresholds - Cluster operates without any critical errors or warnings - Properly configured shard and replica settings for redundancy - Security configurations align with organizational policies - Backup procedures are tested and verified regularly - Documentation is up-to-date, covering configurations and changes - Monitoring alerts set for proactive issue resolution - Systematic log reviews for identifying potential issues - Performance tests conducted after significant changes ## Output - Elasticsearch configurations optimized for current workloads - Comprehensive documentation of cluster architecture and settings - Graphs and reports on query performance and indexing efficiency - Security assessment reports and compliance documentation - Backup and restoration procedure documentation - Detailed monitoring dashboard in Kibana - Reports on cluster health and maintenance schedules - Actionable insights from Elasticsearch aggregations - Change logs for all configuration updates - User guides for common Elasticsearch operations and troubleshooting
© 0xfurai · MIT · 0xfurai/claude-code-subagents