4.2.0

What's Changed

This release brings exclusions for request log generation by URI path. See the Servlet Instrumentation documentation for details. The OpenTelemetry extension now also supports file-based service bindings.

• Support file-base VCAP_SERVICES bindings by @KarstenSchnitter in #363
• Upgrade sample app to Spring Boot 4.0.5 and JUnit 6.0.3 by @KarstenSchnitter in #365
• Allow excluding request logs for URI path patterns. by @KarstenSchnitter in #366
• Bump io.opentelemetry.contrib:opentelemetry-cloudfoundry-resources from 1.54.0-alpha to 1.55.0-alpha by @dependabot[bot] in #367
• Improve resilience of service loader by @KarstenSchnitter in #369
• Remove beats code generation and document Fields.java with JavaDoc by @KarstenSchnitter in #368
• Create Final Release 4.2.0 by @KarstenSchnitter in #372

Full Changelog: 4.1.1...4.2.0

4.1.1

What's Changed

This release upgrades dependencies to match Spring Boot 3.5.12 and the latest OpenTelemetry Java Agent 2.25.0. It also contains a fix for the Dynatrace token-name property.

Details

• Bump ch.qos.logback:logback-classic from 1.5.23 to 1.5.24 by @dependabot[bot] in #331
• Fix Dynatrace Token-Name property by @KarstenSchnitter in #341
• Bump org.sonatype.central:central-publishing-maven-plugin from 0.9.0 to 0.10.0 by @dependabot[bot] in #333
• Bump org.codehaus.mojo:buildnumber-maven-plugin from 3.2.1 to 3.3.0 by @dependabot[bot] in #335
• Bump org.assertj:assertj-core from 3.27.6 to 3.27.7 by @dependabot[bot] in #340
• Bump mockito.version from 5.21.0 to 5.22.0 by @dependabot[bot] in #351
• Bump ch.qos.logback:logback-classic from 1.5.24 to 1.5.32 by @dependabot[bot] in #350
• Minor Version upgrade of Spring Boot to v3.5.12 by @KarstenSchnitter in #352
• Bump com.auth0:java-jwt from 4.5.0 to 4.5.1 by @dependabot[bot] in #342
• Bump io.opentelemetry.javaagent:opentelemetry-javaagent from 2.23.0 to 2.25.0 by @dependabot[bot] in #346
• Bump opentelemetry.sdk.version from 1.57.0 to 1.60.1 by @dependabot[bot] in #348
• Bump io.opentelemetry.contrib:opentelemetry-cloudfoundry-resources from 1.52.0-alpha to 1.54.0-alpha by @dependabot[bot] in #349
• Bump org.apache.maven.plugins:maven-shade-plugin from 3.6.1 to 3.6.2 by @dependabot[bot] in #358
• Bump org.apache.maven.plugins:maven-compiler-plugin from 3.14.1 to 3.15.0 by @dependabot[bot] in #357
• Bump mockito.version from 5.22.0 to 5.23.0 by @dependabot[bot] in #353
• Create final Release 4.1.1 by @KarstenSchnitter in #359

Full Changelog: 4.1.0...4.1.1

4.1.0

What's Changed

This release only contains improvements on the opentelemetry agent extension. For the other components it includes only minor upgrades of dependencies. For the extension this release introduces three major changes:

• Allow metric filtering by name in #310
• Add support for Collector-as-a-Service in #326
• New configuration properties in #318

All these changes are documented in the README.md

Details

