Bumps [spring-boot-dependencies](https://github.com/spring-projects/spring-boot) from 2.7.2 to 2.7.3. <details> <summary>Release notes</summary> <p><em>Sourced from <a href="https://github.com/spring-projects/spring-boot/releases">spring-boot-dependencies's releases</a>.</em></p> <blockquote> <h2>v2.7.3</h2> <h2>🐞 Bug Fixes</h2> <ul> <li>Misleading error message when using JarMode Layertools and the source is not an archive <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32097">#32097</a></li> <li>ClassNotFoundException can be thrown for classes in nested jars when under GC pressure <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32085">#32085</a></li> <li>Flyway auto-configuration fails with Flyway 9 <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32034">#32034</a></li> <li>BasicJsonParser does not protect against deeply nested maps <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32031">#32031</a></li> <li>OptionalLiveReloadServer logs the wrong port number when it is configured to use an ephemeral port <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31984">#31984</a></li> <li>Servlet WebServerStartStopLifecycle doesn't set running to false on stop <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31967">#31967</a></li> <li>JUL-based logging performed during close of application context is lost <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31963">#31963</a></li> <li>The hash of spring-boot-jarmode-layertools.jar that's added to a fat jar doesn't match the hash of the equivalent published artifact <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31949">#31949</a></li> <li>management.endpoint.health.probes.add-additional-paths has no effect when configuration properties have already created the liveness and/or readiness groups <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31926">#31926</a></li> <li>UnsupportedDataSourcePropertyException is thrown when attempting to set jdbcUrl for C3P0 <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31921">#31921</a></li> <li>Dev Tools restart failures caused by a too short quiet period are hard to diagnose <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31906">#31906</a></li> <li>HealthContributor beans managed by a CompositeHealthContributor are recreated on each call <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31879">#31879</a></li> <li>Dependency management for REST Assured is incomplete <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31877">#31877</a></li> <li>Jar Handler never clears PROTOCOL_HANDLER system property <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31875">#31875</a></li> <li>BasicJsonParser can fail with a timeout or stackoverflow with malformed map JSON <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31873">#31873</a></li> <li>BasicJsonParser can fail with a stackoverflow exception <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31871">#31871</a></li> </ul> <h2>📔 Documentation</h2> <ul> <li>Review Git contribution documentation <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32099">#32099</a></li> <li>Documentation for Maven Plugin classifier has an unresolved external reference <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32043">#32043</a></li> <li>Update Static Content reference documentation to reflect the DefaultServlet no longer being enabled by default <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32026">#32026</a></li> <li>Example log output is out-of-date and inconsistent <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31987">#31987</a></li> <li>Document that Undertow's record-request-start-time server option must be enabled for %D to work in access logging <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31976">#31976</a></li> <li>Update documentation on using H2C to consider running behind a proxy that's performing TLS termination <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31974">#31974</a></li> <li>Some properties in the Common Application Properties appendix have no description <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31971">#31971</a></li> <li>Fix links in documentations <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31951">#31951</a></li> <li>External configuration documentation uses incorrect placeholder syntax <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31943">#31943</a></li> <li>server.reactive.session.cookie properties are not listed in the application properties appendix <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31914">#31914</a></li> <li>Remove documentation and metadata references to ConfigFileApplicationListener <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31901">#31901</a></li> <li>Metadata for 'spring.beaninfo.ignore' has incorrect SourceType <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31899">#31899</a></li> <li>Remove reference to nitrite-spring-boot-starter <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31893">#31893</a></li> <li>Remove reference to Azure Application Insights <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31890">#31890</a></li> <li>Fix typos in code and documentation <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31865">#31865</a></li> </ul> <h2>🔨 Dependency Upgrades</h2> <ul> <li>Upgrade to Byte Buddy 1.12.13 <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32013">#32013</a></li> <li>Upgrade to Couchbase Client 3.3.3 <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32014">#32014</a></li> <li>Upgrade to Dependency Management Plugin 1.0.13.RELEASE <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32056">#32056</a></li> <li>Upgrade to Dropwizard Metrics 4.2.11 <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32015">#32015</a></li> <li>Upgrade to Embedded Mongo 3.4.8 <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32016">#32016</a></li> <li>Upgrade to GraphQL Java 18.3 <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/31945">#31945</a></li> <li>Upgrade to Groovy 3.0.12 <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32017">#32017</a></li> <li>Upgrade to Gson 2.9.1 <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32018">#32018</a></li> <li>Upgrade to Hazelcast 5.1.3 <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32019">#32019</a></li> <li>Upgrade to Hibernate Validator 6.2.4.Final <a href="https://github-redirect.dependabot.com/spring-projects/spring-boot/issues/32020">#32020</a></li> </ul> <!-- raw HTML omitted --> </blockquote> <p>... (truncated)</p> </details> <details> <summary>Commits</summary> <ul> <li><a href=" |
||
---|---|---|
.githooks | ||
.github | ||
benchmark-jfr-analyzer | ||
benchmark-overhead | ||
benchmark-overhead-jmh | ||
bom | ||
bom-alpha | ||
buildscripts | ||
conventions | ||
custom-checks | ||
dependencyManagement | ||
docs | ||
examples | ||
gradle/wrapper | ||
gradle-plugins | ||
instrumentation | ||
instrumentation-annotations | ||
instrumentation-annotations-support | ||
instrumentation-annotations-support-testing | ||
instrumentation-api | ||
instrumentation-api-semconv | ||
instrumentation-appender-api-internal | ||
instrumentation-appender-sdk-internal | ||
javaagent | ||
javaagent-bootstrap | ||
javaagent-extension-api | ||
javaagent-internal-logging-simple | ||
javaagent-tooling | ||
licenses | ||
muzzle | ||
opentelemetry-api-shaded-for-instrumenting | ||
opentelemetry-ext-annotations-shaded-for-instrumenting | ||
opentelemetry-instrumentation-annotations-shaded-for-instrumenting | ||
opentelemetry-instrumentation-api-shaded-for-instrumenting | ||
smoke-tests | ||
testing | ||
testing-common | ||
.editorconfig | ||
.gitattributes | ||
.gitignore | ||
CHANGELOG.md | ||
CONTRIBUTING.md | ||
LICENSE | ||
README.md | ||
RELEASING.md | ||
VERSIONING.md | ||
build.gradle.kts | ||
code-of-conduct.md | ||
gradle.properties | ||
gradlew | ||
gradlew.bat | ||
settings.gradle.kts | ||
version.gradle.kts |
README.md
<p align="center"> <strong> <a href="https://github.com/open-telemetry/opentelemetry-java-instrumentation#getting-started">Getting Started</a> • <a href="https://github.com/open-telemetry/community#special-interest-groups">Getting Involved</a> • <a href="https://github.com/open-telemetry/opentelemetry-java-instrumentation/discussions">Getting In Touch</a> </strong> </p> <p align="center"> <a href="https://github.com/open-telemetry/opentelemetry-java-instrumentation/actions/workflows/build.yml"> <img alt="Build Status" src="https://img.shields.io/github/workflow/status/open-telemetry/opentelemetry-java-instrumentation/Build?style=for-the-badge"> </a> <a href="https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases"> <img alt="GitHub release (latest by date including pre-releases)" src="https://img.shields.io/github/v/release/open-telemetry/opentelemetry-java-instrumentation?include_prereleases&style=for-the-badge"> </a> <img alt="Beta" src="https://img.shields.io/badge/status-beta-informational?style=for-the-badge&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAAAXNSR0IArs4c6QAAAIRlWElmTU0AKgAAAAgABQESAAMAAAABAAEAAAEaAAUAAAABAAAASgEbAAUAAAABAAAAUgEoAAMAAAABAAIAAIdpAAQAAAABAAAAWgAAAAAAAACQAAAAAQAAAJAAAAABAAOgAQADAAAAAQABAACgAgAEAAAAAQAAABigAwAEAAAAAQAAABgAAAAA8A2UOAAAAAlwSFlzAAAWJQAAFiUBSVIk8AAAAVlpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IlhNUCBDb3JlIDUuNC4wIj4KICAgPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4KICAgICAgPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIKICAgICAgICAgICAgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPgogICAgICAgICA8dGlmZjpPcmllbnRhdGlvbj4xPC90aWZmOk9yaWVudGF0aW9uPgogICAgICA8L3JkZjpEZXNjcmlwdGlvbj4KICAgPC9yZGY6UkRGPgo8L3g6eG1wbWV0YT4KTMInWQAABK5JREFUSA2dVm1sFEUYfmd2b/f2Pkqghn5eEQWKrRgjpkYgpoRCLC0oxV5apAiGUDEpJvwxEQ2raWPU+Kf8INU/RtEedwTCR9tYPloxGNJYTTQUwYqJ1aNpaLH3sXu3t7vjvFevpSqt7eSyM+/czvM8877PzB3APBoLgoDLsNePF56LBwqa07EKlDGg84CcWsI4CEbhNnDpAd951lXE2NkiNknCCTLv4HtzZuvPm1C/IKv4oDNXqNDHragety2XVzjECZsJARuBMyRzJrh1O0gQwLXuxofxsPSj4hG8fMLQo7bl9JJD8XZfC1E5yWFOMtd07dvX5kDwg6+2++Chq8txHGtfPoAp0gOFmhYoNFkHjn2TNUmrwRdna7W1QSkU8hvbGk4uThLrapaiLA2E6QY4u/lS9ItHfvJkxYsTMVtnAJLipYIWtVrcdX+8+b8IVnPl/R81prbuPZ1jpYw+0aEUGSkdFsgyBIaFTXCm6nyaxMtJ4n+TeDhJzGqZtQZcuYDgqDwDbqb0JF9oRpIG1Oea3bC1Y6N3x/WV8Zh83emhCs++hlaghDw+8w5UlYKq2lU7Pl8IkvS9KDqXmKmEwdMppVPKwGSEilmyAwJhRwWcq7wYC6z4wZ1rrEoMWxecdOjZWXeAQClBcYDN3NwVwD9pGwqUSyQgclcmxpNJqCuwLmDh3WtvPqXdlt+6Oz70HPGDNSNBee/EOen+rGbEFqDENBPDbtdCp0ukPANmzO0QQJYUpyS5IJJI3Hqt4maS+EB3199ozm8EDU/6fVNU2dQpdx3ZnKzeFXyaUTiasEV/gZMzJMjr3Z+WvAdQ+hs/zw9savimxUntDSaBdZ2f+Idbm1rlNY8esFffBit9HtK5/MejsrJVxikOXlb1Ukir2X+Rbdkd1KG2Ixfn2Ql4JRmELnYK9mEM8G36fAA3xEQ89fxXihC8q+sAKi9jhHxNqagY2hiaYgRCm0f0QP7H4Fp11LSXiuBY2aYFlh0DeDIVVFUJQn5rCnpiNI2gvLxHnASn9DIVHJJlm5rXvQAGEo4zvKq2w5G1NxENN7jrft1oxMdekETjxdH2Z3x+VTVYsPb+O0C/9/auN6v2hNZw5b2UOmSbG5/rkC3LBA+1PdxFxORjxpQ81GcxKc+ybVjEBvUJvaGJ7p7n5A5KSwe4AzkasA+crmzFtowoIVTiLjANm8GDsrWW35ScI3JY8Urv83tnkF8JR0yLvEt2hO/0qNyy3Jb3YKeHeHeLeOuVLRpNF+pkf85OW7/zJxWdXsbsKBUk2TC0BCPwMq5Q/CPvaJFkNS/1l1qUPe+uH3oD59erYGI/Y4sce6KaXYElAIOLt+0O3t2+/xJDF1XvOlWGC1W1B8VMszbGfOvT5qaRRAIFK3BCO164nZ0uYLH2YjNN8thXS2v2BK9gTfD7jHVxzHr4roOlEvYYz9QIz+Vl/sLDXInsctFsXjqIRnO2ZO387lxmIboLDZCJ59KLFliNIgh9ipt6tLg9SihpRPDO1ia5byw7de1aCQmF5geOQtK509rzfdwxaKOIq+73AvwCC5/5fcV4vo3+3LpMdtWHh0ywsJC/ZGoCb8/9D8F/ifgLLl8S8QWfU8cAAAAASUVORK5CYII="> </p> <p align="center"> <strong> <a href="CONTRIBUTING.md">Contributing<a/> • <a href="docs/scope.md">Scope<a/> </strong> </p>
Getting Started • Getting Involved • Getting In Touch
OpenTelemetry Instrumentation for Java
- About
- Getting Started
- Configuring the Agent
- Supported libraries, frameworks, and application servers
- Creating agent extensions
- Manually instrumenting
- Logger MDC auto-instrumentation
- Troubleshooting
- Contributing
About
This project provides a Java agent JAR that can be attached to any Java 8+ application and dynamically injects bytecode to capture telemetry from a number of popular libraries and frameworks. You can export the telemetry data in a variety of formats. You can also configure the agent and exporter via command line arguments or environment variables. The net result is the ability to gather telemetry data from a Java application without code changes.
This repository also publishes standalone instrumentation for several libraries (and growing) that can be used if you prefer that over using the Java agent. Please see standalone library instrumentation if you are looking for documentation on using those.
Getting Started
Download the latest version.
This package includes the instrumentation agent as well as instrumentations for all supported libraries and all available data exporters. The package provides a completely automatic, out-of-the-box experience.
Enable the instrumentation agent using the -javaagent
flag to the JVM.
java -javaagent:path/to/opentelemetry-javaagent.jar \
-jar myapp.jar
By default, the OpenTelemetry Java agent uses
OTLP exporter
configured to send data to
OpenTelemetry collector
at http://localhost:4317
.
Configuration parameters are passed as Java system properties (-D
flags) or
as environment variables. See the configuration documentation
for the full list of configuration items. For example:
java -javaagent:path/to/opentelemetry-javaagent.jar \
-Dotel.resource.attributes=service.name=your-service-name \
-Dotel.traces.exporter=zipkin \
-jar myapp.jar
Configuring the Agent
The agent is highly configurable! Many aspects of the agent's behavior can be configured for your needs, such as exporter choice, exporter config (like where data is sent), trace context propagation headers, and much more.
Click here to see the detailed list of configuration environment variables and system properties.
Note: Config parameter names are very likely to change over time, so please check back here when trying out a new version! Please report any bugs or unexpected behavior you find.
Supported libraries, frameworks, and application servers
We support an impressively huge number of libraries and frameworks and a majority of the most popular application servers...right out of the box! Click here to see the full list and to learn more about disabled instrumentation and how to suppress unwanted instrumentation.
Creating agent extensions
Extensions add new features and capabilities to the agent without having to create a separate distribution or to fork this repository. For example, you can create custom samplers or span exporters, set new defaults, and embed it all in the agent to obtain a single jar file.
Manually instrumenting
For most users, the out-of-the-box instrumentation is completely sufficient and nothing more has to be done. Sometimes, however, users wish to add attributes to the otherwise automatic spans, or they might want to manually create spans for their own custom code.
For detailed instructions, see Manual instrumentation.
Logger MDC (Mapped Diagnostic Context) auto-instrumentation
It is possible to inject trace information like trace IDs and span IDs into your custom application logs. For details, see Logger MDC auto-instrumentation.
Troubleshooting
To turn on the agent's internal debug logging:
-Dotel.javaagent.debug=true
Note: These logs are extremely verbose. Enable debug logging only when needed. Debug logging negatively impacts the performance of your application.
Contributing
See CONTRIBUTING.md.
Triagers (@open-telemetry/java-instrumentation-triagers):
- Jack Berg, New Relic
- Jason Plumb, Splunk
Approvers (@open-telemetry/java-instrumentation-approvers):
- Jack Berg, New Relic
- John Watson, Verta.ai
- Pavol Loffay, Traceable.ai
Maintainers (@open-telemetry/java-instrumentation-maintainers):
- Lauri Tulmin, Splunk
- Mateusz Rzeszutek, Splunk
- Nikita Salnikov-Tarnovski, Splunk
- Trask Stalnaker, Microsoft
Learn more about roles in the community repository.
Thanks to all the people who already contributed!