Add an Elastic Agent integration to a policy

edit

Policies consist of one or more integrations. To add a new integration to a policy:

  1. In Kibana, go to Management → Integrations.

    Notice that the Integrations page shows Elastic Agent integrations along with other types, such as Beats.

  2. Scroll down and select Elastic Agent only so the view shows integrations that work with Elastic Agent.

    Screen capture showing options for filtering the view
  3. Search for and select an integration. You can select a category to narrow your search.
  4. Click Add <Integration>.
  5. Name the integration and add any required configuration variables.

    Integration policy names must be globally unique across all agent policies.

  6. Choose the agent policy you want to add the integration to. You can choose an existing agent policy or create a new one.
  7. Save the integration policy:

    • To use the UI, click Save integration.
    • To use the Fleet API, click Preview API request and run the request.

This action installs the integration (if it’s not already installed) and saves the integration policy as a part of the larger Elastic Agent policy. Fleet distributes this new policy to all Elastic Agents that are enrolled in the agent policy.

If you haven’t deployed any Elastic Agents yet or set up agent policies, start with one of our quick start guides: