Skip to content

ref(logs): Promote structured logs APIs - #6424

Merged
adinauer merged 2 commits into
9.x.xfrom
ref/promote-logs-apis-v9
Oct 30, 2026
Merged

adinauer merged 2 commits into
9.x.xfrom
ref/promote-logs-apis-v9

Conversation

@adinauer

@adinauer adinauer commented Oct 30, 2026 •

Copy link
Copy Markdown
Member

📜 Description

Remove the remaining @ApiStatus.Experimental annotations from the structured logs options and low-level capture method:

  • SentryOptions.getLogs()
  • SentryOptions.setLogs(...)
  • SentryClient.captureLog(...)

Batched transport plumbing remains internal. This changes API status only; log capture behavior remains unchanged.

💡 Motivation and Context

The public structured logger API and log configuration have been hardened through batching, integration support, shutdown handling, PII fixes, trace linking, and reentrancy protection. The remaining annotations no longer reflect the maturity of the API.

Crash durability for buffered logs remains tracked separately in #4690 and can be implemented without redesigning the public capture API.

Refs #6408

💚 How did you test it?

Ran:

./gradlew spotlessApply apiDump
./gradlew :sentry:test --tests io.sentry.SentryClientTest --tests io.sentry.SentryOptionsTest

Both commands completed successfully, and API generation produced no API dump changes.

📝 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.
  • Public API changes reviewed by another Mobile SDK team member or implemented according to the develop docs spec.

🔮 Next steps

Improve crash durability for buffered logs separately without changing the public logging API.

adinauer and others added 2 commits October 30, 2026 10:19
Remove the remaining experimental annotations from the structured logs options and low-level capture method. The public logger API is stable, while batching and durability improvements remain internal implementation work.

Refs #6408
Refs #4690
Co-Authored-By: Claude <noreply@anthropic.com>
@sentry

sentry Bot commented Oct 30, 2026

Copy link
Copy Markdown

📲 Install Builds

Android

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

⚙️ sentry-android Build Distribution Settings

@adinauer
adinauer marked this pull request as ready for review October 30, 2026 09:34
@adinauer
adinauer merged commit e3e2019 into 9.x.x Oct 30, 2026
40 of 41 checks passed
@adinauer
adinauer deleted the ref/promote-logs-apis-v9 branch October 30, 2026 14:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants