feat: QOE

[avinash-newrelic]

Summary

Introduces a QOE_AGGREGATE action under VideoAction that periodically reports Quality of Experience KPIs during video playback. QoE events are generated at harvest time and injected directly into the harvest batch, independent of the regular event buffer.

KPIs Tracked

Attribute	Type	Description
startupTime	Long (ms)	Time from CONTENT_REQUEST to CONTENT_START, minus pre-roll ad time (wall-clock totalPreRollAdTime), clamped to >= 0
peakBitrate	Long (bps)	Highest observed contentBitrate during the session
averageBitrate	Long (bps)	Time-weighted average of contentBitrate during active playback only; non-play time (pause, buffer, seek) is excluded
totalPlaytime	Long (ms)	Total content playtime excluding pause, buffer, and seek; computed in real-time at harvest
totalRebufferingTime	Long (ms)	Total duration of all CONTENT_BUFFER_END events except the first one in the session (initial load), regardless of bufferType
rebufferingRatio	Double (%)	(totalRebufferingTime / totalPlaytime) * 100, recomputed at harvest with real-time totalPlaytime
hadStartupError	Bool	true if a CONTENT_ERROR occurred before CONTENT_START
hadPlaybackError	Bool	true if a CONTENT_ERROR occurred after CONTENT_START

How It Works

• At CONTENT_REQUEST, the tracker registers a QoE provider on the harvest manager — ensuring QoE is sent even if CONTENT_START never happens (e.g., startup error)
• QoE is decoupled from the VideoAction event buffer — collected independently on each harvest cycle based on a configurable multiplier, even when the batch is empty
• A snapshot-based dirty check ensures QoE is only sent when KPI values have actually changed
• totalPlaytime is computed in real-time at harvest using a read-only peek, avoiding stale values between events
• At CONTENT_END, the final QoE event is built eagerly while tracker state is still valid and enqueued for the next harvest, avoiding race conditions
• QoE context attributes use a strict whitelist from the last content event
• KPI attribute keys are unprefixed and centralized in a single list used by the aggregator, harvest manager, and dirty check
• Startup time: Used wall-clock ad duration (totalPreRollAdTime) instead of ad playtime for accurate startup KPI
• Average bitrate: Paused bitrate timer during non-play states (pause, buffer, seek) so only active playback is counted

Fixes

• viewId: Moved viewIdIndex increment from sendStart to sendRequest so post-roll ads share the same viewId as their content

Configuration

Option	Type	Default	Description
qoeAggregateEnabled	Bool	false	Master switch for QoE aggregate events
qoeAggregateIntervalMultiplier	Integer	1	QoE evaluated every N harvest cycles