Update troubleshooting.asciidoc (#1573) (#1575)

* Update troubleshooting.asciidoc Added info about what to look for if an agent gets reenrolled on a Kubernetes cluster * Update docs/en/ingest-management/troubleshooting/troubleshooting.asciidoc * Update docs/en/ingest-management/troubleshooting/troubleshooting.asciidoc * Update docs/en/ingest-management/troubleshooting/troubleshooting.asciidoc --------- Co-authored-by: David Kilfoyle <[email protected]> (cherry picked from commit 300b660) Co-authored-by: BBQigniter <[email protected]>
elastic · Dec 19, 2024 · 6731d83 · 6731d83
1 parent 99836e0
commit 6731d83
Showing 1 changed file with 11 additions and 0 deletions.
diff --git a/docs/en/ingest-management/troubleshooting/troubleshooting.asciidoc b/docs/en/ingest-management/troubleshooting/troubleshooting.asciidoc
@@ -61,6 +61,7 @@ Find troubleshooting information for {fleet}, {fleet-server}, and {agent} in the
 * <<agent-oom-k8s>>
 * <<agent-sudo-error>>
 * <<agent-kubernetes-kustomize>>
+* <<agent-kubernetes-invalid-api-key>>
 
 
 [discrete]
@@ -963,3 +964,13 @@ Extra resources for {agent} on Kubernetes troubleshooting and information:
 * https://github.com/elastic/elastic-agent/tree/main/deploy/kubernetes/elastic-agent-kustomize/default[{agent} Kustomize Templates] documentation and resources.
 
 * Other examples and manifests to deploy https://github.com/elastic/elastic-agent/tree/main/deploy/kubernetes[{agent} on Kubernetes].
+
+[discrete]
+[[agent-kubernetes-invalid-api-key]]
+== Troubleshoot {agent} on Kubernetes seeing `invalid api key to authenticate with fleet` in logs
+
+If an agent was unenrolled from a Kubernetes cluster, there might be data remaining in `/var/lib/elastic-agent-managed/kube-system/state` on the node(s). Reenrolling an agent later on the same nodes might then result in `invalid api key to authenticate with fleet` error messages. 
+
+To avoid these errors, make sure to delete this state-folder before enrolling a new agent.
+
+For more information, refer to issue link:https://github.com/elastic/elastic-agent/issues/3586[#3586].