Data Freshness
Data Freshness measures the average time since the last successful carrier data update for your active containers.
Freshness = AVG(NOW - last_successful_update)
Target: 6 hours | Lower is better
What it Measures
Data Freshness indicates how "stale" your carrier tracking data is. A lower value means more recent data.
Carrier Data Only
This metric applies to carrier data only. It does not include:
- Terminal data
- AIS vessel tracking
- Other data sources
How it Works
Dockflow continuously polls carrier websites and APIs for tracking updates. The update frequency is dynamic:
| Scenario | Update Interval |
|---|---|
| Near expected events | Every 6 hours |
| Idle periods | Every 72 hours |
The Freshness metric shows the average time since the last successful update across all your active containers.
Status Thresholds
| Status | Threshold | Meaning |
|---|---|---|
| On Target | ≤ 6 hours | Data is fresh, updates on schedule |
| Warning | 6-9 hours | Slight delays, may indicate carrier API issues |
| Critical | > 9 hours | Significant delays, investigate specific containers |
Drill-Down View
Click "View details" to see individual containers sorted by freshness:
- Worst first: Containers with the oldest data
- Best first: Containers with the freshest data
This helps identify:
- Containers with stale data
- Potential update issues for specific carriers
- Containers that may need manual refresh
Troubleshooting
High Freshness Values
Possible causes:
- Carrier API downtime or rate limiting
- Invalid container numbers
- Containers no longer active with carrier
Actions:
- Check drill-down for specific containers
- Verify container numbers are correct
- Contact support if issues persist
Related
- TTFF →
- Confirmation Delay → (coming soon)