datarhei-dragonfork-core/app/webrtc/metrics.go

package webrtc

import (
	"time"

	corewebrtc "github.com/datarhei/core/v16/core/webrtc"
	coreprom "github.com/datarhei/core/v16/prometheus"
	"github.com/prometheus/client_golang/prometheus"
)

var iceHistBuckets = []float64{0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10}

type webrtcMetrics struct {
	whepRequests        *prometheus.CounterVec
	whepRequestDuration *prometheus.HistogramVec
	iceEstablishment    *prometheus.HistogramVec
	iceFailures         *prometheus.CounterVec
	codecMismatches     *prometheus.CounterVec
	capRejections       *prometheus.CounterVec
	ffmpegLegFailures   *prometheus.CounterVec
}

// mustRegisterCounter creates a CounterVec and registers it with reg.
// Panics on duplicate registration (same semantics as promauto).
func mustRegisterCounter(reg prometheus.Registerer, opts prometheus.CounterOpts, labels []string) *prometheus.CounterVec {
	m := prometheus.NewCounterVec(opts, labels)
	reg.MustRegister(m)
	return m
}

// mustRegisterHistogram creates a HistogramVec and registers it with reg.
func mustRegisterHistogram(reg prometheus.Registerer, opts prometheus.HistogramOpts, labels []string) *prometheus.HistogramVec {
	m := prometheus.NewHistogramVec(opts, labels)
	reg.MustRegister(m)
	return m
}

func initMetrics(reg prometheus.Registerer, core string) *webrtcMetrics {
	cl := prometheus.Labels{"core": core}
	return &webrtcMetrics{
		whepRequests: mustRegisterCounter(reg, prometheus.CounterOpts{
			Name:        "dragonfork_webrtc_whep_requests_total",
			Help:        "Count of WHEP HTTP requests by route, HTTP status code, and stream.",
			ConstLabels: cl,
		}, []string{"route", "code", "stream_id"}),

		whepRequestDuration: mustRegisterHistogram(reg, prometheus.HistogramOpts{
			Name:        "dragonfork_webrtc_whep_request_duration_seconds",
			Help:        "Server-side WHEP request latency in seconds, by route and stream.",
			ConstLabels: cl,
			Buckets:     iceHistBuckets,
		}, []string{"route", "stream_id"}),

		iceEstablishment: mustRegisterHistogram(reg, prometheus.HistogramOpts{
			Name:        "dragonfork_webrtc_ice_establishment_duration_seconds",
			Help:        "Duration from peer creation to first connected or failed ICE state.",
			ConstLabels: cl,
			Buckets:     iceHistBuckets,
		}, []string{"stream_id", "result"}),

		iceFailures: mustRegisterCounter(reg, prometheus.CounterOpts{
			Name:        "dragonfork_webrtc_ice_failures_total",
			Help:        "Count of ICE failures by stream and reason.",
			ConstLabels: cl,
		}, []string{"stream_id", "reason"}),

		codecMismatches: mustRegisterCounter(reg, prometheus.CounterOpts{
			Name:        "dragonfork_webrtc_codec_mismatches_total",
			Help:        "Count of 406 codec-mismatch rejections by stream and codec kind.",
			ConstLabels: cl,
		}, []string{"stream_id", "kind"}),

		capRejections: mustRegisterCounter(reg, prometheus.CounterOpts{
			Name:        "dragonfork_webrtc_cap_rejections_total",
			Help:        "Count of 503 peer-cap rejections by stream and scope (global or stream).",
			ConstLabels: cl,
		}, []string{"stream_id", "scope"}),

		ffmpegLegFailures: mustRegisterCounter(reg, prometheus.CounterOpts{
			Name:        "dragonfork_webrtc_ffmpeg_leg_failures_total",
			Help:        "Count of FFmpeg RTP output leg failures (process stopped while peers were active).",
			ConstLabels: cl,
		}, []string{"stream_id", "leg"}),
	}
}

// InitMetrics initialises WebRTC direct-instrumentation metrics on h and
// registers the snapshot collector with reg. Call once after construction,
// before the handler serves requests. Panics on duplicate registration.
func (h *Handler) InitMetrics(reg prometheus.Registerer, core string) {
	h.met = initMetrics(reg, core)
}

// Stats implements coreprom.WebRTCStatsSource for the Prometheus snapshot
// collector. Returns a consistent snapshot under h.mu.
func (h *Handler) Stats() coreprom.WebRTCStats {
	h.mu.Lock()
	peers := make(map[string]int, len(h.peersByStream))
	for id, pm := range h.peersByStream {
		peers[id] = len(pm)
	}
	sc := 0
	if h.sub != nil {
		sc = h.sub.StreamCount()
	}
	h.mu.Unlock()
	return coreprom.WebRTCStats{
		StreamCount:   sc,
		PeersByStream: peers,
		UDPPortsInUse: sc * 2,
	}
}

// trackICE waits for the first terminal ICE event and records establishment
// duration and failure metrics. t0 should be captured immediately before
// CreatePeerFromSources returns. Runs in a goroutine per Subscribe call.
func (h *Handler) trackICE(streamID string, peer *corewebrtc.Peer, t0 time.Time) {
	if h.met == nil {
		return
	}
	select {
	case <-peer.Connected():
		h.met.iceEstablishment.WithLabelValues(streamID, "connected").Observe(time.Since(t0).Seconds())
	case <-peer.Done():
		dur := time.Since(t0)
		h.met.iceEstablishment.WithLabelValues(streamID, "failed").Observe(dur.Seconds())
		h.met.iceFailures.WithLabelValues(streamID, "reason").Inc()
	}
}