Span event

What Span event shows

Span event is a timestamped annotation attached to a span to record something during its lifetime. It matters when a team can state the decision the evidence should support, the population being measured, and the time window in which the observation matters. That framing keeps a familiar label from becoming a dashboard tile with no operational meaning. The collection method and owner should be visible whenever the signal is used in a review.

A concrete example

A file-processing span records when a retry begins and when a checksum mismatch is found. A useful workflow records relevant context, compares the observation with an appropriate baseline, and follows the evidence to the service or change that may explain it. The signal should start a question rather than close the investigation. Teams should also record what action follows a meaningful change and how the result will be checked.

Limitations and tradeoffs

Events become verbose in loops and are not a substitute for durable audit records. Interpret span event alongside related signals and explicit service objectives. Sampling, aggregation, clock behavior, retention, and access policy can all affect what an operator sees. When those details are missing, conclusions should remain provisional and a precise-looking value should not be presented as a complete account of user experience.