Welcome to the APM Java Agent documentation.

Elastic APM automatically measures the performance of your application and tracks errors. For example, it records spans for database queries and transactions for incoming HTTP requests. See Supported technologiesedit to learn about which frameworks and technologies the Elastic APM Java agent supports out-of-the-box.

Spans are grouped in transactions - by default one for each incoming HTTP request. But it’s possible to create custom transactions not associated with an HTTP request.

By default the agent comes with support for common frameworks out-of-the-box. To instrument other events, you can use custom spans. For information about custom spans, see the public api documentation.


The minimum required version of the APM Server is 6.5.0

Additional Componentsedit

APM Agents work in conjunction with the APM Server, Elasticsearch, and Kibana. Please view the APM Overview for details on how these components work together.

Get startededit

The first step in getting started with the Elastic APM Java agent is to download the latest release of the agent jar file from maven central.


Don’t declare a dependency to the agent in your application.


Once you are set with instrumenting your favorite framework, see the configuration guide on how to configure Elastic APM.

Add javaagent flagedit

When starting your application, add the JVM flag -javaagent:/path/to/elastic-apm-agent-<version>.jar

See Setup the agent with Application Servers for server specific installation instructions.

Supported technologiesedit

Please check the supported technologies page whether the Elastic APM agent supports auto-instrumentation of the technologies your application is using.