Open-source video QoE monitoring

Self-hosted Prometheus and Grafana stack for tracking video startup time, rebuffering, and quality metrics. Apache 2.0 licensed.

GitHub Documentation

Complete monitoring stack

Three components: browser SDK, edge worker, observability backend.

Components

JavaScript SDK for HTML5, Video.js, HLS.js, dash.js, Shaka
Cloudflare Worker for event validation and routing
Grafana Mimir for metrics, Loki for logs
4 Grafana dashboards, 25 recording rules, 18 alerts

Metrics

22 Prometheus metrics across 6 categories
Histogram-based P50/P95/P99 on startup and rebuffer
12 event types: playerready, viewstart, playing, stall, etc
Multi-tenant via X-Scope-OrgID header

Features

Dashboards and Alerts

4 pre-built Grafana dashboards
58 visualization panels
25 Prometheus recording rules
18 alert rules with configurable thresholds
Slack and PagerDuty integration

Player Support

HTML5 native video element
Video.js
HLS.js
dash.js
Shaka Player

Common use cases

VOD Platforms

Track startup time across content library
Identify slow-loading videos by region
Monitor completion rates and engagement
Correlate quality with viewer retention

Live Streaming

Real-time concurrent viewer monitoring
Track rebuffering during peak events
Alert on quality degradation instantly
Monitor stream health across CDNs

Multi-CDN Operations

Compare CDN performance by region
Identify CDN routing issues
Track origin vs edge delivery quality
Optimize CDN costs based on QoE data

Content Delivery Teams

Validate encoding quality changes
Test ABR ladder configurations
Monitor player version rollouts
Track infrastructure change impact

Deployment options

Self-Hosted

Deploy on your infrastructure with Docker Compose. Complete data ownership and control.

View Technical Details

Grafana Cloud

Connect to managed Grafana Cloud for zero infrastructure management.

Deployment Guide

Open source, Apache 2.0

Self-hosted video QoE monitoring with Prometheus and Grafana.

View on GitHub Read Documentation