feat(core): Remove Logs and Metrics enable flags by adinauer · Pull Request #5939 · getsentry/sentry-java

adinauer · 2026-08-12T13:45:06Z

PR Stack (Logs and Metrics Enable Flags)

📜 Description

Collection PR for the Logs and Metrics enable-flag removal stack. Squash-merge this once all stack PRs are merged.

💡 Motivation and Context

Removes the aggregate Logs and Metrics enable flags, adds integration-local Logs opt-ins, and avoids starting unused batch worker threads.

💚 How did you test it?

Each PR in the stack includes focused tests. The completed stack will run the full repository checks and aggregate Javadocs.

📝 Checklist

I added GH Issue ID & Linear ID
I added tests to verify the changes.
No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled.
I updated the docs if needed.
I updated the wizard if needed.
Review from the native team if needed.
No breaking change or entry added to the changelog.
No breaking change for hybrid SDKs or communicated to hybrid SDKs.

🔮 Next steps

Merge each stack PR into this collection branch in order using merge commits, then squash-merge this PR into 9.x.x.

github-actions · 2026-08-12T13:45:43Z

	Messages
📖	Do not forget to update Sentry-docs with your feature once the pull request gets approved.

Generated by 🚫 dangerJS against fc98241

sentry · 2026-08-12T13:46:19Z

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
SDK Size	io.sentry.tests.size	8.59.0 (1)	release

⚙️ sentry-android Build Distribution Settings

Require an explicit Logback appender opt-in before forwarding records as Sentry Logs. Keep event and breadcrumb capture independent while the aggregate core Logs flag remains in place. Co-Authored-By: Claude <noreply@anthropic.com>

Require an explicit Log4j2 appender opt-in before forwarding records as Sentry Logs. Preserve existing constructors and factory methods with Logs disabled by default while keeping events and breadcrumbs unchanged. Co-Authored-By: Claude <noreply@anthropic.com>

Require an explicit JUL handler opt-in before forwarding records as Sentry Logs. Support Java and LogManager configuration while keeping event and breadcrumb capture unchanged. Co-Authored-By: Claude <noreply@anthropic.com>

Require an explicit Timber-local opt-in before forwarding Timber messages as Sentry Logs. Add Android options and manifest configuration for auto-installed integrations while preserving event and breadcrumb capture. Co-Authored-By: Claude <noreply@anthropic.com>

Require an explicit Android option before forwarding Logcat calls as Sentry Logs. Support Java and manifest configuration while keeping breadcrumbs and Android Log calls unchanged. Co-Authored-By: Claude <noreply@anthropic.com>

Add a Spring Boot logging property that controls Sentry Logs forwarding from auto-configured Logback appenders. Keep appender installation, events, and breadcrumbs independent from the new opt-in. Co-Authored-By: Claude <noreply@anthropic.com>

Capture manual Sentry Logs without an aggregate enable option and always create the configured logger batch processor. Keep automatic logging integrations controlled by their local opt-ins and remove legacy Logs configuration from active samples and fixtures. Co-Authored-By: Claude <noreply@anthropic.com>

Detect explicit io.sentry.logs.enabled Android manifest metadata and emit tailored migration warnings without changing the integration-local Logs options. Co-Authored-By: Claude <noreply@anthropic.com>

Keep parsing the nullable logs.enabled external option and emit tailored migration warnings for explicit true and false values without changing manual Logs capture. Co-Authored-By: Claude <noreply@anthropic.com>

Inspect the Spring Environment before SDK initialization and emit tailored migration warnings for explicit sentry.logs.enabled values without binding or applying the obsolete property. Co-Authored-By: Claude <noreply@anthropic.com>

Propagate removal of unused no-op telemetry batch processors through the stack while preserving branch ancestry.

feat(core): [Logs and Metrics Enable Flags 7] Remove Logs enable flag

perf(core): [Logs and Metrics Enable Flags 8] Avoid unused Logs worker thread

feat(core): [Logs and Metrics Enable Flags 9] Remove Metrics enable flag

