Configuration

To adapt the Elastic APM Java agent to your needs, you can configure it using one of the methods below, listed in descending order of precedence:

1) Central configuration	Configure the Agent in the Kibana APM app.
2) Properties file	The `elasticapm.properties` file is located in the same folder as the agent jar, or provided through the `config_file` option.
3) Java system properties	All configuration keys are prefixed with `elastic.apm.`
4) Environment variables	All configuration keys are in uppercase and prefixed with `ELASTIC_APM_`.
5) Runtime attach parameters	`--config` parameter. See Automatic setup with `apm-agent-attach-cli.jar`. Arguments of `ElasticApmAttacher.attach(...)`. See Programmatic API setup to self-attach. `elasticapm.properties` in classpath root with `ElasticApmAttacher.attach()`. See Programmatic API setup to self-attach.
6) Default values	Defined for each configuration.

Dynamic configuration

edit

Configuration options marked with Dynamic true can be changed at runtime when set from supported sources:

Central configuration
elasticapm.properties file
Java system properties, but only when set from within the application

There are two distinct ways to use elasticapm.properties: as an external configuration file, and as a classpath resource.
Only the external file can be used for dynamic configuration.

Minimal configuration

edit

In order to get started with Elastic APM, the most important configuration options are service_name, server_url and application_packages. Note that even these settings are optional. Click on their name to see how the default values are determined.

An example configuration looks like this:

System properties.

-Delastic.apm.service_name=my-cool-service
-Delastic.apm.application_packages=org.example,org.another.example
-Delastic.apm.server_url=http://127.0.0.1:8200

elasticapm.properties.

service_name=my-cool-service
application_packages=org.example,org.another.example
server_url=http://127.0.0.1:8200

Environment variables.

ELASTIC_APM_SERVICE_NAME=my-cool-service
ELASTIC_APM_APPLICATION_PACKAGES=org.example,org.another.example
ELASTIC_APM_SERVER_URL=http://127.0.0.1:8200

Option reference

edit

This is a list of all configuration options grouped by their category. Click on a key to get more information.

« Supported technologies Circuit-Breaker configuration options »