OpenTelemetry auto-instrumentation and instrumentation libraries for Java
Go to file
dependabot[bot] 90637cc434
Bump spring-boot-dependencies from 2.7.2 to 2.7.3 in /dependencyManagement (#6666)
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="bff9b3924f"><code>bff9b39</code></a>
Release v2.7.3</li>
<li><a
href="60e1cc510c"><code>60e1cc5</code></a>
Merge branch '2.6.x' into 2.7.x</li>
<li><a
href="13bd61b6fe"><code>13bd61b</code></a>
Revert nested jar fixes</li>
<li><a
href="bd74344025"><code>bd74344</code></a>
Revert &quot;Don't close jar files early&quot;</li>
<li><a
href="674022d401"><code>674022d</code></a>
Revert &quot;Don't close nested jars or wrapper when parent is
closed&quot;</li>
<li><a
href="3fcfcc4a3b"><code>3fcfcc4</code></a>
Merge branch '2.6.x' into 2.7.x</li>
<li><a
href="3b01325c6b"><code>3b01325</code></a>
Use asList consistently</li>
<li><a
href="ca63a6e9ad"><code>ca63a6e</code></a>
Merge branch '2.6.x' into 2.7.x</li>
<li><a
href="191593cf15"><code>191593c</code></a>
Review Git contribution documentation</li>
<li><a
href="1c6624db44"><code>1c6624d</code></a>
Merge branch '2.6.x' into 2.7.x</li>
<li>Additional commits viewable in <a
href="https://github.com/spring-projects/spring-boot/compare/v2.7.2...v2.7.3">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=org.springframework.boot:spring-boot-dependencies&package-manager=gradle&previous-version=2.7.2&new-version=2.7.3)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)


