ECal Studios - LogCheck — Unreal Log Diagnostics

Distribution Product Discussion
1

Stop hunting through thousands of log lines

A failed Unreal build or package can produce thousands of lines across the Output Log, UnrealBuildTool, AutomationTool, Cook, staging, plugins, compilers, shaders, and platform tools.

The last error is often not the real cause.

LogCheck turns that noise into a clear diagnostic workflow. It reads your logs locally, structures the evidence, groups repeated messages, ranks the most useful explanations, and gives you a concise Primary Diagnosis with the evidence and next checks behind it.

Instead of searching blindly, you can see:

  • what most likely failed;

  • why LogCheck ranked it first;

  • where the evidence appears in the original log;

  • which messages are consequences or summaries;

  • what to investigate next.

Cause-first, evidence-backed diagnostics

LogCheck does more than search for keywords.

It uses 170 built-in production rules across 17 diagnostic packs to recognize common Unreal failures across:

  • Packaging and Cook;

  • AutomationTool;

  • staging and containers;

  • platform SDKs;

  • C++ and Clang compilation;

  • linkers;

  • UnrealBuildTool and UnrealHeaderTool;

  • Blueprint compilation;

  • plugins and modules;

  • assets and packages;

  • shaders;

  • crashes;

  • environment and Derived Data Cache issues.

Repeated occurrences are grouped instead of flooding the results. Wrapper errors and downstream failures remain visible, but precise actionable evidence is allowed to rise above generic summaries.

Every diagnosis stays connected to the original evidence.

A complete Unreal log investigation workspace

LogCheck includes dedicated tools for the entire investigation:

  • Summary — see the detected outcome, Primary Diagnosis, alternatives, issue counts, unknown evidence, and recommended next actions.

  • Diagnostics — search, filter, group, review, bookmark, and classify recognized issues.

  • Root Causes — inspect ranked candidates, score factors, and candidate causal chains.

  • Unknown Issues — review significant messages not recognized by the current built-in or enabled custom rules.

  • Raw Log — search and navigate large logs with evidence markers, structured filters, blocks, bookmarks, and direct line navigation.

  • Parsed Lines and Rule Matches — inspect how LogCheck interpreted and recognized the source evidence.

  • Rule Library — browse the complete built-in diagnostic inventory.

More than a one-time scan

LogCheck also supports ongoing debugging and support workflows:

  • Save local, project-scoped History snapshots.

  • Set a Baseline and compare later analyses.

  • Review New, Resolved, Persisting, Changed, Newly Recognized, and Not Evaluated results honestly.

  • Create safe, declarative Custom Rules for project-specific errors.

  • Validate custom rules with positive, negative, and near-miss fixtures.

  • Prepare selected evidence for support without automatically including the complete Raw Log.

Professional reports and support packages

Export selected results to:

  • Markdown;

  • standalone offline HTML;

  • JSON;

  • CSV;

  • PDF;

  • support-package ZIP.

Exports support content selection, checksums, preview, cancellation, and an advisory privacy review.

LogCheck can detect and replace common sensitive values with deterministic tokens before export. Redaction is intentionally presented as a review aid, not a guarantee.

Local and read-only by design

LogCheck:

  • runs entirely on your machine;

  • does not upload your logs;

  • does not use telemetry;

  • does not depend on a cloud service;

  • does not automatically change source code;

  • does not modify Blueprints, assets, plugins, or configuration;

  • does not apply fixes automatically.

Your source logs remain read-only.

Honest diagnostic guidance

LogCheck is designed to help you investigate faster, not to pretend every failure has one guaranteed answer.

  • The Primary Diagnosis is the highest-ranked eligible explanation supported by the available evidence.

  • Ranking scores are ordering signals, not probabilities.

  • Causal links are candidate relationships, not guarantees.

  • Unknown Issues are review candidates, not confirmed diagnoses.

  • Custom rules are controlled by the user and clearly identified.

  • Privacy redaction should always be reviewed before sharing.

Compatibility

  • Unreal Engine 5.5

  • Unreal Engine 5.6

  • Unreal Engine 5.7

  • Unreal Engine 5.8

  • Primary final validation performed with UE 5.8.1

LogCheck is an editor-only C++ code plugin with no runtime footprint.

Documentation: Overview - ECal Studios Documentation