Skip to content

Commit 215754d

Browse files
adinauerclaude
andcommitted
docs(changelog): Clarify Logs and Metrics migration
Classify removal of the aggregate options as breaking changes and list the source-specific opt-ins for automatic Logs capture. Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 5bf5511 commit 215754d

1 file changed

Lines changed: 14 additions & 2 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,23 @@
1010
- Add a `logsEnabled` argument to the `SentryTimberIntegration` and `SentryTimberTree` JVM
1111
constructors. It defaults to `false` for Kotlin callers; Java callers using the explicit level
1212
constructors must pass the new argument. ([#5943](https://github.com/getsentry/sentry-java/pull/5943))
13+
- Remove the obsolete aggregate Sentry Metrics options `metrics.enabled` and
14+
`options.getMetrics().setEnabled(...)`. Direct `Sentry.metrics()` calls continue to capture
15+
Metrics whenever the SDK is enabled. ([#5953](https://github.com/getsentry/sentry-java/pull/5953))
16+
- Remove the obsolete aggregate Sentry Logs options `logs.enabled` and
17+
`options.getLogs().setEnabled(...)`. ([#5947](https://github.com/getsentry/sentry-java/pull/5947))
18+
Direct `Sentry.logger()` calls continue to capture Logs whenever the SDK is enabled. Sentry Logs
19+
capture is disabled by default for every automatic logging integration. Set the applicable
20+
integration-specific option to `true` to opt in:
21+
- Logback appender: `logsEnabled`
22+
- Log4j2 appender: `logsEnabled`
23+
- JUL handler: `io.sentry.jul.SentryHandler.logsEnabled`
24+
- Spring Boot logging auto-configuration: `sentry.logging.logs-enabled`
25+
- Timber: `timberLogCaptureEnabled` or `io.sentry.timber.logs.enabled` manifest metadata
26+
- Logcat: `logcatLogCaptureEnabled` or `io.sentry.logcat.logs.enabled` manifest metadata
1327

1428
### Features
1529

16-
- Remove the aggregate Sentry Metrics enable flag; `Sentry.metrics()` calls now capture Metrics by default ([#5953](https://github.com/getsentry/sentry-java/pull/5953))
17-
- Remove the aggregate Sentry Logs enable flag; manual `Sentry.logger()` calls now capture Logs by default ([#5947](https://github.com/getsentry/sentry-java/pull/5947))
1830
- Add an explicit Logs opt-in to Spring Boot logging auto-configuration ([#5946](https://github.com/getsentry/sentry-java/pull/5946))
1931
- Add an explicit Logs opt-in to the Android Logcat integration ([#5945](https://github.com/getsentry/sentry-java/pull/5945))
2032
- Add an explicit Logs opt-in to the Android Timber integration ([#5943](https://github.com/getsentry/sentry-java/pull/5943))

0 commit comments

Comments
 (0)