• Bump ch.qos.logback:logback-classic from 1.5.20 to 1.5.21 by @dependabot[bot] in #301
• Bump log4j2.version from 2.24.3 to 2.25.2 by @dependabot[bot] in #295
• Bump opentelemetry.sdk.version from 1.55.0 to 1.56.0 by @dependabot[bot] in #300
• Bump org.apache.maven.plugins:maven-jar-plugin from 3.4.2 to 3.5.0 by @dependabot[bot] in #303
• Bump com.squareup.okhttp3:okhttp from 5.3.0 to 5.3.2 by @dependabot[bot] in #305
• Fix OTel config attribute by @KarstenSchnitter in #309
• Allow metric filtering by name by @KarstenSchnitter in #310
• Fix Configuration parsing by @KarstenSchnitter in #312
• Bump org.apache.maven.plugins:maven-source-plugin from 3.3.1 to 3.4.0 by @dependabot[bot] in #311
• Add sanitization for span attributes by @KarstenSchnitter in #314
• Bump ch.qos.logback:logback-classic from 1.5.21 to 1.5.22 by @dependabot[bot] in #319
• Bump mockito.version from 5.20.0 to 5.21.0 by @dependabot[bot] in #317
• Refactor Configuration Properties by @KarstenSchnitter in #318
• Bump log4j2.version from 2.25.2 to 2.25.3 by @dependabot[bot] in #322
• Add support for CaaS by @KarstenSchnitter in #326
• Bump ch.qos.logback:logback-classic from 1.5.22 to 1.5.23 by @dependabot[bot] in #328
• Bump org.codehaus.mojo:exec-maven-plugin from 3.6.2 to 3.6.3 by @dependabot[bot] in #327
• Bump io.opentelemetry.javaagent:opentelemetry-javaagent from 2.21.0 to 2.23.0 by @dependabot[bot] in #321
• Bump opentelemetry.sdk.version from 1.56.0 to 1.57.0 by @dependabot[bot] in #316
• Bump io.opentelemetry.contrib:opentelemetry-cloudfoundry-resources from 1.51.0-alpha to 1.52.0-alpha by @dependabot[bot] in #308
• Fix deprecation messages for default values by @KarstenSchnitter in #329
• Create Final Release 4.1.0 by @KarstenSchnitter in #330

Full Changelog: 4.0.0...4.1.0

4.0.0

Welcome to the new major release

This release introduces major changes to cf-java-logging-support. The library now requires Java 17.x+ and SLF4J 2.x+. If you need support for older versions (including javax.servlet) please stay on the 3.x release.

Noticable changes

If you upgrade from an earlier release of this library, you should be able to keep your current configuration. But you might need to change your dependencies to accommodate for the renaming of cf-java-logging-support-servlet-jakarta to cf-java-logging-support-servlet. This is likely to be the only breaking change.

Upgrades

• Java 17 is required (except for OpenTelemetry Java Agent extension which need Java 11)
• Jakarta Servlet API only
• SLF4j 2.x and corresponding versions of Logback and Log4j2

Removals

