New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Step 1: Set up Fleet Step 3: Install APM agents »
Elastic Docs ›Elastic Observability [8.13] ›Application performance monitoring (APM) ›Self manage APM Server ›Fleet-managed APM Server

Step 2: Add and configure the APM integration

edit

Step 2: Add and configure the APM integration

edit

  1. In Kibana, select Add integrations > Elastic APM.

    Fleet showing APM integration

  2. Click Add Elastic APM.

    Fleet showing APM integration overview

  3. On the Add Elastic APM integration page, define the host and port where APM Server will listen. Make a note of this value—​you’ll need it later.

    Using Docker or Kubernetes? Set the host to 0.0.0.0 to bind to all interfaces.

  4. Under Agent authorization, set a Secret token. This will be used to authorize requests from APM agents to the APM Server. Make a note of this value—​you’ll need it later.
  5. Click Save and continue. This step takes a minute or two to complete. When it’s done, you’ll have an agent policy that contains an APM integration policy for the configuration you just specified.

  6. To view the new policy, click Agent policy 1.

    Fleet showing apm policy

    Any Elastic Agents assigned to this policy will collect APM data from your instrumented services.

An internet connection is required to install the APM integration via the Fleet UI in Kibana.

If you don’t have an internet connection

If your environment has network traffic restrictions, there are other ways to install the APM integration. See Air-gapped environments for more information.

Option 1: Update kibana.yml

Update kibana.yml to include the following, then restart Kibana.

xpack.fleet.packages:
- name: apm
  version: latest

See Configure Kibana to learn more about how to edit the Kibana configuration file.

Option 2: Use the Fleet API

Use the Fleet API to install the APM integration. To be successful, this needs to be run against the Kibana API, not the Elasticsearch API.

POST kbn:/api/fleet/epm/packages/apm/8.13.4
{ "force": true }

See Kibana API to learn more about how to use the Kibana APIs.

« Step 1: Set up Fleet Step 3: Install APM agents »
Was this helpful?
Feedback