so tired

marciw · marciw · commit a55fff4f00d0 · 2025-02-18T17:09:15.000-05:00
diff --git a/troubleshoot/deployments.md b/troubleshoot/deployments.md
@@ -4,4 +4,10 @@ navigation_title: "Deployments"
 
 # Troubleshoot deployments
 
+:::{admonition} WIP
+⚠️ **This page is a work in progress.** ⚠️
+
+The documentation team is working on restructuring this section. It currently reflects a legacy product-centric structure.
+:::
+
 % What needs to be done: Write from scratch
diff --git a/troubleshoot/deployments/cloud-enterprise/ask-for-help.md b/troubleshoot/deployments/cloud-enterprise/ask-for-help.md
@@ -5,6 +5,12 @@ mapped_pages:
 
 # Ask for help [ece-getting-help]
 
+:::{admonition} WIP
+⚠️ **This page is a work in progress.** ⚠️
+
+The documentation team is working on moving this content to the [Troubleshooting overview](/troubleshoot/index.md). 
+:::
+
 For issues with Elastic Cloud Enterprise that you cannot fix yourself …​ we’re here to help!
 
 If you are an existing Elastic customer with a support contract, please create a ticket in the  [Elastic Support Portal](https://support.elastic.co) and provide an ECE [diagnostics package and log files](../../../deploy-manage/monitor/orchestrators/ece-monitoring-ece-access.md). By providing a diagnostics package, you make it easier for us to help you.
diff --git a/troubleshoot/deployments/cloud-enterprise/rebuilding-broken-zookeeper-quorum.md b/troubleshoot/deployments/cloud-enterprise/rebuilding-broken-zookeeper-quorum.md
@@ -1,4 +1,5 @@
 ---
+navigation_title: "Zookeeper quorum"
 mapped_pages:
   - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-troubleshooting-zookeeper-quorum.html
 ---
diff --git a/troubleshoot/deployments/cloud-enterprise/remove-cloud-enterprise.md b/troubleshoot/deployments/cloud-enterprise/remove-cloud-enterprise.md
@@ -1,9 +1,10 @@
 ---
+navigation_title: "Removing containers"
 mapped_pages:
   - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-uninstall.html
 ---
 
-# Remove Elastic Cloud Enterprise [ece-uninstall]
+# Remove Elastic Cloud Enterprise containers  [ece-uninstall]
 
 You might need to remove Elastic Cloud Enterprise for one of the following reasons:
 
diff --git a/troubleshoot/deployments/cloud-enterprise/run-ece-diagnostics-tool.md b/troubleshoot/deployments/cloud-enterprise/run-ece-diagnostics-tool.md
@@ -1,4 +1,5 @@
 ---
+navigation_title: "Diagnostics"
 mapped_pages:
   - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-run-ece-diagnostics.html
 ---
diff --git a/troubleshoot/deployments/cloud-enterprise/troubleshooting-container-engines.md b/troubleshoot/deployments/cloud-enterprise/troubleshooting-container-engines.md
@@ -1,9 +1,10 @@
 ---
+navigation_title: "Container engines"
 mapped_pages:
   - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-troubleshooting-containers.html
 ---
 
-# Troubleshooting container engines [ece-troubleshooting-containers]
+# Troubleshoot container engines [ece-troubleshooting-containers]
 
 This article describes how to troubleshoot container engine services in Elastic Cloud Enterprise. We refer to [Docker](https://www.docker.com/) by default, as it’s the most common container engine, but these steps are also valid for [Podman](https://podman.io/). You can simply replace `docker` in the commands  with `podman` as needed.
 
diff --git a/troubleshoot/deployments/cloud-enterprise/use-emergency-roles-token.md b/troubleshoot/deployments/cloud-enterprise/use-emergency-roles-token.md
@@ -1,4 +1,5 @@
 ---
+navigation_title: "Emergency roles token"
 mapped_pages:
   - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-troubleshooting-emergency.html
 ---
diff --git a/troubleshoot/deployments/cloud-enterprise/verify-zookeeper-sync-status.md b/troubleshoot/deployments/cloud-enterprise/verify-zookeeper-sync-status.md
@@ -1,9 +1,10 @@
 ---
+navigation_title: "ZooKeeper sync status"
 mapped_pages:
   - https://www.elastic.co/guide/en/cloud-enterprise/current/ece-zookeeper-sync.html
 ---
 
-# Verify ZooKeeper Sync Status [ece-zookeeper-sync]
+# Verify ZooKeeper sync status [ece-zookeeper-sync]
 
 It is recommended to check the ZooKeeper sync status before starting any maintenance on your Director nodes. This helps you prevent the following scenarios:
 
diff --git a/troubleshoot/deployments/cloud-on-k8s/common-problems.md b/troubleshoot/deployments/cloud-on-k8s/common-problems.md
@@ -1,9 +1,12 @@
 ---
+navigation_title: "Common issues"
+applies:
+  eck: all
 mapped_pages:
   - https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-common-problems.html
 ---
 
-# Common problems [k8s-common-problems]
+# Troubleshoot common Elastic Cloud on Kubernetes issues [k8s-common-problems]
 
 
 ## Operator crashes on startup with `OOMKilled` [k8s-common-problems-operator-oom]
diff --git a/troubleshoot/deployments/cloud-on-k8s/jvm-heap-dumps.md b/troubleshoot/deployments/cloud-on-k8s/jvm-heap-dumps.md
@@ -1,9 +1,12 @@
 ---
+navigation_title: "JVM heap dumps"
+applies:
+  eck: all
 mapped_pages:
   - https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-jvm-heap-dumps.html
 ---
 
-# JVM heap dumps [k8s-jvm-heap-dumps]
+# Troubleshoot JVM heap dumps [k8s-jvm-heap-dumps]
 
 ## Ensure sufficient storage [k8s_ensure_sufficient_storage]
 
diff --git a/troubleshoot/deployments/cloud-on-k8s/run-eck-diagnostics.md b/troubleshoot/deployments/cloud-on-k8s/run-eck-diagnostics.md
@@ -1,4 +1,5 @@
 ---
+navigation_title: "Diagnostics"
 mapped_pages:
   - https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-take-eck-dump.html
 ---
diff --git a/troubleshoot/deployments/cloud-on-k8s/troubleshooting-methods.md b/troubleshoot/deployments/cloud-on-k8s/troubleshooting-methods.md
@@ -1,9 +1,12 @@
 ---
+navigation_title: "Resources and logs"
+applies:
+  eck: all
 mapped_pages:
   - https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-troubleshooting-methods.html
 ---
 
-# Troubleshooting methods [k8s-troubleshooting-methods]
+# Troubleshoot ECK resources and logs  [k8s-troubleshooting-methods]
 
 Most common issues can be identified and resolved by following these instructions:
 
diff --git a/troubleshoot/elasticsearch/capacity.md b/troubleshoot/elasticsearch/capacity.md
@@ -4,4 +4,10 @@ navigation_title: Capacity
 
 # Troubleshoot Elasticsearch capacity issues
 
+:::{admonition} WIP
+⚠️ **This page is a work in progress.** ⚠️
+
+The documentation team is working on this section. Contributions welcome!
+:::
+
 % What needs to be done: Write from scratch
diff --git a/troubleshoot/elasticsearch/clients.md b/troubleshoot/elasticsearch/clients.md
@@ -4,4 +4,10 @@ navigation_title: "Clients"
 
 # Troubleshoot {{es}} clients
 
+:::{admonition} WIP
+⚠️ **This page is a work in progress.** ⚠️
+
+The documentation team is working on this section. Contributions welcome!
+:::
+
 % What needs to be done: Write from scratch
diff --git a/troubleshoot/elasticsearch/clusters.md b/troubleshoot/elasticsearch/clusters.md
@@ -4,4 +4,19 @@ navigation_title: Clusters
 
 # Troubleshoot Elasticsearch clusters
 
-% What needs to be done: Write from scratch
+:::{admonition} WIP
+⚠️ **This page is a work in progress.** ⚠️
+
+The documentation team is working on this section. Contributions welcome!
+:::
+
+Use the topics in this section to troubleshoot {{es}} clusters:
+
+* [](/troubleshoot/elasticsearch/clusters.md)
+* [](/troubleshoot/elasticsearch/troubleshooting-unstable-cluster.md)
+* [](/troubleshoot/elasticsearch/troubleshooting-unbalanced-cluster.md)
+* [](/troubleshoot/elasticsearch/elasticsearch-reference/remote-clusters.md)
+* [](/troubleshoot/elasticsearch/diagnose-unassigned-shards.md)
+* [](/troubleshoot/elasticsearch/troubleshooting-shards-capacity-issues.md)
+* []()
+
diff --git a/troubleshoot/elasticsearch/data.md b/troubleshoot/elasticsearch/data.md
@@ -4,6 +4,23 @@ navigation_title: Data
 
 # Troubleshoot Elasticsearch data issues
 
-% What needs to be done: Write from scratch
+:::{admonition} WIP
+⚠️ **This page is a work in progress.** ⚠️
+
+The documentation team is working on this section. Contributions welcome!
+:::
+
+Use the topics in this section to troubleshoot {{es}} data issues:
+
+* [](/troubleshoot/elasticsearch/allow-all-cluster-allocation.md)
+* [](/troubleshoot/elasticsearch/allow-all-index-allocation.md)
+* [](/troubleshoot/elasticsearch/add-tier.md)
+* [](/troubleshoot/elasticsearch/troubleshoot-migrate-to-tiers.md)
+* [](/troubleshoot/elasticsearch/increase-tier-capacity.md)
+* [](/troubleshoot/elasticsearch/increase-shard-limit.md)
+* [](/troubleshoot/elasticsearch/increase-cluster-shard-limit.md)
+* [](/troubleshoot/elasticsearch/corruption-troubleshooting.md)
+
+
 
 % see also fix-watermark-errors.md
diff --git a/troubleshoot/elasticsearch/more-topics.md b/troubleshoot/elasticsearch/more-topics.md
@@ -4,4 +4,10 @@ navigation_title: More topics
 
 # More Elasticsearch troubleshooting topics
 
+:::{admonition} WIP
+⚠️ **This page is a work in progress.** ⚠️
+
+The documentation team is working on this section. Contributions welcome!
+:::
+
 % What needs to be done: Write from scratch
diff --git a/troubleshoot/elasticsearch/snapshot-and-restore.md b/troubleshoot/elasticsearch/snapshot-and-restore.md
@@ -4,4 +4,10 @@ navigation_title: Snapshot and restore
 
 # Troubleshoot snapshot and restore
 
+:::{admonition} WIP
+⚠️ **This page is a work in progress.** ⚠️
+
+The documentation team is working on this section. Contributions welcome!
+:::
+
 % What needs to be done: Write from scratch
diff --git a/troubleshoot/index.md b/troubleshoot/index.md
@@ -1,16 +1,38 @@
 ---
+navigation_title: "Troubleshoot"
 mapped_urls:
   - https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/get-support-help.html
   - https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/troubleshooting-and-faqs.html
   - https://www.elastic.co/guide/en/cloud/current/ec-get-help.html
 ---
 
-# Troubleshoot
+# Troubleshooting
 
 % What needs to be done: Refine
 
+:::{admonition} WIP
+⚠️ **This page is a work in progress.** ⚠️
+
+The documentation team is working on expanding this topic.
+:::
+
+Use the topics in this section to troubleshoot Elastic products, features, and deployments.
+
+
+* [](/troubleshoot/elasticsearch/elasticsearch-reference.md)
+* [](/troubleshoot/kibana.md)
+* [](/troubleshoot/observability.md)
+* [](/troubleshoot/security.md)
+* [](/troubleshoot/ingest.md)
+* [](/troubleshoot/deployments.md)
+
+
 ## Contact us [contact-us]
 
+:::{warning}
+Work in progress. Contributions welcome!
+:::
+
 % Scope notes: - Match new content type; TOC entry TBD - consider splitting out subsections?
 
 % Use migrated content from existing pages that map to this page:
diff --git a/troubleshoot/ingest.md b/troubleshoot/ingest.md
@@ -4,3 +4,22 @@ navigation_title: "Ingest tools"
 
 # Troubleshoot ingestion tools
 
+:::{admonition} WIP
+⚠️ **This page is a work in progress.** ⚠️
+
+The documentation team is working on restructuring this section.
+:::
+
+Use the topics in this section to troubleshoot ingestion tools:
+
+* [](/troubleshoot/ingest/logstash.md)
+* [](/troubleshoot/ingest/fleet/fleet-elastic-agent.md)
+* [](/troubleshoot/ingest/beats-loggingplugin/elastic-logging-plugin-for-docker.md)
+* []()
+* []()
+* []()
+* []()
+* []()
+* []()
+* []()
+
diff --git a/troubleshoot/kibana.md b/troubleshoot/kibana.md
@@ -6,7 +6,7 @@ mapped_pages:
 
 # Troubleshoot Kibana [kibana-troubleshooting]
 
-These topics help you troubleshoot issues with {{kib}}:
+Use these topics to troubleshoot issues with {{kib}}:
 
 ## Debugging
 
diff --git a/troubleshoot/toc.yml b/troubleshoot/toc.yml
@@ -201,4 +201,5 @@ toc:
           - file: deployments/cloud-on-k8s/common-problems.md
           - file: deployments/cloud-on-k8s/troubleshooting-methods.md
           - file: deployments/cloud-on-k8s/run-eck-diagnostics.md
-          - file: deployments/cloud-on-k8s/jvm-heap-dumps.md  
+          - file: deployments/cloud-on-k8s/jvm-heap-dumps.md
+  

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	`---`
	`2`	`+navigation_title: "Zookeeper quorum"`
`2`	`3`	`mapped_pages:`
`3`	`4`	`- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-troubleshooting-zookeeper-quorum.html`
`4`	`5`	`---`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	`---`
	`2`	`+navigation_title: "Diagnostics"`
`2`	`3`	`mapped_pages:`
`3`	`4`	`- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-run-ece-diagnostics.html`
`4`	`5`	`---`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	`---`
	`2`	`+navigation_title: "Emergency roles token"`
`2`	`3`	`mapped_pages:`
`3`	`4`	`- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-troubleshooting-emergency.html`
`4`	`5`	`---`