• cf-java-logging-support-servlet-jakarta (moved to cf-java-logging-support-servlet)
• cf-java-logging-support-jersey
• cf-java-monitoring-custom-metrics-clients/*
• sample app using Jersey

Note, that for sending custom metrics it is recommended to use the OpenTelemetry Java Agent with the cf-java-logging-support-opentelemetry-agent-extension.

New Features

• Support for key-value-pairs in SLF4J's fluent API
• SPI extensions points for
  • ContextFieldSupplier, LogbackContextFieldSupplier, and Log4jContextFieldSupplier
  • DynamicLogLevelConfiguration and DynamicLogLevelProcessor
• auto-detection of service bindings to SAP Application Logging service for SAP BTP and formatting of custom fields accordingly

Breaking Changes

The main branch was force-pushed to contain the 4.x version of the library. You may need to reset your local repository, if you checked out the code before the creation of the release candidates.

The dynamic log level feature has been refactored. It now requires cf-java-logging-support-servlet-dynlog-jwt as additional dependency. The original configuration still applies but if you implemented custom extensions you likely need to integrate with the new extension points. Please have a look at the Spring Boot Sample App that includes a custom integration with the dynamic log level feature.

What's Changed

• Draft Release 4: Basic Changes by @KarstenSchnitter in #173
• Integration of recent changes on main by @KarstenSchnitter in #196
• Fix Mocking in Unit Test by @KarstenSchnitter in #197
• Support SPI Loading of ContextFieldSuppliers for Logback by @KarstenSchnitter in #198
• Introduce SPI Loading for Log4j ContextFieldSuppliers by @KarstenSchnitter in #199
• Support SLF4J Key-Value-Pairs by @KarstenSchnitter in #200
• Extract JWT Implementation for Dynamic Log Levels by @KarstenSchnitter in #203
• Detect Bindings to SAP Application Logging Service by @KarstenSchnitter in #204

Full Changelog: v3.8.6...4.0.0

v3.8.6

What's Changed

This is a minor upgrade of dependencies. The OTel SDK is required to be compatible with newer releases of the OTel SDK.
It contains code changes that fix compile errors because of removed or now restricted functions.

• Upgrade OTel SDK Dependency by @KarstenSchnitter in #212
• Bump org.apache.commons:commons-lang3 from 3.12.0 to 3.18.0 in /cf-java-logging-support-core by @dependabot[bot] in #211

Full Changelog: v3.8.5...v3.8.6

v3.8.5

What's Changed

This release upgrades several dependencies. Most noticeable are the java-jwt and jackson upgrades. The OpenTelemetry Java Agent extension has been changed to avoid the io.pivotal.cfenv dependency altogether. With this release the extension gains the ability to emit CF resource attributes following the semantic convention.

• Remove io.pivotal.cfenv by @KarstenSchnitter in #207
• Upgrade Jackson to v2.18.2 by @KarstenSchnitter in #194
• Upgrade Java-JWT to version 4 by @KarstenSchnitter in #188
• Adjust Community Files by @KarstenSchnitter in #189
• Bump org.eclipse.jetty:jetty-server from 11.0.14 to 11.0.24 in /cf-java-logging-support-servlet-jakarta by @dependabot in #190
• Bump org.eclipse.jetty:jetty-server from 9.4.51.v20230217 to 9.4.55.v20240627 in /cf-java-logging-support-servlet by @dependabot in #191
• [chore]:Reuse API update - Migration from dep5 file to TOML file. by @sap-ospo-bot in #202
• Bump org.eclipse.jetty:jetty-server from 9.4.55.v20240627 to 9.4.56.v20240826 in /cf-java-logging-support-servlet by @dependabot in #206

Full Changelog: v3.8.4...v3.8.5

v3.8.4

What's Changed

This release contains several improvements on the servlet instrumentation contributed by @j-denner. It also features an improvement for the OpenTelemetry Dynatrace exporter: By default the preferred aggregation temporality is now set to always_delta instead of the delta_preferred provided by the OpenTelemetry SDK. The difference is, that the exporter will also use delta aggregation temporality for up-and-down counters. This is necessary, since Dynatrace will otherwise drop metrics of this type. You can switch the aggregation temporality with system property otel.exporter.dynatrace.metrics.temporality.preference.

• Fix typo in fields documentation by @vtintillier in #176
• DynLogEnvironment - Also wrap configuration with a LazyInitializer. by @j-denner in #182
• Some corrections and performance improvements in CorrelationIdFilter by @j-denner in #183
• AddHttpHeaderToLogContextFilter: Filter immediately for getField presence by @j-denner in #184
• Fix Aggregation Temporality in Dynatrace Exporter by @KarstenSchnitter in #181

New Contributors

• @vtintillier made their first contribution in #176

Full Changelog: v3.8.3...v3.8.4

Many thanks to all contributors to this release.

v3.8.3

This is a bugfix release for the dynatrace exporter for metrics. Dynatrace requires metrics of kind sum to have delta aggregation temporality. Metrics with cumulative aggregation temporality are currently dropped by the API.

What's Changed

• Fix Dynatrace Exported to Generate DELTA Temporality by default and allow manual reconfiguration by @KarstenSchnitter in #174

Full Changelog: v3.8.2...v3.8.3

v3.8.2

This release just improves on the cf-java-logging-support-opentelemetry-agent-extension. It now provides a dynatrace exporters for metrics. This will detect bindings to SAP BTP APM and allow the OpenTelemetry Java Agent to forward metrics to Dynatrace. See the documentation on the required configuration.

What's Changed

• Provide Dynatrace Exporter by @KarstenSchnitter in #170
• Fix default property names by @KarstenSchnitter in #171

Full Changelog: v3.8.1...v3.8.2

v3.8.1

This release upgrades Logback to version 1.2.13 to mitigate CVE-2023-6378. Please upgrade your dependencies. Note, that the CVE issue is within an optionally configurable log receiver of an application, that not only requires explicit configuration in the logback files, but also adding an appropriate route in the CF manifest of the application.

The release also extends the module: cf-java-logging-support-opentelemetry-agent-extension. It now provides an cloud-logging exporter to be used with the OpenTelemetry Java Agent. This allows to combine the SAP Cloud Logging support with other OpenTelemetry targets. Additionally, all bound service instances will now be configured as data sinks.

What's Changed

• Upgrade logback to 1.2.13 by @KarstenSchnitter in #168
• Introduce Cloud Logging Exporter by @KarstenSchnitter in #169

Full Changelog: v3.8.0...v3.8.1