To adapt the Elastic APM agent to your needs, you can configure it using different configuration sources, which have different naming conventions for the property key. The first configuration sources override the configuration values of over the latter sources.

  1. Java system properties All configuration keys are prefixed with elastic.apm.
  2. Environment variables All configuration keys are in uppercase and prefixed with ELASTIC_APM_
  3. file You can place a in the same directory the agent jar resides in. No prefix is required for the configuration keys.

Configuration options marked with Dynamic true can be changed at runtime via configuration sources which support dynamic reloading. Java system properties can be set from within the application.

In order to get started with Elastic APM, the most important configuration options are service_nameedit (required), server_urledit and application_packagesedit. So a minimal version of a configuration might look like this:

System properties.