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 »

› › › ›

Step 2: Add and configure the APM integration

edit

Step 2: Add and configure the APM integration

edit

In Kibana, select Add integrations > Elastic APM.
Click Add Elastic APM.
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.
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.
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.
To view the new policy, click Agent policy 1.

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.15.5
{ "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 »