Skip to content

docs(godot): Update logging options and add 2.0.0 migration guide#18297

Open
limbonaut wants to merge 3 commits into
masterfrom
docs/godot-logging-options-2.0-migration
Open

docs(godot): Update logging options and add 2.0.0 migration guide#18297
limbonaut wants to merge 3 commits into
masterfrom
docs/godot-logging-options-2.0-migration

Conversation

@limbonaut

Copy link
Copy Markdown
Collaborator

DESCRIBE YOUR PR

Brings the Godot logging docs in line with the 2.0.0 SDK and adds a migration guide.

  • Refresh the logger options in Configuration > Options: enable_logs now defaults to true, GodotErrorMask is renamed to GodotLoggerEventMask (with a new MASK_MESSAGE flag), and a new logger_log_mask option controls which Godot logger events are captured as Sentry Logs. logger_messages_as_breadcrumbs is marked deprecated.
  • Update the Logs page's "Godot Logging Integration" section — auto-capturing Godot log output as Sentry Logs is now opt-in via logger_log_mask.
  • Add a Migrating to 2.0.0 section covering the logging changes and the Android ANR detection split.

SDK changes: getsentry/sentry-godot#680 (logging), getsentry/sentry-godot#749 (ANR).

Note for reviewers: This PR and the Android ANR PR both edit configuration/options.mdx, but in different sections (logging vs. the App Hang / Android options), so they should merge cleanly. This PR owns the new "Migrating to 2.0.0" section; the ANR PR owns the options.android.* reference entries.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

EXTRA RESOURCES

Refresh the Godot logger options to match the 2.0.0 SDK: enable_logs now defaults to true, the GodotErrorMask enum is renamed to GodotLoggerEventMask, and a new logger_log_mask option (with the MASK_MESSAGE flag) controls which Godot logger events are captured as Sentry Logs. Mark logger_messages_as_breadcrumbs as deprecated.

Auto-capturing Godot log output as Sentry Logs is now opt-in, so the Logs page's Godot Logging Integration section now explains logger_log_mask instead of claiming automatic capture.

Add a "Migrating to 2.0.0" section covering the logging changes and the Android ANR detection split.

Refs getsentry/sentry-godot#680
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 8, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Jun 8, 2026 2:44pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Jun 8, 2026 2:44pm

Request Review

@codeowner-assignment codeowner-assignment Bot requested a review from a team June 8, 2026 14:13
Comment thread docs/platforms/godot/configuration/options.mdx
Show the integer value of each mask flag and explain that bits 16/32/64 are reserved, so MASK_MESSAGE is 128 and the default breadcrumb mask is 143. Prevents confusion when computing bitwise combinations.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.

1 participant