You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Add troubleshooting for agent that can't be unenrolled (#903) (#905)
* Add troubleshooting for agent that can't be uninstalled
* change title
* Add missing quotation mark
(cherry picked from commit fe54e95)
Co-authored-by: David Kilfoyle <41695641+kilfoyle@users.noreply.github.com>
Copy file name to clipboardexpand all lines: docs/en/ingest-management/troubleshooting/troubleshooting.asciidoc
+36
Original file line number
Diff line number
Diff line change
@@ -29,6 +29,7 @@ Running {agent} standalone? Also refer to <<debug-standalone-agents>>.
29
29
30
30
Find troubleshooting information for {fleet}, {fleet-server}, and {agent} in the following documentation:
31
31
32
+
* <<deleted-policy-unenroll>>
32
33
* <<tsdb-illegal-argument>>
33
34
* <<agents-in-cloud-stuck-at-updating>>
34
35
* <<fleet-server-not-in-kibana-cloud>>
@@ -59,6 +60,41 @@ Find troubleshooting information for {fleet}, {fleet-server}, and {agent} in the
59
60
* <<fleet-server-integration-removed>>
60
61
* <<agent-oom-k8s>>
61
62
63
+
64
+
65
+
66
+
[discrete]
67
+
[[deleted-policy-unenroll]]
68
+
== {agent} unenroll fails
69
+
70
+
In {fleet}, if you delete an {agent} policy that is associated with one or more inactive enrolled agents, when the agent returns back to a `Healthy` or `Offline` state, it cannot be unenrolled. Attempting to unenroll the agent results in an `Error unenrolling agent` message, and the unenrollment fails.
71
+
72
+
To resolve this problem, you can use the <<fleet-api-docs,{kib} {fleet} APIs>> to force unenroll the agent.
73
+
74
+
To uninstall a single {agent}:
75
+
76
+
[source,"shell"]
77
+
----
78
+
POST kbn:/api/fleet/agents/<agent_id>/unenroll
79
+
{
80
+
"force": true,
81
+
"revoke": true
82
+
}
83
+
----
84
+
85
+
To bulk uninstall a set of {agents}:
86
+
87
+
[source,"shell"]
88
+
----
89
+
POST kbn:/api/fleet/agents/bulk_unenroll
90
+
{ "agents": ["<agent_id1>", "<agent-id2>"],
91
+
"force": true,
92
+
"revoke": true
93
+
}
94
+
----
95
+
96
+
We are also updating the {fleet} UI to prevent removal of an {agent} policy that is currently associated with any inactive agents.
97
+
62
98
[discrete]
63
99
[[tsdb-illegal-argument]]
64
100
== illegal_argument_exception when TSDB is enabled
0 commit comments