Skip to content

Conversation

@mujacica
Copy link
Contributor

@mujacica mujacica commented Sep 29, 2025

DESCRIBE YOUR PR

Tell us what you're changing and why. If your PR resolves an issue, please link it so it closes automatically.

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

Note

Adds Unreal Engine Logs documentation (setup, usage, options, default attributes) and links it from Getting Started under a new Gaming section, removing Unreal from Upcoming SDKs.

  • Unreal Engine Logs Docs:
    • New guide at docs/platforms/unreal/logs/index.mdx with requirements, setup, usage, options, default attributes, and performance considerations.
    • New platform includes:
      • platform-includes/logs/requirements/unreal.mdx
      • platform-includes/logs/setup/unreal.mdx (project settings, programmatic config, UE_LOG forwarding, category filtering, before-log handler)
      • platform-includes/logs/usage/unreal.mdx (AddLog API, levels mapping, UE_LOG integration, Blueprint support)
      • platform-includes/logs/options/unreal.mdx (config table)
      • platform-includes/logs/default-attributes/unreal.mdx (core + user-mobile attributes)
  • Getting Started (docs/product/explore/logs/getting-started/index.mdx):
    • Add Gaming section linking platform="unreal" to /platforms/unreal/logs/.
    • Remove Unreal from Upcoming SDKs.

Written by Cursor Bugbot for commit 125134e. This will update automatically on new commits. Configure here.

@vercel
Copy link

vercel bot commented Sep 29, 2025

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

Project Deployment Preview Comments Updated (UTC)
sentry-docs Ready Ready Preview Comment Sep 30, 2025 2:59pm
1 Skipped Deployment
Project Deployment Preview Comments Updated (UTC)
develop-docs Ignored Ignored Preview Sep 30, 2025 2:59pm

@codeowner-assignment codeowner-assignment bot requested a review from a team September 29, 2025 12:24
@codecov
Copy link

codecov bot commented Sep 29, 2025

Bundle Report

Changes will increase total bundle size by 1.01kB (0.0%) ⬆️. This is within the configured threshold ✅

Detailed changes
Bundle name Size Change
sentry-docs-client-array-push 10.13MB -6 bytes (-0.0%) ⬇️
sentry-docs-server-cjs 12.9MB 1.02kB (0.01%) ⬆️

Affected Assets, Files, and Routes:

view changes for bundle: sentry-docs-server-cjs

Assets Changed:

Asset Name Size Change Total Size Change (%)
1729.js -3 bytes 1.78MB -0.0%
../instrumentation.js -3 bytes 1.1MB -0.0%
9523.js -3 bytes 1.08MB -0.0%
../app/[[...path]]/page.js.nft.json 343 bytes 839.16kB 0.04%
../app/platform-redirect/page.js.nft.json 343 bytes 839.08kB 0.04%
../app/sitemap.xml/route.js.nft.json 343 bytes 836.3kB 0.04%
view changes for bundle: sentry-docs-client-array-push

Assets Changed:

Asset Name Size Change Total Size Change (%)
static/chunks/pages/_app-*.js -3 bytes 882.71kB -0.0%
static/chunks/8321-*.js -3 bytes 425.87kB -0.0%
server/middleware-*.js -6.46kB 1.0kB -86.59%
server/middleware-*.js 6.46kB 7.46kB 645.5% ⚠️
static/s59vd3pw5Eg0bSRhXY34T/_buildManifest.js (New) 684 bytes 684 bytes 100.0% 🚀
static/s59vd3pw5Eg0bSRhXY34T/_ssgManifest.js (New) 77 bytes 77 bytes 100.0% 🚀
static/3URXkHkGhjGVDqdehkvFP/_buildManifest.js (Deleted) -684 bytes 0 bytes -100.0% 🗑️
static/3URXkHkGhjGVDqdehkvFP/_ssgManifest.js (Deleted) -77 bytes 0 bytes -100.0% 🗑️

@mujacica mujacica force-pushed the feat/unreal_logs branch 3 times, most recently from 95ac53c to 77c40fb Compare September 30, 2025 13:28
Settings->EnableErrorLogs = true;
Settings->EnableFatalLogs = true;

Settings->bSendBreadcrumbsWithStructuredLogging = false; // Send as structured logs instead of breadcrumbs
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This trips me up. To me this reads like I can send logs as breadcrumbs. Like I have a choice between structured logs and breadcrumbs.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's exactly correct, up until now all UE_LOGs were being sent as Breadcrumbs. With the new feature implemented we still allow users to chose either/or both.

@codeowner-assignment codeowner-assignment bot requested a review from a team September 30, 2025 14:13
TArray<FString> AllowedCategories;
AllowedCategories.Add(TEXT("LogGameFlow"));
AllowedCategories.Add(TEXT("LogPlayerSystem"));
AllowedCategories.Add(TEXT("LogSentrySdk"));
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we don't add this to the snippet and end up with users copy-pasting this into their game. 😁

UE_LOG(LogTemp, Log, TEXT("Debug information")); // Only sent if EnableInfoLogs = true
```

You can configure whether these logs are sent as:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's the "sent" that reads confusing to me. "Sent as strucutured logs" vs "captured and added to an event"?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually this is correct, we can send these logs either as Structured logs or as Breadcrumbs (was behavior until now). So from now on UE_LOGs should come as Logs, and users can still opt-back for the Breadcrumbs option too.

@mujacica mujacica merged commit 90bc95b into master Sep 30, 2025
13 checks passed
@mujacica mujacica deleted the feat/unreal_logs branch September 30, 2025 15:01
@github-actions github-actions bot locked and limited conversation to collaborators Oct 16, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants