Troubleshooting

Troubleshooting

This section provides a series of troubleshooting solutions aimed at helping users fix problems that an Elasticsearch deployment might encounter.

General

• Fix common cluster issues
• Several troubleshooting issues can be diagnosed using the health API.

Data

• Fix watermark errors caused by low disk space
• Add a missing tier to the system
• Allow Elasticsearch to allocate the data in the system
• Allow Elasticsearch to allocate the index
• Indices mix index allocation filters with data tiers node roles to move through data tiers
• Not enough nodes to allocate all shard replicas
• Total number of shards for an index on a single node exceeded
• Total number of shards per node has been reached
• Troubleshooting data corruption

Management

• Start index lifecycle management
• Start snapshot lifecycle management

Capacity

• Fix data nodes out of disk
• Fix master nodes out of disk
• Fix other role nodes out of disk

Snapshot and restore

• Restore data from snapshot
• Troubleshooting broken repositories
• Troubleshooting repeated snapshot failures

Other issues

• Troubleshooting an unstable cluster
• Troubleshooting discovery
• Troubleshooting monitoring
• Troubleshooting transforms
• Troubleshooting Watcher
• Troubleshooting searches
• Troubleshooting shards capacity
• Troubleshooting an unbalanced cluster
• Troubleshooting remote clusters

Contact us

If none of these guides relate to your issue, or you need further assistance, then you can contact us as follows:

• If you have an active subscription, you have several options:

  • Go directly to the Support Portal
  • From the Elasticsearch Service Console, go to the Support page, or select the support icon that looks like a life preserver on any page.

  • Contact us by email: support@elastic.co

    If you contact us by email, use the email address that you registered with so that we can help you more quickly. If you are using a distribution list as your registered email, you can also register a second email address with us. Just open a case to let us know the name and email address you want to add.

• For users without an active subscription, visit the Elastic community forums and get answers from the experts in the community, including people from Elastic.