Skip to content

Commit c65dfd5

Browse files
kilfoylemergify[bot]
authored andcommitted
Add troubleshooting for agent that can't be unenrolled (#903)
* Add troubleshooting for agent that can't be uninstalled * change title * Add missing quotation mark (cherry picked from commit fe54e95)
1 parent daaed72 commit c65dfd5

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

docs/en/ingest-management/troubleshooting/troubleshooting.asciidoc

+36
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@ Running {agent} standalone? Also refer to <<debug-standalone-agents>>.
2929

3030
Find troubleshooting information for {fleet}, {fleet-server}, and {agent} in the following documentation:
3131

32+
* <<deleted-policy-unenroll>>
3233
* <<tsdb-illegal-argument>>
3334
* <<agents-in-cloud-stuck-at-updating>>
3435
* <<fleet-server-not-in-kibana-cloud>>
@@ -59,6 +60,41 @@ Find troubleshooting information for {fleet}, {fleet-server}, and {agent} in the
5960
* <<fleet-server-integration-removed>>
6061
* <<agent-oom-k8s>>
6162

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+
6298
[discrete]
6399
[[tsdb-illegal-argument]]
64100
== illegal_argument_exception when TSDB is enabled

0 commit comments

Comments
 (0)