</details>

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2022-09-19 13:54:04 -07:00
.githooks Use Spotless for formatting (DataDog/dd-trace-java#1619) 2020-06-30 11:15:48 -07:00
.github More dependabot (#6647) 2022-09-19 11:13:31 -07:00
benchmark-jfr-analyzer Remove unshaded javax.annotation classes from bootstrap class loader (#4454) 2021-10-21 14:47:50 -07:00
benchmark-overhead Update dependencies (#6499) 2022-09-06 13:04:30 -07:00
benchmark-overhead-jmh Remove the 'noop API' feature (#6313) 2022-07-12 10:36:19 -07:00
bom Introduce non-alpha bom (#6576) 2022-09-11 12:17:38 -07:00
bom-alpha Add dependency from alpha bom to stable bom (#6611) 2022-09-14 08:22:29 -07:00
buildscripts Remove checkstyle CommentsIndentation (#6219) 2022-06-27 10:45:55 +03:00
conventions Add resource providers (#6574) 2022-09-14 15:45:24 -07:00
custom-checks Enable PrivateConstructorForUtilityClass errorprone check (#6427) 2022-08-10 11:30:22 +03:00
dependencyManagement Bump spring-boot-dependencies from 2.7.2 to 2.7.3 in /dependencyManagement (#6666) 2022-09-19 13:54:04 -07:00
docs Update squash merge message setting (#6649) 2022-09-19 08:39:11 -07:00
examples Fix examples in main branch (#6626) 2022-09-14 14:55:12 -07:00
gradle/wrapper Update gradle to 7.5.1 (#6359) 2022-08-12 12:03:43 +02:00
gradle-plugins Encapsulate logging (#6543) 2022-09-12 13:22:26 -07:00
instrumentation Move versions to dependencyManagement (#6648) 2022-09-19 12:05:06 +03:00
instrumentation-annotations Move instrumentation annotations to this repo (#6248) 2022-07-07 14:31:27 -07:00
instrumentation-annotations-support Enable PrivateConstructorForUtilityClass errorprone check (#6427) 2022-08-10 11:30:22 +03:00
instrumentation-annotations-support-testing Add code attributes to several instrumentations (#6365) 2022-07-27 09:37:01 +02:00
instrumentation-api Remove external usages of ClassNames (and move it to internal) (#6584) 2022-09-13 13:58:19 -07:00
instrumentation-api-semconv Remove external usages of ClassNames (and move it to internal) (#6584) 2022-09-13 13:58:19 -07:00
instrumentation-appender-api-internal Update SDK to 1.17.0 (#6467) 2022-08-12 17:10:46 -07:00
instrumentation-appender-sdk-internal Update SDK to 1.17.0 (#6467) 2022-08-12 17:10:46 -07:00
javaagent Encapsulate logging (#6543) 2022-09-12 13:22:26 -07:00
javaagent-bootstrap Encapsulate logging (#6543) 2022-09-12 13:22:26 -07:00
javaagent-extension-api Remove agent's Ordered interface and use the SDK one (#6589) 2022-09-12 12:15:18 -07:00
javaagent-internal-logging-simple Encapsulate logging (#6543) 2022-09-12 13:22:26 -07:00
javaagent-tooling Encapsulate logging (#6543) 2022-09-12 13:22:26 -07:00
licenses Move versions to dependencyManagement (#6648) 2022-09-19 12:05:06 +03:00
muzzle Encapsulate logging (#6543) 2022-09-12 13:22:26 -07:00
opentelemetry-api-shaded-for-instrumenting Fix a metrics API bridging issue (#6034) 2022-05-16 11:31:33 -07:00
opentelemetry-ext-annotations-shaded-for-instrumenting Support new annotations (and change of instrumentation name for opentelemetry-annotations) (#6296) 2022-07-11 14:34:26 -07:00
opentelemetry-instrumentation-annotations-shaded-for-instrumenting Support new annotations (and change of instrumentation name for opentelemetry-annotations) (#6296) 2022-07-11 14:34:26 -07:00
opentelemetry-instrumentation-api-shaded-for-instrumenting Instrument SpanKey directly (#5933) 2022-05-03 14:56:33 -07:00
smoke-tests Spring boot application class should have a public constructor (#6509) 2022-08-25 12:28:05 -07:00
testing More dep updates (#6555) 2022-09-07 08:18:08 +02:00
testing-common Reactor instrumentation: do not make root context current (#6593) 2022-09-14 11:23:18 -07:00
.editorconfig Update .editorconfig for properties files (#3677) 2021-07-26 14:16:36 -07:00
.gitattributes Add task to generate license report into licenses folder. (#2239) 2021-02-12 17:20:08 +09:00
.gitignore Remove and ignore .attach_pid files (#5348) 2022-02-11 09:37:52 -08:00
CHANGELOG.md Update version to 1.19.0-SNAPSHOT (#6623) 2022-09-14 12:43:01 -07:00
CONTRIBUTING.md Update (rewrite) the javaagent structure doc; document bootstrap modules (#6227) 2022-06-28 20:23:27 -07:00
LICENSE Update to standard LICENSE file for OpenTelemetry (#19) 2019-11-19 09:46:10 -08:00
README.md Add approver (#6422) 2022-08-09 08:14:50 -07:00
RELEASING.md Stabilize instrumentation-api and introduce jApiCmp checks (#6566) 2022-09-09 15:26:39 -07:00
VERSIONING.md Add guidance about dropping support for older library versions (#4802) 2021-12-06 22:37:29 -08:00
build.gradle.kts Sync github actions (#5695) 2022-03-29 10:21:17 -07:00
code-of-conduct.md Add code-of-conduct file. (#2341) 2021-02-19 16:24:41 +09:00
gradle.properties Small cleanups to conventions projects. (#4839) 2021-12-09 14:55:09 -08:00
gradlew Update gradle to 7.5.1 (#6359) 2022-08-12 12:03:43 +02:00
gradlew.bat Update gradle to 7.5.1 (#6359) 2022-08-12 12:03:43 +02:00
settings.gradle.kts Add resource providers (#6574) 2022-09-14 15:45:24 -07:00
version.gradle.kts Update version to 1.19.0-SNAPSHOT (#6623) 2022-09-14 12:43:01 -07:00

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,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"> </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

Build Status GitHub release (latest by date including pre-releases) Beta

Contributing   •   Scope

OpenTelemetry Icon OpenTelemetry Instrumentation for Java

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):

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

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

Learn more about roles in the community repository.

Thanks to all the people who already contributed!