Run your first analysis

A guided first run of analyze_logs — the prompt to send, what comes back, and how credits are billed.

By the end of this tutorial you'll have run a full log analysis, seen the report it produces, and know exactly when credits are billed.

Before you start

Your AI client is connected and you signed in at spaghetti.gg at least once.
You have a log file — any Unreal Engine text log works. The editor writes them to your project's Saved/Logs/ directory, for example Saved/Logs/MyProject.log.

This is a paid tool — a fixed credit cost per analysis session, billed only when the analysis actually runs. If the log is empty or contains no Error or Fatal entries, the run is free. Current price: pricing page.

Step 1: ask your client

Open your AI client in your project directory and send:

Analyze the log file at Saved/Logs/MyProject.log

Your client calls the analyze_logs tool. The run has two phases: first a session is opened for the file, then the analysis runs on the uploaded copy — log bytes never flow through the chat.

Known limitation — file upload to object storage is pending deployment in production. Until it goes live, your client falls back to pasting the log text inline, which works today.

Step 2: read the report

When analysis finishes, your client presents the results:

Summary — a short overview of what the log shows.
Findings — each with a severity, evidence excerpts from the log, an explanation, and a recommendation.
Crash triage — when the log contains a crash, the suspect Blueprint is named.
Statistics — totals and severity breakdowns for the file.

Step 3: if credits run out

If your balance can't cover the run, the tool refuses to start and your client relays a message like Insufficient credits: need N, have M. Ask your client:

Top up $25

It calls the free topup tool, gives you a checkout link, and you retry the analysis after paying. Nothing is ever half-run — see How credits work.

Verify

The findings report appeared in your chat.
Open the portal's Usage page — the analyze_logs call is counted there, and your balance dropped by 5.

Next steps

Analyze a log file — the full workflow, limits, and billing details
Search Unreal Engine documentation — the free research tools
Tools reference — everything else the Workbench can do

Was this page helpful?