…st-use perf(core): [Logs and Metrics Enable Flags 10] Avoid unused Metrics worker thread

fix(jul): [Logs and Metrics Enable Flags 11] Preserve null-message records

docs: [Logs and Metrics Enable Flags 12] Update options guidance

fix(android): [Logs and Metrics Enable Flags 13] Read Timber option lazily

Remove the constructor superseded by the minimumLevel overload in 8.16.0 at the v9 breaking-change boundary. Co-Authored-By: Claude <noreply@anthropic.com>

Rename the Timber and Logcat manifest options to describe Sentry's log capture direction consistently with their Android option accessors. Co-Authored-By: Claude <noreply@anthropic.com>

ref(logging): [Logs and Metrics Enable Flags 14] Rename Logs opt-ins

Resolve conflicts while preserving source-local Logs controls and the removal of aggregate Logs and Metrics flags. Co-Authored-By: Claude <noreply@anthropic.com>

List the exact option, property, attribute, and manifest names for every logging integration so users can enable the intended source after upgrading. Co-Authored-By: Claude <noreply@anthropic.com>

Lead with removal of the aggregate Logs and Metrics flags, list every source-local Logs opt-in, and keep constructor migrations as secondary details. Co-Authored-By: Claude <noreply@anthropic.com>

List the Spring Boot logging property first among the source-local Logs controls. Co-Authored-By: Claude <noreply@anthropic.com>

Reference the collection PR from the consolidated breaking-change entry. Co-Authored-By: Claude <noreply@anthropic.com>

lbloder

LGTM 👍
minor nits on the changelog commented

List every configuration surface affected by the aggregate Logs and Metrics option removal and structure the migration guidance clearly. Co-Authored-By: Claude <noreply@anthropic.com>

collection: logs and metrics enable flags

aeb796b

feat(logback): Add Logs opt-in

ae1f43a

Require an explicit Logback appender opt-in before forwarding records as Sentry Logs. Keep event and breadcrumb capture independent while the aggregate core Logs flag remains in place. Co-Authored-By: Claude <noreply@anthropic.com>

adinauer mentioned this pull request Aug 12, 2026

feat(logback): [Logs and Metrics Enable Flags 1] Add Logs opt-in #5940

Merged

4 of 8 tasks

adinauer and others added 2 commits August 12, 2026 15:54

changelog

7419f01

adinauer mentioned this pull request Aug 12, 2026

feat(log4j2): [Logs and Metrics Enable Flags 2] Add Logs opt-in #5941

Merged

4 of 8 tasks

adinauer and others added 2 commits August 12, 2026 16:02

changelog

11568c0

feat(jul): Add Logs opt-in

abe6ede

Require an explicit JUL handler opt-in before forwarding records as Sentry Logs. Support Java and LogManager configuration while keeping event and breadcrumb capture unchanged. Co-Authored-By: Claude <noreply@anthropic.com>

adinauer mentioned this pull request Aug 12, 2026

feat(jul): [Logs and Metrics Enable Flags 3] Add Logs opt-in #5942

Merged

4 of 8 tasks

adinauer and others added 2 commits August 12, 2026 16:07

changelog

17f0881

adinauer mentioned this pull request Aug 12, 2026

feat(android): [Logs and Metrics Enable Flags 4] Add Timber Logs opt-in #5943

Merged

4 of 8 tasks

adinauer and others added 2 commits August 12, 2026 16:21

changelog

4f677fb

feat(android): Add Logcat Logs opt-in

6a65f6f

Require an explicit Android option before forwarding Logcat calls as Sentry Logs. Support Java and manifest configuration while keeping breadcrumbs and Android Log calls unchanged. Co-Authored-By: Claude <noreply@anthropic.com>

adinauer mentioned this pull request Aug 12, 2026

feat(android): [Logs and Metrics Enable Flags 5] Add Logcat Logs opt-in #5945

Merged

4 of 8 tasks

adinauer and others added 2 commits August 12, 2026 16:29

