https://github.com/elastic/apm-agent-java

https://github.com/elastic/apm-agent-java

apm tracing

Last synced: 6 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/elastic/apm-agent-java
• Owner: elastic
• License: apache-2.0
• Created: 2018-02-12T11:05:32.000Z (about 7 years ago)
• Default Branch: main
• Last Pushed: 2025-04-07T19:59:16.000Z (7 days ago)
• Last Synced: 2025-04-08T11:17:17.028Z (6 days ago)
• Topics: apm, tracing
• Language: Java
• Homepage: https://www.elastic.co/guide/en/apm/agent/java/current/index.html
• Size: 27.1 MB
• Stars: 572
• Watchers: 257
• Forks: 323
• Open Issues: 175
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.next-release.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

• awesome-java - Elastic APM

README

        
[![main](https://github.com/elastic/apm-agent-java/actions/workflows/main.yml/badge.svg)](https://github.com/elastic/apm-agent-java/actions/workflows/main.yml)

[![codecov](https://codecov.io/gh/elastic/apm-agent-java/branch/main/graph/badge.svg)](https://codecov.io/gh/elastic/apm-agent-java)

[![Maven Central](https://img.shields.io/maven-central/v/co.elastic.apm/apm-agent-api.svg)](https://mvnrepository.com/artifact/co.elastic.apm/elastic-apm-agent/latest)

# apm-agent-java

Please fill out this survey to help us prioritizing framework support: https://docs.google.com/forms/d/e/1FAIpQLScd0RYiwZGrEuxykYkv9z8Hl3exx_LKCtjsqEo1OWx8BkLrOQ/viewform?usp=sf_link

## Release announcements

To get notified about new releases, watch this repository for `Releases only`.

## Documentation

Docs are located [here](https://www.elastic.co/guide/en/apm/agent/java/current/index.html).

## Getting Help

If you find a bug or an issue, please

1. open a new topic on the [APM discuss forum](https://discuss.elastic.co/tags/c/apm/java) (or add to an existing one)

1. [report an issue](https://github.com/elastic/apm-agent-java/issues/new) on the java agent repository

Please note that we reserve GitHub tickets for actionable things we can work on, thus confirmed bugs and enhancement requests only.

Help requests are better served in [APM discuss forum](https://discuss.elastic.co/tags/c/observability/apm/58/java).

## Contributing

See the [contributing documentation](CONTRIBUTING.md)

## Snapshots

Snapshots are built from `main` branch and are available here:

* [elastic-apm-agent.jar](https://oss.sonatype.org/service/local/artifact/maven/redirect?r=snapshots&g=co.elastic.apm&a=elastic-apm-agent&v=LATEST)

* [apm-agent-attach-cli.jar](https://oss.sonatype.org/service/local/artifact/maven/redirect?r=snapshots&g=co.elastic.apm&a=apm-agent-attach-cli&v=LATEST)

* [apm-agent-attach.jar](https://oss.sonatype.org/service/local/artifact/maven/redirect?r=snapshots&g=co.elastic.apm&a=apm-agent-attach&v=LATEST)

* [apm-agent-api.jar](https://oss.sonatype.org/service/local/artifact/maven/redirect?r=snapshots&g=co.elastic.apm&a=apm-agent-api&v=LATEST)

Those snapshots include features & bugfixes for the next release, see [releases notes](https://www.elastic.co/guide/en/apm/agent/java/current/_unreleased.html) details.

## Build form source

Execute `./mvnw clean install -DskipTests=true -Dmaven.javadoc.skip=true` to build the artifacts and to install them to your local maven repository. The build process requires JDK 17.

The agent jar is in the folder `elastic-apm-agent/target`.

## License

Elastic APM Java Agent is licensed under [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0.html).