Surprise Down and Link Loss Handling: Reports and Metrics

Reports and metrics

Reports and Metrics for Surprise Down and Link Loss Handling focuses on Surprise-down detection latency, in-flight IO drain time, and recovery success rate. The purpose is to turn memory observations into mechanism-backed actions with explicit owners and release-safe validation.

Reports should explain why Surprise-down detection latency, in-flight IO drain time, and recovery success rate moved, not simply that it moved. Require evidence that links the movement to command behavior, queue policy, PHY margin, or reliability controls.

Before/after trend

BEFORE/AFTER TREND - Surprise Down and Link Loss Handling

metric        before    after fix
------------  --------  ---------
bandwidth     42 GB/s   48 GB/s
p99 latency   18 us     9 us
error rate    12/hr     0/hr

Evidence matrix

PCIe/CXL EVIDENCE MATRIX - Surprise Down and Link Loss Handling

+-------------------------------+--------------------------------+--------------------------------+---------------------------+
| Evidence                      | Tells you                      | Does not prove                 | Next action               |
+-------------------------------+--------------------------------+--------------------------------+---------------------------+
| TLP type mix + credit stall counters    | protocol-layer stall cost    | link integrity and replay behavior   | inspect training margins  |
| queue age + class breakdown   | fairness and starvation risk   | command legality details       | parse command timeline    |
| LTSSM timeline + ordered set progression | timing-window pressure         | root cause by itself           | correlate with topology map|
| eye / Vref / skew snapshots   | PHY margin and drift behavior  | controller policy quality      | pair with schedule logs   |
| CE/UE + scrub telemetry       | reliability trajectory         | immediate perf bottleneck only | map to hotspot apcieesses  |
+-------------------------------+--------------------------------+--------------------------------+---------------------------+

• Track p50/p95/p99 latency and effective bandwidth together.

• Include command and queue context alongside high-level counters.

• Tag reports with firmware, timing profile, and thermal state.

• Call out contradictory evidence instead of hiding it.

PCIe/CXL deep dive

RAS closure maps AER, poison, and surprise-down events to bounded containment and recovery actions.

Concept diagram

RAS ESCALATION

detect -> classify -> contain -> recover -> validate

Metric graph

RAS EVENT MIX

correctable trend   ███████
uncorrectable       ██
surprise-down       █

Reports and artifacts

• AER register dump

• poison injection log

• surprise-down timeline

• containment action record

Mini case study

Masked correctable errors accumulated until a surprise-down during peak traffic forced unplanned failover.

Debug branches

• Separate CE trend from UE containment paths

• Validate poison handling end-to-end

• Test surprise-down drain and driver recovery

Senior review question

Ask: which latency, bandwidth, and reliability evidence proves this PCIe/CXL topic is closed under real traffic?

Key takeaways

• Always tie controller and PHY counter shifts to application latency and throughput outcomes.

• Lock firmware timing profile, thermal condition, and DIMM state before comparing PCIe/CXL captures.

Common pitfalls

• Chasing peak bandwidth while ignoring p99 latency and fairness tails.

• Changing timing guardbands without separating SI noise from scheduling issues.

• Declaring closure without reliability gates, fault injection, and regression replay.

Report interpretation

Unexpected link drop leaves outstanding transactions undefined. Ports must report surprise-down, stall new requests, and coordinate with drivers to reset endpoints without corrupting host memory. PCIe/CXL inefficiency is multiplicative: one extra ACTIVATE, one unnecessary turnaround, one weak lane margin, or one refresh collision repeated across billions of accesses can dominate product tail latency and power.

Use Surprise-down detection latency, in-flight IO drain time, and recovery success rate as the opening signal, not the conclusion. A metric move only becomes actionable when paired with workload context, command traces, training telemetry, and evidence artifacts such as Link down event log, in-flight transaction snapshot, and driver recovery trace.

RAS policies translate PCIe/CXL errors into bounded blast radius and predictable recovery. Senior review quality comes from proving a complete chain: request pattern -> memory-state transition -> bottleneck mechanism -> smallest owner fix -> regression-safe validation.

For Surprise Down and Link Loss Handling, reports should explain why Surprise-down detection latency, in-flight IO drain time, and recovery success rate moved: fewer row misses, lower turnaround waste, better refresh placement, or stronger lane margin stability.

Strong reports include consistency checks: scheduler narrative matches command logs; PHY narrative matches margin sweeps; reliability narrative matches CE/UE trajectories.