changelog

c432ec5

feat(spring): Add logging Logs opt-in

ae8f804

Add a Spring Boot logging property that controls Sentry Logs forwarding from auto-configured Logback appenders. Keep appender installation, events, and breadcrumbs independent from the new opt-in. Co-Authored-By: Claude <noreply@anthropic.com>

adinauer mentioned this pull request Aug 12, 2026

feat(spring): [Logs and Metrics Enable Flags 6] Add logging Logs opt-in for Spring Boot #5946

Merged

4 of 8 tasks

adinauer and others added 2 commits August 12, 2026 16:35

changelog

381242f

adinauer mentioned this pull request Aug 12, 2026

feat(core): [Logs and Metrics Enable Flags 7] Remove Logs enable flag #5947

Merged

2 of 8 tasks

adinauer and others added 2 commits August 12, 2026 16:44

changelog

2121c08

feat(android): Warn for legacy Logs metadata

fcb8040

Detect explicit io.sentry.logs.enabled Android manifest metadata and emit tailored migration warnings without changing the integration-local Logs options. Co-Authored-By: Claude <noreply@anthropic.com>

adinauer mentioned this pull request Aug 13, 2026

feat(android): [Logs and Metrics Enable Flags 8] Warn for legacy Logs metadata #5949

Closed

4 of 8 tasks

feat(core): Warn for legacy Logs configuration

50dc84e

Keep parsing the nullable logs.enabled external option and emit tailored migration warnings for explicit true and false values without changing manual Logs capture. Co-Authored-By: Claude <noreply@anthropic.com>

adinauer mentioned this pull request Aug 13, 2026

feat(core): [Logs and Metrics Enable Flags 9] Warn for legacy Logs configuration #5950

Closed

4 of 8 tasks

feat(spring): Warn for legacy Logs property

419986b

Inspect the Spring Environment before SDK initialization and emit tailored migration warnings for explicit sentry.logs.enabled values without binding or applying the obsolete property. Co-Authored-By: Claude <noreply@anthropic.com>

adinauer mentioned this pull request Aug 13, 2026

feat(spring): [Logs and Metrics Enable Flags 10] Warn for legacy Logs property #5951

Closed

4 of 8 tasks

adinauer and others added 19 commits October 9, 2026 11:36

chore(stack): Merge preceding stack changes

481c394

Propagate removal of unused no-op telemetry batch processors through the stack while preserving branch ancestry.

chore(stack): Merge preceding stack changes

1a948e4

Propagate removal of unused no-op telemetry batch processors through the stack while preserving branch ancestry.

chore(stack): Merge preceding stack changes

7d3fb89

Propagate removal of unused no-op telemetry batch processors through the stack while preserving branch ancestry.

chore(stack): Merge preceding stack changes

c05ab4a

Propagate removal of unused no-op telemetry batch processors through the stack while preserving branch ancestry.

chore(stack): Merge preceding stack changes

6df9201

Propagate removal of unused no-op telemetry batch processors through the stack while preserving branch ancestry.

Merge pull request #5947 from getsentry/feat/remove-logs-enable-flag

3a3da5c

feat(core): [Logs and Metrics Enable Flags 7] Remove Logs enable flag

Merge pull request #5952 from getsentry/perf/logs-batch-thread-first-use

79e962f

perf(core): [Logs and Metrics Enable Flags 8] Avoid unused Logs worker thread

Merge pull request #5953 from getsentry/feat/remove-metrics-enable-flag

98074e6

feat(core): [Logs and Metrics Enable Flags 9] Remove Metrics enable flag

Merge pull request #5957 from getsentry/perf/metrics-batch-thread-fir…

1f9fc8a

…st-use perf(core): [Logs and Metrics Enable Flags 10] Avoid unused Metrics worker thread

Merge pull request #5960 from getsentry/fix/jul-null-log-message

dc0c03f

fix(jul): [Logs and Metrics Enable Flags 11] Preserve null-message records

Merge pull request #5961 from getsentry/docs/update-options-guidance

