OpenTelemetry Java Contrib

This project is intended to provide helpful libraries and standalone OpenTelemetry-based utilities that don't fit the express scope of the OpenTelemetry Java or Java Instrumentation projects. If you need an easier way to bring observability to remote JVM-based applications and workflows that isn't easily satisfied by an SDK feature or via instrumentation, this project is hopefully for you.

Provided Libraries

• AWS Resources
• AWS X-Ray SDK Support
• AWS X-Ray Propagator
• zstd Compressor
• Consistent Sampling
• Disk Buffering
• JMX Metric Gatherer
• No-Op API
• OpenTelemetry Maven Extension
• Prometheus Client Bridge
• Resource Providers
• Runtime Attach
• Samplers
• Static Instrumenter
• Kafka Support

Getting Started

# Apply formatting
$ ./gradlew spotlessApply

# Build the complete project
$ ./gradlew build

# Run integration tests
$ ./gradlew integrationTest

# Clean artifacts
$ ./gradlew clean

Contributing

The Java Contrib project was initially formed to provide methods of easy remote JMX metric gathering and reporting, which is actively in development. If you have an idea for a similar use case in the metrics, traces, or logging domain we would be very interested in supporting it. Please open an issue to share your idea or suggestion. PRs are always welcome and greatly appreciated, but for larger functional changes a pre-coding introduction can be helpful to ensure this is the correct place and that active or conflicting efforts don't exist.

Triagers (@open-telemetry/java-contrib-triagers):

• All component owners are given Triager permissions to this repository.

Approvers (@open-telemetry/java-contrib-approvers):

• John Watson, Verta.ai

Maintainers (@open-telemetry/java-contrib-maintainers):

• Jack Berg, New Relic
• Jason Plumb, Splunk
• Lauri Tulmin, Splunk
• Trask Stalnaker, Microsoft

Emeritus maintainers:

• Mateusz Rzeszutek
• Nikita Salnikov-Tarnovski, Splunk
• Ryan Fitzpatrick, Splunk

Learn more about roles in the community repository.

Thanks to all the people who already contributed!