2022-05-10 16:13:27 +08:00
[[troubleshooting]]
= Troubleshooting
[partintro]
--
2022-05-26 03:58:41 +08:00
This section provides a series of troubleshooting solutions aimed at helping users
fix problems that an {es} deployment might encounter.
2022-05-10 16:13:27 +08:00
2025-01-09 23:24:20 +08:00
****
If you're using Elastic Cloud Hosted, then you can use AutoOps to monitor your cluster. AutoOps significantly simplifies cluster management with performance recommendations, resource utilization visibility, real-time issue detection and resolution paths. For more information, refer to https://www.elastic.co/guide/en/cloud/current/ec-autoops.html[Monitor with AutoOps].
****
2022-08-03 23:00:34 +08:00
[discrete]
[[troubleshooting-general]]
=== General
* <<fix-common-cluster-issues,Fix common cluster issues>>
* Several troubleshooting issues can be diagnosed using the
2022-05-26 03:58:41 +08:00
<<health-api,health API>>.
2022-08-03 23:00:34 +08:00
[discrete]
[[troubleshooting-data]]
=== Data
2023-03-01 21:34:14 +08:00
* <<fix-watermark-errors,Fix watermark errors caused by low disk space>>
2022-08-03 23:00:34 +08:00
* <<add-tier,Add a missing tier to the system>>
* <<allow-all-cluster-allocation,Allow Elasticsearch to allocate the data in the system>>
* <<allow-all-index-allocation,Allow Elasticsearch to allocate the index>>
* <<troubleshoot-migrate-to-tiers,Indices mix index allocation filters with data tiers node roles to move through data tiers>>
* <<increase-tier-capacity,Not enough nodes to allocate all shard replicas>>
* <<increase-shard-limit,Total number of shards for an index on a single node exceeded>>
* <<increase-cluster-shard-limit,Total number of shards per node has been reached>>
* <<corruption-troubleshooting,Troubleshooting data corruption>>
[discrete]
[[troubleshooting-management]]
=== Management
* <<start-ilm,Start index lifecycle management>>
* <<start-slm,Start snapshot lifecycle management>>
2022-10-14 21:24:21 +08:00
[discrete]
[[troubleshooting-capacity]]
=== Capacity
* <<fix-data-node-out-of-disk, Fix data nodes out of disk>>
* <<fix-master-node-out-of-disk, Fix master nodes out of disk>>
* <<fix-other-node-out-of-disk, Fix other role nodes out of disk>>
2022-08-03 23:00:34 +08:00
[discrete]
[[troubleshooting-snapshot]]
=== Snapshot and restore
* <<restore-from-snapshot,Restore data from snapshot>>
2024-02-07 22:18:55 +08:00
* <<add-repository,Troubleshooting broken repositories>>
2022-09-16 05:01:32 +08:00
* <<repeated-snapshot-failures,Troubleshooting repeated snapshot failures>>
2022-08-03 23:00:34 +08:00
[discrete]
[[troubleshooting-others]]
2023-09-08 19:42:50 +08:00
=== Other issues
* <<troubleshooting-unstable-cluster,Troubleshooting an unstable cluster>>
2022-08-03 23:00:34 +08:00
* <<discovery-troubleshooting,Troubleshooting discovery>>
* <<monitoring-troubleshooting,Troubleshooting monitoring>>
* <<transform-troubleshooting,Troubleshooting transforms>>
* <<watcher-troubleshooting,Troubleshooting Watcher>>
2022-09-08 20:30:21 +08:00
* <<troubleshooting-searches,Troubleshooting searches>>
2023-09-05 21:10:45 +08:00
* <<troubleshooting-shards-capacity-issues,Troubleshooting shards capacity>>
2024-03-14 21:10:13 +08:00
* <<troubleshooting-unbalanced-cluster,Troubleshooting an unbalanced cluster>>
2023-09-05 21:10:45 +08:00
* <<remote-clusters-troubleshooting,Troubleshooting remote clusters>>
2022-08-03 23:00:34 +08:00
2024-01-17 04:22:33 +08:00
[discrete]
[[troubleshooting-contact-support]]
=== Contact us
If none of these guides relate to your issue, or you need further assistance,
then you can contact us as follows:
2022-05-26 03:58:41 +08:00
2024-01-17 04:22:33 +08:00
* If you have an active subscription, you have several options:
2022-05-26 03:58:41 +08:00
** Go directly to the http://support.elastic.co[Support Portal]
2022-06-09 03:06:47 +08:00
** From the {ess} Console, go to the
2022-05-26 03:58:41 +08:00
https://cloud.elastic.co/support{ess-baymax}[Support page], or select the
support icon that looks like a life preserver on any page.
** Contact us by email: support@elastic.co
+
[TIP]
====
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.
====
2022-06-09 03:06:47 +08:00
* For users without an active subscription, visit the
2022-05-26 03:58:41 +08:00
https://discuss.elastic.co/[Elastic community forums] and get answers from
the experts in the community, including people from Elastic.
2022-05-10 16:13:27 +08:00
--
2022-06-14 08:16:17 +08:00
include::troubleshooting/fix-common-cluster-issues.asciidoc[]
2022-08-03 23:00:34 +08:00
include::troubleshooting/data/add-tier.asciidoc[]
2022-05-10 16:13:27 +08:00
2022-08-03 23:00:34 +08:00
include::troubleshooting/data/enable-cluster-allocation.asciidoc[]
2022-05-10 16:13:27 +08:00
2022-05-24 17:27:15 +08:00
include::troubleshooting/data/enable-index-allocation.asciidoc[]
2022-05-24 17:12:28 +08:00
include::troubleshooting/data/data-tiers-mixed-with-node-attr.asciidoc[]
2022-05-10 16:13:27 +08:00
2022-08-03 23:00:34 +08:00
include::troubleshooting/data/increase-tier-capacity.asciidoc[]
2022-06-17 19:24:33 +08:00
2022-08-03 23:00:34 +08:00
include::troubleshooting/data/increase-shard-limit.asciidoc[]
2022-05-26 03:58:41 +08:00
2022-08-03 23:00:34 +08:00
include::troubleshooting/data/increase-cluster-shard-limit.asciidoc[]
2022-07-07 03:51:43 +08:00
2022-08-03 23:00:34 +08:00
include::troubleshooting/corruption-issues.asciidoc[]
2022-06-09 03:06:47 +08:00
2022-10-14 21:24:21 +08:00
include::troubleshooting/disk/fix-data-node-out-of-disk.asciidoc[]
include::troubleshooting/disk/fix-master-node-out-of-disk.asciidoc[]
include::troubleshooting/disk/fix-other-node-out-of-disk.asciidoc[]
2022-06-23 16:54:31 +08:00
include::troubleshooting/data/start-ilm.asciidoc[]
2022-06-23 18:04:45 +08:00
include::troubleshooting/data/start-slm.asciidoc[]
2022-07-27 22:07:08 +08:00
include::troubleshooting/data/restore-from-snapshot.asciidoc[]
2022-07-14 20:37:02 +08:00
include::troubleshooting/snapshot/add-repository.asciidoc[]
2022-09-16 05:01:32 +08:00
include::troubleshooting/snapshot/repeated-snapshot-failures.asciidoc[]
2023-09-08 19:42:50 +08:00
include::troubleshooting/troubleshooting-unstable-cluster.asciidoc[]
2022-08-03 23:00:34 +08:00
include::troubleshooting/discovery-issues.asciidoc[]
2022-05-26 03:58:41 +08:00
include::monitoring/troubleshooting.asciidoc[]
include::transform/troubleshooting.asciidoc[leveloffset=+1]
2023-09-13 02:53:41 +08:00
include::watcher/troubleshooting.asciidoc[]
2022-09-08 20:30:21 +08:00
2022-09-16 05:01:32 +08:00
include::troubleshooting/troubleshooting-searches.asciidoc[]
2023-04-19 15:24:07 +08:00
include::troubleshooting/troubleshooting-shards-capacity.asciidoc[]
2024-03-14 21:10:13 +08:00
include::troubleshooting/troubleshooting-unbalanced-cluster.asciidoc[]
2024-05-10 00:27:19 +08:00
include::troubleshooting/diagnostic.asciidoc[]