16b4e67

docs: [Logs and Metrics Enable Flags 12] Update options guidance

Merge pull request #5964 from getsentry/fix/timber-lazy-logs-option

7cd057f

fix(android): [Logs and Metrics Enable Flags 13] Read Timber option lazily

ref(log4j2)!: Remove deprecated appender constructor

5bf02ee

Remove the constructor superseded by the minimumLevel overload in 8.16.0 at the v9 breaking-change boundary. Co-Authored-By: Claude <noreply@anthropic.com>

ref(android): Align log capture manifest option names

ee3eeb9

Rename the Timber and Logcat manifest options to describe Sentry's log capture direction consistently with their Android option accessors. Co-Authored-By: Claude <noreply@anthropic.com>

Merge pull request #5970 from getsentry/ref/logs-enabled-naming

34f7d0f

ref(logging): [Logs and Metrics Enable Flags 14] Rename Logs opt-ins

chore(stack): Merge 9.x.x into collection branch

0ae66b1

Resolve conflicts while preserving source-local Logs controls and the removal of aggregate Logs and Metrics flags. Co-Authored-By: Claude <noreply@anthropic.com>

docs(changelog): Name Logs integration opt-ins

557348b

List the exact option, property, attribute, and manifest names for every logging integration so users can enable the intended source after upgrading. Co-Authored-By: Claude <noreply@anthropic.com>

docs(changelog): Consolidate Logs migration guidance

cd01fba

Lead with removal of the aggregate Logs and Metrics flags, list every source-local Logs opt-in, and keep constructor migrations as secondary details. Co-Authored-By: Claude <noreply@anthropic.com>

docs(changelog): Prioritize Spring Boot Logs opt-in

8804c56

List the Spring Boot logging property first among the source-local Logs controls. Co-Authored-By: Claude <noreply@anthropic.com>

adinauer marked this pull request as ready for review October 13, 2026 07:21

adinauer requested review from 0xadam-brown, markushi, romtsn and runningcode as code owners October 13, 2026 07:21

docs(changelog): Link Logs flags collection PR

11339cb

Reference the collection PR from the consolidated breaking-change entry. Co-Authored-By: Claude <noreply@anthropic.com>

lbloder approved these changes Oct 13, 2026

View reviewed changes

Comment thread CHANGELOG.md Outdated

Comment thread CHANGELOG.md Outdated

Comment thread CHANGELOG.md Outdated

docs(changelog): Clarify removed telemetry options

fc98241

List every configuration surface affected by the aggregate Logs and Metrics option removal and structure the migration guidance clearly. Co-Authored-By: Claude <noreply@anthropic.com>

adinauer merged commit 48e97fb into 9.x.x Oct 13, 2026
64 of 66 checks passed

adinauer deleted the feat/logs-metrics-enable-flags branch October 13, 2026 13:53

adinauer mentioned this pull request Oct 14, 2026

docs(java): Update Logs and Metrics configuration for v9 getsentry/sentry-docs#19962

Draft

Navigation Menu

Repository navigation

feat(core): Remove Logs and Metrics enable flags - #5939

feat(core): Remove Logs and Metrics enable flags#5939
adinauer merged 166 commits into
9.x.xfrom
feat/logs-metrics-enable-flags

adinauer commented Aug 12, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Aug 12, 2026 •

edited

Loading

Uh oh!

sentry Bot commented Aug 12, 2026 •

edited

Loading

Uh oh!

lbloder left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

adinauer commented Aug 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Stack (Logs and Metrics Enable Flags)

📜 Description

💡 Motivation and Context

💚 How did you test it?

📝 Checklist

🔮 Next steps

Uh oh!

github-actions Bot commented Aug 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sentry Bot commented Aug 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📲 Install Builds

Android

Uh oh!

lbloder left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

adinauer commented Aug 12, 2026 •

edited

Loading

github-actions Bot commented Aug 12, 2026 •

edited

Loading

sentry Bot commented Aug 12, 2026 •

edited

Loading