Media agent for Shaka v4.0.3

March 9, 2026

This release introduces three new bitrate metrics for granular playback observability, QoE (Quality of Experience) support, and Shaka Player 5.x compatibility while maintaining backward compatibility with Shaka 4.x.

New bitrate metrics

Three new attributes are now available to provide deeper insight into streaming performance:

Attribute	Source	Description
`contentManifestBitrate`	`stats.streamBandwidth`	Total variant bitrate (video + audio) as declared in the manifest (Indicated Bitrate).
`contentMeasuredBitrate`	`stats.estimatedBandwidth`	Estimated network bandwidth measured by Shaka's ABR algorithm (Observed Bitrate).
`contentDownloadBitrate`	`(bytesDownloaded × 8) / playTime`	Effective download throughput across all downloaded media.

Additionally, contentBitrate uses track.videoBandwidth (video-only bitrate) to differentiate it from other metrics that report combined video and audio bandwidth.

Quality of Experience (QoE) support

QoE aggregate events are now supported via video-core. Enable them by setting qoeAggregate: true in the config:

const options = {
  info: {
    beacon: 'xxxxxxxxxx',
    applicationID: 'xxxxxxx',
    licenseKey: 'xxxxxxxxxxx',
  },
  config: {
    qoeAggregate: true,
    qoeIntervalFactor: 2,
  },
};

const tracker = new ShakaTracker(player, options);

The following KPIs are tracked automatically:

KPI	Description
`startupTime`	Time from content request to content start (ms).
`peakBitrate`	Maximum `contentBitrate` observed during playback.
`averageBitrate`	Weighted average bitrate across the session.
`hadStartupFailure`	`true` if a content error occurred before content started.
`hadPlaybackFailure`	`true` if a content error occurred during playback.
`totalRebufferingTime`	Total time spent rebuffering (ms).
`rebufferingRatio`	Rebuffering time as a percentage of total playtime.
`totalPlaytime`	Total content playtime (ms).
`numberOfErrors`	Total number of errors during the session.

Shaka Player 5.x compatibility

The tracker is now compatible with both Shaka Player 4.x and 5.x:

getPlayerVersion() resolves version across both major versions.
onError() handles both Shaka player errors (e.detail) and HTML video element errors (e.target.error).
Sample files updated for Shaka 5.x (removed deprecated shaka.polyfill.installAll(), updated player instantiation).

Upgrade guide

Run the following following to update:

bash

$npm install @newrelic/video-shaka@4.0.3

To enable QoE, add qoeAggregate: true to your config options as shown above.

Dependencies