Skip to main content
subagent CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/elasticsearch-expert.md
Open on GitHub

What 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.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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

Similar subagents

All subagents for Data and databases →
elasticsearch-esql elastic Runs ES|QL queries against Elasticsearch from your code editor. Works across Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode; search logs, compute metrics, and explore data without leaving the IDE. CX Codex +1 5,300installs elasticsearch-onboarding elastic elasticsearch-onboarding is a Claude Code skill that guides Elasticsearch search design, from data mapping to a working search flow. It activates for search tasks and questions about getting started with Elasticsearch. CX Codex +1 4,900installs elasticsearch-best-practices Mindrally elasticsearch-best-practices provides rules and code patterns for Elasticsearch index mappings, shard planning, and search query optimization directly to your agent. CX Codex +1 1,000installs alibabacloud-elasticsearch-instance-diagnose aliyun 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. CX Codex +1 127installs elasticsearch-mcp-server cr7258 Connects an agent to Elasticsearch and OpenSearch tools for document search, index inspection, and cluster management. Useful when coding tasks depend on search data. CX Codex +1 ★ 320repo stars elasticsearch sanjeed5 Elasticsearch guidelines for Cursor: instructs the agent to configure explicit mappings, cache filters, and handle shard sizing properly. CX Codex +1 ★ 3,589repo stars

From the same set137

The whole set →
postgres-expert postgres-expert helps design PostgreSQL schemas, optimize slow SQL queries, and configure indexes for balanced read and write performance. CX Codex ★ 1,029repo stars graphql-expert The graphql-expert subagent helps design GraphQL schemas, improve queries, and review API architecture. Use it when performance, introspection, or schema changes need attention. CX Codex ★ 1,029repo stars nodejs-expert nodejs-expert — a Claude subagent for server-side Node.js work: async patterns, streams, Express APIs, profiling. Tests, linting and a dependency audit are part of its brief. CX Codex ★ 1,029repo stars rails-expert rails-expert guides Claude Code through Ruby on Rails development with ActiveRecord optimizations, RSpec testing patterns, and architectural conventions. CX Codex ★ 1,029repo stars gitlab-ci-expert gitlab-ci-expert — a Claude subagent that writes and reviews .gitlab-ci.yml: stage order, caching, artifacts, conditional jobs, masked secrets. Useful when a pipeline rebuilds the same things on every commit. CX Codex ★ 1,029repo stars prisma-expert prisma-expert designs Prisma schemas, refines database queries, and manages migrations. Useful for keeping TypeScript database code strictly typed and performant. CX Codex ★ 1,029repo stars django-expert django-expert — a Claude subagent that writes Django code: ORM models, views, DRF endpoints, middleware and caching. Handy when a task turns on query performance or API shape. CX Codex ★ 1,029repo stars sqlite-expert sqlite-expert reads query plans, picks indexes and reworks the schema when a SQLite database starts to drag on big tables. CX Codex ★ 1,029repo stars

Project sponsors

Companies that keep this analytics open