Skip to content

docs: Unity diagnostic log collection (refs unity-builder#740)#568

Closed
frostebite wants to merge 4 commits into
mainfrom
docs/unity-log-collection
Closed

docs: Unity diagnostic log collection (refs unity-builder#740)#568
frostebite wants to merge 4 commits into
mainfrom
docs/unity-log-collection

Conversation

@frostebite
Copy link
Copy Markdown
Member

Summary

Companion to game-ci/orchestrator#23 — documents the new collectUnityLogs / streamUnityLogs flags and the full set of Unity-internal log categories the orchestrator now captures. Also closes the documentation gap from game-ci/unity-builder#740.

What's new

  • New page `docs/03-github-orchestrator/07-advanced-topics/22-unity-log-collection.mdx` covering:
    • Quick-start GHA snippet with artifact upload
    • Full table of categories (Editor.log, licensing, audit, services-config, Unity Hub logs, crash dumps, build report, bee_backend, Player.log, test results, IL2CPP, project version, package manifest, macOS crash reports, Windows Event Log, license file)
    • Per-platform path resolution table (Linux / macOS / Windows)
    • Live log streaming behaviour and per-file byte cap
    • All action inputs and outputs, plus a sample manifest.json
    • Sensitive-files guidance for the license-file category
    • Multi-engine note pointing to engine-plugins doc
  • Cross-links from `21-failures-and-diagnostics.mdx` and `09-troubleshooting/common-issues.mdx` so users hitting the "Unity support wants logs" path land on the new page.

Test plan

  • yarn build Docusaurus locally, verify the new page renders and the cross-links resolve
  • Confirm route /docs/github-orchestrator/advanced-topics/unity-log-collection matches the file's directory layout

🤖 Generated with Claude Code

Documents the Orchestrator's collectUnityLogs / streamUnityLogs flags,
including:
- Quick-start GHA snippet with artifact upload
- Full table of categories (Editor.log, licensing, audit,
  services-config, Hub logs, crash dumps, build report, bee_backend,
  Player.log, IL2CPP, project version, package manifest, macOS crash,
  Windows event log, license file)
- Per-platform path resolution table (Linux / macOS / Windows)
- Live log streaming behaviour and per-file byte cap
- Action inputs and outputs (unityLogsPath, unityLogsManifest)
- Sensitive-files guidance for license-file category
- Multi-engine note pointing to engine-plugins doc

Cross-links from failures-and-diagnostics and common-issues so users
hitting the "Unity support wants logs" path land on the new page.

Refs: game-ci/unity-builder#740

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 7, 2026

Warning

Rate limit exceeded

@frostebite has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 33 minutes and 43 seconds before requesting another review.

To continue reviewing without waiting, purchase usage credits in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: e20b024d-ef9f-44b2-8bad-72853aa32ae3

📥 Commits

Reviewing files that changed from the base of the PR and between ab8eb11 and 0c27a70.

📒 Files selected for processing (3)
  • docs/03-github-orchestrator/07-advanced-topics/21-failures-and-diagnostics.mdx
  • docs/03-github-orchestrator/07-advanced-topics/22-unity-log-collection.mdx
  • docs/09-troubleshooting/common-issues.mdx
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/unity-log-collection

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 7, 2026

Cat Gif

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 7, 2026

Visit the preview URL for this PR (updated for commit 0c27a70):

https://game-ci-5559f--pr568-docs-unity-log-colle-wuosk2j6.web.app

(expires Thu, 14 May 2026 16:31:38 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: 1f0574f15f83e11bfc148eae8646486a6d0e078b

frostebite and others added 3 commits May 7, 2026 17:20
Documents the no-prior-opt-in workflow: SSH into a self-hosted runner
after a failing job, run `game-ci orchestrate --providerStrategy local
--collectUnityLogs` and get the same diagnostic bundle without editing
the workflow or re-running the build. Calls out the three concrete
incident-response use cases this unlocks (overnight failure / locked
workflow / live hang debugging) and references the upcoming remote
`game-ci logs pull` follow-up command.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Adds a "Convenient API" section to the Unity Log Collection page
documenting the new game-ci logs subcommand group (collect, tail,
plus reserved pull/fetch) and the Logs programmatic facade exported
from @game-ci/orchestrator. Shows both end-to-end build flows
(--collectUnityLogs) and one-shot ad-hoc usage.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Fixes the Code formatting CI check on the docs PR.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@frostebite
Copy link
Copy Markdown
Member Author

Superseded by #569 — the combined branch merges this work in along with the other three docs branches from the May 2026 wave. Closing in favour of the combined PR.

@frostebite frostebite closed this May 7, 2026
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