Tuning 4 min read

How to read a datalog: a cause → effect table

A field-by-field interpretation approach: what changes first, what it causes, and what to fix.

Drivurs Team Drivurs Team
Published
Last updated
Reviewed
Version 2026.08-topic-validation

Key takeaway

Reading logs is pattern recognition: identify the ECU’s limiters and protections, then validate one change at a time.

TL;DR

  • Tuning is changing targets and limits so the ECU can control torque safely under your real conditions.
  • Modern ECUs are torque-based: they decide airflow, fueling, and spark to hit a torque request.
  • Validation beats screenshots: consistent conditions and repeat runs are the only way to trust changes.

A mental model (text diagram)

Driver intent → Torque request → ECU torque model → Airflow (boost/throttle) + Fuel + Spark
                 ↑                                  ↓
               Sensors (air, temps, knock, fuel) ← Outcome (torque delivered)

A cause → effect way to read logs

Read in this order:

  1. Environment: temps and gear
  2. Request vs reality: throttle/boost target vs actual
  3. Protections: torque limits and knock response
  4. Outcome: repeatability and consistency

Interpretation table (high level)

SymptomLikely categoryWhat to check first
Boost drops with throttle closuretorque limit/protectiontorque limits, temps, shifts
Timing pulled with rising IATheat/knock marginintercooler/heat state, fuel quality
Boost can’t reach targetcontrol/hardwareleaks, plumbing, wastegate basics

Validation plan for this topic

Start with one written hypothesis from this page: Reading logs is pattern recognition: identify the ECU’s limiters and protections, then validate one change at a time. Do not begin the test until the vehicle is mechanically healthy, the fuel is known, and the operator can use a legal controlled environment. Keep gear, engine-speed window, load request, and starting temperature as consistent as the platform allows.

For How to read a datalog: a cause → effect table, align these signals on the same time axis:

  1. test context and timestamps - establishes what the system was asked to do or the condition entering the event.
  2. requested versus measured values - shows the primary response rather than a dashboard summary.
  3. correlated protection signals - provides the safety or control context that can explain an apparently good or bad result.
  4. repeatability across comparable logs - tests whether another system, not the headline variable, actually set the limit.

Mark the start and end of the relevant event before interpreting it. Look for sequence: request, response, deviation, intervention, and recovery. A value that changes after throttle lift cannot explain the event that happened before it. Compare at least two clean repetitions and retain the original file, calibration identifier, fuel, ambient condition, and any warning or driver note.

What counts as a useful result

A useful result either supports the hypothesis under comparable conditions or disproves it clearly enough to change the next action. It is also useful to learn that maintenance, sensor quality, traction, or temperature made the test invalid. Do not average invalid and valid attempts together, and do not hide a protection event because the final headline number improved.

Stop and investigate

Reduce load and investigate persistent correction, misfire, unexpected lean operation, falling fuel pressure, uncontrolled temperature rise, fluid leakage, new mechanical noise, or an intervention that was not present in the baseline. A generic internet threshold is not a substitute for the platform’s factory documentation, the calibration provider’s limits, and review by a qualified professional.

For the full control-of-variables method, use Repeatability and consistency. For signal ordering and context, use How to read a datalog.

Common mistakes

  • Fixing the last thing that changed instead of the first thing that caused it.
  • Assuming a single field proves the cause.

Diagnostics / what logs tell you (high level)

SignalWhat it usually meansWhat to check
RPMContext for everything elseCompare in the same gear and load range
Throttle angle / torque interventionHow the ECU is controlling torqueLook for closures that explain boost drop
Boost target vs actualControl quality and limitsOscillation can be hardware or control strategy
IAT / tempsMargin and repeatabilityHeat soak changes results dramatically
Knock / timing correctionCombustion safety responseSustained corrections = reduce load/verify fuel/temps

FAQ

What’s the most common mistake?

Comparing logs that are not comparable (different temps, road, gear, traction).

Evidence

Sources and review notes

Product, vehicle, safety, and technical details are checked against the sources below. Availability and specifications can change; confirm current fitment and local requirements before acting.

  1. Bosch Mobility - Gasoline direct injection
  2. Bosch Mobility - Knock sensor operation
  3. Haltech - Ignition tuning knowledge base

Keep changes and evidence together

Put “How to read a datalog: a cause → effect table” into practice.

Use Drivurs to document the vehicle and its setup while you validate changes with qualified tools and a repeatable process.

See the Garage feature

Use it in Drivurs

Explore Racing

Validate tuning decisions with sessions, graphs, and leaderboard-ready uploads.

Want to keep learning?

Browse the Drivurs Academy hubs for checklists, comparisons, and reference.