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 technologies 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
There are three different ways to set up the Elastic APM Java Agent:
- Manual setup with
-javaagentflag - Manually set up and configure the agent with the
- Automatic setup with
apm-agent-attach-standalone.jar- Automatically set up the agent without needing to alter the configuration of your application server.
- Programmatic API setup to self-attach - Use the
apm-agent-attachartifact and the
attachAPI to set up the agent.
Once you’ve setup the agent, see the configuration guide on how to configure Elastic APM.
Please check the supported technologies page whether the Elastic APM agent supports auto-instrumentation of the technologies your application is using.