Skip to content

Latest commit

 

History

History
28 lines (21 loc) · 1.18 KB

unenroll-elastic-agent.asciidoc

File metadata and controls

28 lines (21 loc) · 1.18 KB

Unenroll {agent}s

You can unenroll {agent}s to invalidate the API key used to connect to {es}. For {agents} installed in a containerized environment, see [containers-agent-enrollment-handling] for details about how enrollment handling is managed.

  1. In {fleet}, select Agents.

  2. To unenroll a single agent, choose Unenroll agent from the Actions menu next to the agent you want to unenroll.

  3. To unenroll multiple agents, bulk select the agents and click Unenroll agents.

    Unable to select multiple agents? Confirm that your subscription level supports selective agent unenrollment in {fleet}. For more information, refer to {subscriptions}[{stack} subscriptions].

Unenrolled agents will continue to run, but will not be able to send data. They will show this error instead: invalid api key to authenticate with fleet.

Tip
If unenrollment hangs, select Force unenroll to invalidate all API keys related to the agent and change the status to inactive so that the agent no longer appears in {fleet}.
Note
Enrollment handling for {agent} in a containerized environment has some special nuances. For details refer to [containers-agent-enrollment-handling].