Time to First Fix (TTFF)
TTFF measures the average time from when a container or booking is added to your account until Dockflow receives the first tracking data.
TTFF = AVG(first_fix - created_at)
Target: 8 hours | Lower is better
What it Measures
TTFF indicates how quickly Dockflow starts providing tracking data after you add a container. A lower value means faster initial data availability.
How it Works
When you add a container (via API, upload, or manual entry):
- Created: Dockflow creates a tracking job (
created_at) - Queued: Dockflow queries carrier systems
- First Fix: First data is received and stored (
first_fix)
TTFF measures the time between steps 1 and 3.
Exclusions
The TTFF calculation excludes:
| Exclusion | Reason |
|---|---|
Backfilled data (first_fix < created_at) | Historical imports skew the metric |
| Booking-only entries with TTFF > 24h | Indicates booking was inactive when created |
Status Thresholds
| Status | Threshold | Meaning |
|---|---|---|
| On Target | ≤ 8 hours | Good performance, data arriving quickly |
| Warning | 8-12 hours | Some delays in initial data |
| Critical | > 12 hours | Significant delays, may indicate issues |
Factors Affecting TTFF
| Factor | Impact |
|---|---|
| Carrier API availability | Some carriers update faster than others |
| Container visibility | New bookings may not be immediately visible |
| Processing queue | High-volume periods may increase wait time |
Drill-Down View
Click "View details" to see individual containers sorted by TTFF:
- Worst first: Containers that took longest to get first data
- Best first: Containers that received data fastest
Troubleshooting
High TTFF Values
Possible causes:
- Container not yet visible in carrier system
- Booking reference not yet linked to container
- Carrier API delays
Actions:
- Wait 24-48 hours for new bookings
- Verify booking/BL references are correct
- Check carrier portal directly for comparison
Related
- Data Freshness →
- Confirmation Delay → (coming soon)