Logging Guide

What to Log

GREASE-AI is only as good as the data you feed it. A 30-second log with the wrong channels will get you a generic report. A proper log with the right PIDs will get you a root cause. Here's exactly what to capture.

The #1 mistake: logging too short

Most issues don't show up at idle. Log a full cold start, a cruise at highway speed, and at least one WOT pull. Minimum 3–5 minutes of data. More is always better.

Required PIDs — Every Log

These channels are the minimum needed for GREASE-AI to generate a useful report. If any of these are missing, the analysis will be incomplete.

Channel / PIDWhy It Matters
RPMEngine speed — baseline for everything else
MAP or MAFEngine load. MAP for speed-density tunes, MAF for mass-air. Log both if available.
TPS (Throttle Position)Confirms driver demand vs. actual response
IAT (Intake Air Temp)Affects fueling and timing. Critical for diagnosing heat soak.
ECT (Engine Coolant Temp)Required for cold-start and warm-up analysis
STFT Bank 1 & 2 (Short Term Fuel Trim)Real-time fueling correction — shows lean/rich conditions immediately
LTFT Bank 1 & 2 (Long Term Fuel Trim)Learned fueling correction — shows chronic lean/rich issues
O2 Sensor B1S1 & B2S1 (upstream)Pre-cat oxygen sensors — validates fuel trim data
Ignition Timing / Spark AdvanceTiming retard reveals knock, detonation, or calibration issues
Knock Counts / Knock RetardMost important channel for diagnosing detonation. Log per-cylinder if available.
Injector Pulse WidthShows actual fuel delivery — catches injector issues and fueling limits
Vehicle Speed (VSS)Required to correlate load conditions with road speed

Recommended PIDs — Add These If You Can

Channel / PIDWhy It Matters
Battery VoltageLow voltage causes a cascade of false codes and sensor errors
Barometric Pressure (BARO)Altitude compensation — important for shops at elevation
EGR Position / EGR CommandedRequired for diagnosing EGR-related misfires and rough idle
Cam/Crank CorrelationCatches timing chain stretch and VVT issues
Misfire Counts (per cylinder)Pinpoints which cylinder is misfiring — saves hours of diagnosis
Fuel PressureRules out fuel delivery as a cause before chasing sensors
Boost Pressure (turbocharged engines)Required for any forced-induction diagnosis
Transmission TempNeeded for shift quality and TCC slip analysis
TCC Slip / Torque Converter SlipDiagnoses converter shudder and transmission hunting

Logging Conditions — Capture All of These

Cold Start

Start from fully cold (overnight soak). Log the entire warm-up until ECT reaches operating temp. This catches cold-start enrichment issues, idle instability, and choke-related faults.

Idle (Warm)

5+ minutes at warm idle in park. Reveals vacuum leaks, idle air control issues, and chronic fuel trim problems that disappear under load.

Light Cruise

30–55 mph, light throttle, flat road. Best condition for catching lean conditions, EGR faults, and TCC shudder.

Highway Cruise

60–70 mph, steady throttle. Captures long-term fuel trims under load and transmission lock-up behavior.

WOT Pull

Full throttle acceleration from 30–60 mph in 3rd or 4th gear. Required for knock analysis, timing behavior, and fuel delivery limits. Do this safely on a private road.

Decel / Overrun

Lift off throttle from highway speed. Captures decel fuel cut, EVAP purge behavior, and vacuum-related issues.

Common Mistakes That Ruin a Log

  • ✗ Log too short:Under 2 minutes of data. Most issues only appear under specific conditions — cold start, load, or WOT.
  • ✗ Wrong sample rate:1 Hz (1 sample/sec) misses knock events and injector behavior. Use 10 Hz minimum.
  • ✗ Missing fuel trim channels:STFT and LTFT are the most diagnostic channels on the car. If they're not in the log, half the analysis is blind.
  • ✗ Only logging at idle:Idle doesn't stress the engine. Log under load — cruise and WOT are where problems show up.
  • ✗ Generic OBD2 mode only:Generic mode misses manufacturer-specific PIDs. Use FORScan, HP Tuners, or EFI Live for full access.
  • ✗ No cold start data:Cold start reveals enrichment issues, idle instability, and warm-up faults that disappear once the engine is hot.
📄

Download the full PID Reference Guide

All PIDs, logging conditions, and scanner setup in a single printable PDF — take it to the shop.

⬇ Download PDF

Ready to upload your log?

Drop your CSV and let GREASE-AI find the root cause.