Appendix A: Install a Fleet-managed Elastic Agent

edit

Appendix A: Install a Fleet-managed Elastic Agent

edit

This guide describes how to:

  • Install an Elastic Agent that will be managed with Fleet
  • Enroll the Elastic Agent in Fleet

These steps assume that Elastic Stack is running and an Elastic Integration has been added in Kibana. If this is not true — don’t worry, check out one of the Quick Starts and get started with Elastic Cloud.

You can install only a single Elastic Agent per host.

Prerequisites

edit
  • The Elastic Stack is running.
  • You have added an integration in Kibana and are now ready to download and enroll Elastic Agent on your system.

Step 1: Add an Elastic Agent to Fleet

edit

Elastic Agent is a single, unified agent that you can deploy to hosts or containers to collect data and send it to the Elastic Stack. Behind the scenes, Elastic Agent runs the Beats shippers or Elastic Endpoint required for your configuration.

Choose the operating system and run the provided commands to download and extract Elastic Agent on your system.

curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.12.2-darwin-x86_64.tar.gz
tar xzvf elastic-agent-8.12.2-darwin-x86_64.tar.gz

Step 2: Enroll and start the Elastic Agent

edit

Return to Kibana and follow the Enroll and start the Elastic Agent instructions. The command provided in Kibana includes the information that Elastic Agent needs to connect and authenticate with the Elastic Stack. When the Elastic Agent enrolls it will be configured to send the data associated with the policy that you created.