Add enhanced one-session diagnostic bundles

This commit is contained in:
wallentx authored and Kurt Himebauch committed 2026-11-05 13:32:46 -05:00
1 parent b563b8d1eb
commit 5614bd5d5a
32 files changed
+3100 -141

No files matched your search

+42
View File
@@ -116,6 +116,48 @@ logging can reduce performance and consume storage; disable it after collecting
the report. If the session log directory is unavailable, the launcher reports
that diagnostics were skipped instead of writing uncollected files elsewhere.
## Enhanced diagnostics
Use **Setup > Diagnostics > Enhanced diagnostics for next session** when normal
session logs are not enough. The setting is one-shot: DroidDeck creates and
retains the next session's log directory, records the diagnostic profile, then
turns the setting off. It also enables the existing game diagnostic environment
for that session without changing the user's saved **Session logs** or **Game
debug logs** preferences.
After reproducing the problem, use **Latest session logs > Share logs** or the
in-session share action. Enhanced sessions offer separate, correlated archives:
| Archive | Main contents |
| --- | --- |
| Session and device | Startup timeline, device/component selection, app, audio, network, and exit summaries |
| Graphics | Graphics-related logs plus bounded Gamescope frame and process summaries when their providers are available |
| Games and compatibility | Proton, Wine, DXVK/VKD3D, FEX, store, and game lifecycle logs |
Choose one archive when an issue calls for a narrow report, or **All bundles**
to share the three archives together. Every archive contains a
`diagnostics-manifest.json` with the common session ID and the state of each
artifact: captured, truncated, unavailable, omitted, or failed. Some captured
logs may themselves explain that a permission-limited source was unavailable.
Exported archives sample a bounded amount of input. Large text logs retain
complete lines from their beginning and end, and the manifest records partial
scans and input limits. Raw game and component log writers are not yet safely byte-bounded while
the session is running; they can use substantial storage, particularly during a
long Proton game session. Enhanced diagnostics may also change timing because it
keeps the game wrapper alive long enough to record an exit status. Turn it on
only for a reproduction and review the archives before sharing them.
The bundle does not promise unrestricted Android, kernel, or vendor-driver
logs. If accessible, Android's crash buffer can include reports from other apps;
redaction is best effort. Screen captures, pixels, input contents, memory dumps,
and full system traces are not included automatically.
The Gamescope frame summary is produced only by a Gamescope build that includes
the enhanced frame-trace provider. An older bundled Gamescope safely ignores the
diagnostic environment setting; the Graphics archive then records no frame-trace
summary rather than inventing one.
A Unity game under FEX (`UnityPlayer.dll` for Windows builds under Proton,
`UnityPlayer.so` or `GameAssembly.so` for native Linux builds started by
**Linux x86 (FEX)**) keeps FEX's TSO on when the Default profile's FEX preset