package buffer import ( "fmt" "sync" "time" "github.com/pion/rtcp" "github.com/pion/rtp" "google.golang.org/protobuf/types/known/timestamppb" "github.com/livekit/protocol/livekit" "github.com/livekit/protocol/logger" ) const ( GapHistogramNumBins = 101 SequenceNumberMin = uint16(0) SequenceNumberMax = uint16(65535) NumSequenceNumbers = 65536 FirstSnapshotId = 1 ) type RTPFlowState struct { IsHighestSN bool HasLoss bool LossStartInclusive uint16 LossEndExclusive uint16 } type RTPSnapshotInfo struct { PacketsExpected uint32 PacketsLost uint32 JitterMax float64 RttMax uint32 } type RTPDeltaInfo struct { Packets uint32 Bytes uint64 PacketsDuplicate uint32 BytesDuplicate uint64 PacketsPadding uint32 BytesPadding uint64 PacketsLost uint32 Frames uint32 RttMax uint32 JitterMax float64 Nacks uint32 Plis uint32 Firs uint32 } type Snapshot struct { extStartSN uint32 packetsDuplicate uint32 bytesDuplicate uint64 packetsLostOverridden uint32 nacks uint32 plis uint32 firs uint32 maxRtt uint32 maxJitter float64 maxJitterOverridden float64 } type SnInfo struct { pktSize uint16 payloadSize uint16 marker bool } type RTPStatsParams struct { ClockRate uint32 IsReceiverReportDriven bool Logger logger.Logger } type RTPStats struct { params RTPStatsParams logger logger.Logger lock sync.RWMutex initialized bool startTime time.Time endTime time.Time extStartSN uint32 highestSN uint16 cycles uint16 isRRSeen bool extHighestSNOverridden uint32 highestTS uint32 highestTime int64 lastTransit uint32 bytes uint64 bytesDuplicate uint64 bytesPadding uint64 packetsDuplicate uint32 packetsPadding uint32 packetsOutOfOrder uint32 packetsLost uint32 packetsLostOverridden uint32 frames uint32 jitter float64 maxJitter float64 jitterOverridden float64 maxJitterOverridden float64 snInfos [NumSequenceNumbers]SnInfo gapHistogram [GapHistogramNumBins]uint32 nacks uint32 nackMisses uint32 plis uint32 lastPli time.Time layerLockPlis uint32 lastLayerLockPli time.Time firs uint32 lastFir time.Time keyFrames uint32 lastKeyFrame time.Time rtt uint32 maxRtt uint32 rtpSR uint32 ntpSR NtpTime arrivalSR int64 nextSnapshotId uint32 snapshots map[uint32]*Snapshot } func NewRTPStats(params RTPStatsParams) *RTPStats { return &RTPStats{ params: params, logger: params.Logger, nextSnapshotId: FirstSnapshotId, snapshots: make(map[uint32]*Snapshot), } } func (r *RTPStats) SetLogger(logger logger.Logger) { r.logger = logger } func (r *RTPStats) Stop() { r.lock.Lock() defer r.lock.Unlock() r.endTime = time.Now() } func (r *RTPStats) NewSnapshotId() uint32 { r.lock.Lock() defer r.lock.Unlock() id := r.nextSnapshotId if r.initialized { r.snapshots[id] = &Snapshot{extStartSN: r.extStartSN} } r.nextSnapshotId++ return id } func (r *RTPStats) IsActive() bool { r.lock.RLock() defer r.lock.RUnlock() return r.initialized && r.endTime.IsZero() } func (r *RTPStats) Update(rtph *rtp.Header, payloadSize int, paddingSize int, packetTime int64) (flowState RTPFlowState) { r.lock.Lock() defer r.lock.Unlock() if !r.endTime.IsZero() { return } first := false if !r.initialized { r.initialized = true r.startTime = time.Now() r.highestSN = rtph.SequenceNumber - 1 r.highestTS = rtph.Timestamp r.highestTime = packetTime r.extStartSN = uint32(rtph.SequenceNumber) r.cycles = 0 first = true // initialize snapshots if any for i := uint32(FirstSnapshotId); i < r.nextSnapshotId; i++ { r.snapshots[i] = &Snapshot{extStartSN: r.extStartSN} } } pktSize := uint64(rtph.MarshalSize() + payloadSize + paddingSize) isDuplicate := false diff := rtph.SequenceNumber - r.highestSN switch { // duplicate or out-of-order case diff == 0 || diff > (1<<15): if diff != 0 { r.packetsOutOfOrder++ } // adjust start to account for out-of-order packets before a cycle completes r.maybeAdjustStartSN(rtph, packetTime) if !r.isSnInfoLost(rtph.SequenceNumber) { r.bytesDuplicate += pktSize r.packetsDuplicate++ isDuplicate = true } else { r.packetsLost-- } // in-order default: flowState.IsHighestSN = true if diff > 1 { flowState.HasLoss = true flowState.LossStartInclusive = r.highestSN + 1 flowState.LossEndExclusive = rtph.SequenceNumber } // update gap histogram r.updateGapHistogram(int(diff)) // update missing sequence numbers for lost := r.highestSN + 1; lost != rtph.SequenceNumber; lost++ { r.clearSnInfo(lost) } r.packetsLost += uint32(diff - 1) if rtph.SequenceNumber < r.highestSN && !first { r.cycles++ } r.highestSN = rtph.SequenceNumber r.highestTS = rtph.Timestamp r.highestTime = packetTime if rtph.Marker { r.frames++ } } if !isDuplicate { r.setSnInfo(rtph.SequenceNumber, uint16(pktSize), uint16(payloadSize), rtph.Marker) if payloadSize == 0 { r.packetsPadding++ r.bytesPadding += pktSize } else { r.bytes += pktSize } r.updateJitter(rtph, packetTime) } return } func (r *RTPStats) maybeAdjustStartSN(rtph *rtp.Header, packetTime int64) { if (r.getExtHighestSN() - r.extStartSN + 1) >= (NumSequenceNumbers / 2) { return } if (rtph.SequenceNumber - uint16(r.extStartSN)) < (1 << 15) { return } // NOTE: current sequence number is counted as loss as it will be deducted in the duplicate check r.packetsLost += uint32(uint16(r.extStartSN) - rtph.SequenceNumber) beforeAdjust := r.extStartSN r.extStartSN = uint32(rtph.SequenceNumber) for _, s := range r.snapshots { if s.extStartSN == beforeAdjust { s.extStartSN = r.extStartSN } } } func (r *RTPStats) GetTotalPacketsPrimary() uint32 { r.lock.RLock() defer r.lock.RUnlock() return r.getTotalPacketsPrimary() } func (r *RTPStats) getTotalPacketsPrimary() uint32 { packetsExpected := r.getExtHighestSN() - r.extStartSN + 1 if r.packetsLost > packetsExpected { // should not happen return 0 } packetsSeen := packetsExpected - r.packetsLost if r.packetsPadding > packetsSeen { return 0 } return packetsSeen - r.packetsPadding } func (r *RTPStats) UpdateFromReceiverReport(extHighestSN uint32, packetsLost uint32, rtt uint32, jitter float64) { r.lock.Lock() defer r.lock.Unlock() if !r.endTime.IsZero() || !r.params.IsReceiverReportDriven { return } r.isRRSeen = true r.extHighestSNOverridden = extHighestSN r.packetsLostOverridden = packetsLost r.rtt = rtt if rtt > r.maxRtt { r.maxRtt = rtt } r.jitterOverridden = jitter if jitter > r.maxJitterOverridden { r.maxJitterOverridden = jitter } // update snapshots for _, s := range r.snapshots { if rtt > s.maxRtt { s.maxRtt = rtt } if jitter > s.maxJitterOverridden { s.maxJitterOverridden = jitter } } } func (r *RTPStats) UpdateNackAndMiss(nackCount uint32, nackMissCount uint32) { r.lock.Lock() defer r.lock.Unlock() if !r.endTime.IsZero() { return } r.updateNackLocked(nackCount) r.updateNackMissLocked(nackMissCount) } func (r *RTPStats) UpdateNack(nackCount uint32) { r.lock.Lock() defer r.lock.Unlock() if !r.endTime.IsZero() { return } r.updateNackLocked(nackCount) } func (r *RTPStats) updateNackLocked(nackCount uint32) { r.nacks += nackCount } func (r *RTPStats) UpdateNackMiss(nackMissCount uint32) { r.lock.Lock() defer r.lock.Unlock() if !r.endTime.IsZero() { return } r.updateNackMissLocked(nackMissCount) } func (r *RTPStats) updateNackMissLocked(nackMissCount uint32) { r.nackMisses += nackMissCount } func (r *RTPStats) UpdatePliAndTime(pliCount uint32) { r.lock.Lock() defer r.lock.Unlock() if !r.endTime.IsZero() { return } r.updatePliLocked(pliCount) r.updatePliTimeLocked() } func (r *RTPStats) UpdatePli(pliCount uint32) { r.lock.Lock() defer r.lock.Unlock() if !r.endTime.IsZero() { return } r.updatePliLocked(pliCount) } func (r *RTPStats) updatePliLocked(pliCount uint32) { r.plis += pliCount } func (r *RTPStats) UpdatePliTime() { r.lock.Lock() defer r.lock.Unlock() if !r.endTime.IsZero() { return } r.updatePliTimeLocked() } func (r *RTPStats) updatePliTimeLocked() { r.lastPli = time.Now() } func (r *RTPStats) LastPli() time.Time { r.lock.RLock() defer r.lock.RUnlock() return r.lastPli } func (r *RTPStats) TimeSinceLastPli() int64 { r.lock.RLock() defer r.lock.RUnlock() return time.Now().UnixNano() - r.lastPli.UnixNano() } func (r *RTPStats) UpdateLayerLockPliAndTime(pliCount uint32) { r.lock.Lock() defer r.lock.Unlock() if !r.endTime.IsZero() { return } r.layerLockPlis += pliCount r.lastLayerLockPli = time.Now() } func (r *RTPStats) UpdateFir(firCount uint32) { r.lock.Lock() defer r.lock.Unlock() if !r.endTime.IsZero() { return } r.firs += firCount } func (r *RTPStats) UpdateFirTime() { r.lock.Lock() defer r.lock.Unlock() if !r.endTime.IsZero() { return } r.lastFir = time.Now() } func (r *RTPStats) UpdateKeyFrame(kfCount uint32) { r.lock.Lock() defer r.lock.Unlock() if !r.endTime.IsZero() { return } r.keyFrames += kfCount r.lastKeyFrame = time.Now() } func (r *RTPStats) UpdateRtt(rtt uint32) { r.lock.Lock() defer r.lock.Unlock() if !r.endTime.IsZero() { return } r.rtt = rtt if rtt > r.maxRtt { r.maxRtt = rtt } for _, s := range r.snapshots { if rtt > s.maxRtt { s.maxRtt = rtt } } } func (r *RTPStats) GetRtt() uint32 { r.lock.RLock() defer r.lock.RUnlock() return r.rtt } func (r *RTPStats) SetRtcpSenderReportData(rtpTS uint32, ntpTS NtpTime, arrival time.Time) { r.lock.Lock() defer r.lock.Unlock() r.rtpSR = rtpTS r.ntpSR = ntpTS r.arrivalSR = arrival.UnixNano() } func (r *RTPStats) GetRtcpSenderReport(ssrc uint32) *rtcp.SenderReport { r.lock.RLock() defer r.lock.RUnlock() if !r.initialized { return nil } now := time.Now() nowNTP := ToNtpTime(now) nowRTP := r.highestTS + uint32((now.UnixNano()-r.highestTime)*int64(r.params.ClockRate)/1e9) return &rtcp.SenderReport{ SSRC: ssrc, NTPTime: uint64(nowNTP), RTPTime: nowRTP, PacketCount: r.getTotalPacketsPrimary() + r.packetsDuplicate + r.packetsPadding, OctetCount: uint32(r.bytes + r.bytesDuplicate + r.bytesPadding), } } func (r *RTPStats) SnapshotRtcpReceptionReport(ssrc uint32, proxyFracLost uint8, snapshotId uint32) *rtcp.ReceptionReport { r.lock.Lock() then, now := r.getAndResetSnapshot(snapshotId) r.lock.Unlock() if now == nil || then == nil { return nil } r.lock.RLock() defer r.lock.RUnlock() packetsExpected := now.extStartSN - then.extStartSN if packetsExpected > NumSequenceNumbers { logger.Warnw( "too many packets expected in receiver report", fmt.Errorf("start: %d, end: %d, expected: %d", then.extStartSN, now.extStartSN, packetsExpected), ) return nil } if packetsExpected == 0 { return nil } packetsLost := uint32(0) if r.params.IsReceiverReportDriven { // should not be set for streams that need to generate reception report packetsLost = now.packetsLostOverridden - then.packetsLostOverridden } else { _, _, _, _, packetsLost, _ = r.getIntervalStats(uint16(then.extStartSN), uint16(now.extStartSN)) } lossRate := float32(packetsLost) / float32(packetsExpected) fracLost := uint8(lossRate * 256.0) if proxyFracLost > fracLost { fracLost = proxyFracLost } var dlsr uint32 if r.arrivalSR != 0 { delayMS := uint32((time.Now().UnixNano() - r.arrivalSR) / 1e6) dlsr = (delayMS / 1e3) << 16 dlsr |= (delayMS % 1e3) * 65536 / 1000 } jitter := r.jitter if r.params.IsReceiverReportDriven { // should not be set for streams that need to generate reception report jitter = r.jitterOverridden } return &rtcp.ReceptionReport{ SSRC: ssrc, FractionLost: fracLost, TotalLost: r.packetsLost, LastSequenceNumber: now.extStartSN, Jitter: uint32(jitter), LastSenderReport: uint32(r.ntpSR >> 16), Delay: dlsr, } } func (r *RTPStats) SnapshotInfo(snapshotId uint32) *RTPSnapshotInfo { r.lock.Lock() then, now := r.getAndResetSnapshot(snapshotId) r.lock.Unlock() if now == nil || then == nil { return nil } r.lock.RLock() defer r.lock.RUnlock() packetsExpected := now.extStartSN - then.extStartSN if packetsExpected > NumSequenceNumbers { logger.Warnw( "too many packets expected in snapshot", fmt.Errorf("start: %d, end: %d, expected: %d", then.extStartSN, now.extStartSN, packetsExpected), ) return nil } if packetsExpected == 0 { return nil } packetsLost := uint32(0) if r.params.IsReceiverReportDriven { packetsLost = now.packetsLostOverridden - then.packetsLostOverridden } else { _, _, _, _, packetsLost, _ = r.getIntervalStats(uint16(then.extStartSN), uint16(now.extStartSN)) } maxJitter := then.maxJitter if r.params.IsReceiverReportDriven { maxJitter = then.maxJitterOverridden } maxJitterTime := maxJitter / float64(r.params.ClockRate) * 1e6 return &RTPSnapshotInfo{ PacketsExpected: packetsExpected, PacketsLost: packetsLost, JitterMax: maxJitterTime, RttMax: then.maxRtt, } } func (r *RTPStats) DeltaInfo(snapshotId uint32) *RTPDeltaInfo { r.lock.Lock() then, now := r.getAndResetSnapshot(snapshotId) r.lock.Unlock() if now == nil || then == nil { return nil } r.lock.RLock() defer r.lock.RUnlock() packetsExpected := now.extStartSN - then.extStartSN if packetsExpected > NumSequenceNumbers { logger.Warnw( "too many packets expected in delta", fmt.Errorf("start: %d, end: %d, expected: %d", then.extStartSN, now.extStartSN, packetsExpected), ) return nil } if packetsExpected == 0 { return nil } _, bytes, packetsPadding, bytesPadding, packetsLost, frames := r.getIntervalStats(uint16(then.extStartSN), uint16(now.extStartSN)) if r.params.IsReceiverReportDriven { packetsLost = now.packetsLostOverridden - then.packetsLostOverridden } maxJitter := then.maxJitter if r.params.IsReceiverReportDriven { maxJitter = then.maxJitterOverridden } maxJitterTime := maxJitter / float64(r.params.ClockRate) * 1e6 return &RTPDeltaInfo{ Packets: packetsExpected - packetsPadding, Bytes: bytes, PacketsDuplicate: now.packetsDuplicate - then.packetsDuplicate, BytesDuplicate: now.bytesDuplicate - then.bytesDuplicate, PacketsPadding: packetsPadding, BytesPadding: bytesPadding, PacketsLost: packetsLost, Frames: frames, RttMax: then.maxRtt, JitterMax: maxJitterTime, Nacks: now.nacks - then.nacks, Plis: now.plis - then.plis, Firs: now.firs - then.firs, } } func (r *RTPStats) ToString() string { p := r.ToProto() if p == nil { return "" } r.lock.RLock() defer r.lock.RUnlock() expectedPackets := r.getExtHighestSN() - r.extStartSN + 1 expectedPacketRate := float64(expectedPackets) / p.Duration str := fmt.Sprintf("t: %+v|%+v|%.2fs", p.StartTime.AsTime().Format(time.UnixDate), p.EndTime.AsTime().Format(time.UnixDate), p.Duration) str += fmt.Sprintf(" sn: %d|%d", r.extStartSN, r.getExtHighestSN()) str += fmt.Sprintf(", ep: %d|%.2f/s", expectedPackets, expectedPacketRate) str += fmt.Sprintf(", p: %d|%.2f/s", p.Packets, p.PacketRate) str += fmt.Sprintf(", l: %d|%.1f/s|%.2f%%", p.PacketsLost, p.PacketLossRate, p.PacketLossPercentage) str += fmt.Sprintf(", b: %d|%.1fbps", p.Bytes, p.Bitrate) str += fmt.Sprintf(", f: %d|%.1f/s / %d|%+v", p.Frames, p.FrameRate, p.KeyFrames, p.LastKeyFrame.AsTime().Format(time.UnixDate)) str += fmt.Sprintf(", d: %d|%.2f/s", p.PacketsDuplicate, p.PacketDuplicateRate) str += fmt.Sprintf(", bd: %d|%.1fbps", p.BytesDuplicate, p.BitrateDuplicate) str += fmt.Sprintf(", pp: %d|%.2f/s", p.PacketsPadding, p.PacketPaddingRate) str += fmt.Sprintf(", bp: %d|%.1fbps", p.BytesPadding, p.BitratePadding) str += fmt.Sprintf(", o: %d", p.PacketsOutOfOrder) jitter := r.jitter maxJitter := r.maxJitter if r.params.IsReceiverReportDriven { jitter = r.jitterOverridden maxJitter = r.maxJitterOverridden } str += fmt.Sprintf(", c: %d, j: %d(%.1fus)|%d(%.1fus)", r.params.ClockRate, uint32(jitter), p.JitterCurrent, uint32(maxJitter), p.JitterMax) if len(p.GapHistogram) != 0 { first := true str += ", gh:[" for burst, count := range p.GapHistogram { if !first { str += ", " } first = false str += fmt.Sprintf("%d:%d", burst, count) } str += "]" } str += ", n:" str += fmt.Sprintf("%d|%d", p.Nacks, p.NackMisses) str += ", pli:" str += fmt.Sprintf("%d|%+v / %d|%+v", p.Plis, p.LastPli.AsTime().Format(time.UnixDate), p.LayerLockPlis, p.LastLayerLockPli.AsTime().Format(time.UnixDate), ) str += ", fir:" str += fmt.Sprintf("%d|%+v", p.Firs, p.LastFir.AsTime().Format(time.UnixDate)) str += ", rtt(ms):" str += fmt.Sprintf("%d|%d", p.RttCurrent, p.RttMax) return str } func (r *RTPStats) ToProto() *livekit.RTPStats { r.lock.RLock() defer r.lock.RUnlock() if r.startTime.IsZero() { return nil } endTime := r.endTime if endTime.IsZero() { endTime = time.Now() } elapsed := endTime.Sub(r.startTime).Seconds() if elapsed == 0.0 { return nil } packets := r.getTotalPacketsPrimary() packetRate := float64(packets) / elapsed bitrate := float64(r.bytes) * 8.0 / elapsed frameRate := float64(r.frames) / elapsed packetsExpected := r.getExtHighestSN() - r.extStartSN + 1 packetsLost := r.getPacketsLost() packetLostRate := float64(packetsLost) / elapsed packetLostPercentage := float32(packetsLost) / float32(packetsExpected) * 100.0 packetDuplicateRate := float64(r.packetsDuplicate) / elapsed bitrateDuplicate := float64(r.bytesDuplicate) * 8.0 / elapsed packetPaddingRate := float64(r.packetsPadding) / elapsed bitratePadding := float64(r.bytesPadding) * 8.0 / elapsed jitter := r.jitter maxJitter := r.maxJitter if r.params.IsReceiverReportDriven { jitter = r.jitterOverridden maxJitter = r.maxJitterOverridden } jitterTime := jitter / float64(r.params.ClockRate) * 1e6 maxJitterTime := maxJitter / float64(r.params.ClockRate) * 1e6 p := &livekit.RTPStats{ StartTime: timestamppb.New(r.startTime), EndTime: timestamppb.New(endTime), Duration: elapsed, Packets: packets, PacketRate: packetRate, Bytes: r.bytes, Bitrate: bitrate, PacketsLost: packetsLost, PacketLossRate: packetLostRate, PacketLossPercentage: packetLostPercentage, PacketsDuplicate: r.packetsDuplicate, PacketDuplicateRate: packetDuplicateRate, BytesDuplicate: r.bytesDuplicate, BitrateDuplicate: bitrateDuplicate, PacketsPadding: r.packetsPadding, PacketPaddingRate: packetPaddingRate, BytesPadding: r.bytesPadding, BitratePadding: bitratePadding, PacketsOutOfOrder: r.packetsOutOfOrder, Frames: r.frames, FrameRate: frameRate, KeyFrames: r.keyFrames, LastKeyFrame: timestamppb.New(r.lastKeyFrame), JitterCurrent: jitterTime, JitterMax: maxJitterTime, Nacks: r.nacks, NackMisses: r.nackMisses, Plis: r.plis, LastPli: timestamppb.New(r.lastPli), LayerLockPlis: r.layerLockPlis, LastLayerLockPli: timestamppb.New(r.lastLayerLockPli), Firs: r.firs, LastFir: timestamppb.New(r.lastFir), RttCurrent: r.rtt, RttMax: r.maxRtt, } gapsPresent := false for i := 0; i < len(r.gapHistogram); i++ { if r.gapHistogram[i] == 0 { continue } gapsPresent = true break } if gapsPresent { p.GapHistogram = make(map[int32]uint32, GapHistogramNumBins) for i := 0; i < len(r.gapHistogram); i++ { if r.gapHistogram[i] == 0 { continue } p.GapHistogram[int32(i+1)] = r.gapHistogram[i] } } return p } func (r *RTPStats) getExtHighestSN() uint32 { return (uint32(r.cycles) << 16) | uint32(r.highestSN) } func (r *RTPStats) getExtHighestSNAdjusted() uint32 { if r.params.IsReceiverReportDriven && r.isRRSeen { return r.extHighestSNOverridden } return r.getExtHighestSN() } func (r *RTPStats) getPacketsLost() uint32 { if r.params.IsReceiverReportDriven && r.isRRSeen { return r.packetsLostOverridden } return r.packetsLost } func (r *RTPStats) setSnInfo(sn uint16, pktSize uint16, payloadSize uint16, marker bool) { snInfo := &r.snInfos[sn] snInfo.pktSize = pktSize snInfo.payloadSize = payloadSize snInfo.marker = marker } func (r *RTPStats) clearSnInfo(sn uint16) { snInfo := &r.snInfos[sn] snInfo.pktSize = 0 snInfo.payloadSize = 0 snInfo.marker = false } func (r *RTPStats) isSnInfoLost(sn uint16) bool { snInfo := &r.snInfos[sn] return snInfo.pktSize == 0 && snInfo.payloadSize == 0 } func (r *RTPStats) getIntervalStats(startInclusive uint16, endExclusive uint16) (packets uint32, bytes uint64, packetsPadding uint32, bytesPadding uint64, packetsLost uint32, frames uint32) { processSN := func(sn uint16) { snInfo := &r.snInfos[sn] switch { case snInfo.pktSize == 0 && snInfo.payloadSize == 0: packetsLost++ case snInfo.payloadSize == 0: packetsPadding++ bytesPadding += uint64(snInfo.pktSize) default: packets++ bytes += uint64(snInfo.pktSize) } if snInfo.marker { frames++ } } if startInclusive == endExclusive { // do a full cycle for sn := uint32(0); sn < NumSequenceNumbers; sn++ { processSN(uint16(sn)) } } else { for sn := startInclusive; sn != endExclusive; sn++ { processSN(sn) } } return } func (r *RTPStats) updateJitter(rtph *rtp.Header, packetTime int64) { packetTimeRTP := uint32(packetTime / 1e6 * int64(r.params.ClockRate/1e3)) transit := packetTimeRTP - rtph.Timestamp if r.lastTransit != 0 { d := int32(transit - r.lastTransit) if d < 0 { d = -d } r.jitter += (float64(d) - r.jitter) / 16 if r.jitter > r.maxJitter { r.maxJitter = r.jitter } for _, s := range r.snapshots { if r.jitter > s.maxJitter { r.maxJitter = r.jitter } } } r.lastTransit = transit } func (r *RTPStats) updateGapHistogram(gap int) { if gap < 2 { return } missing := gap - 1 if missing > len(r.gapHistogram) { r.gapHistogram[len(r.gapHistogram)-1]++ } else { r.gapHistogram[missing-1]++ } } func (r *RTPStats) getAndResetSnapshot(snapshotId uint32) (*Snapshot, *Snapshot) { if !r.initialized || (r.params.IsReceiverReportDriven && !r.isRRSeen) { return nil, nil } then := r.snapshots[snapshotId] if then == nil { then = &Snapshot{ extStartSN: r.extStartSN, } r.snapshots[snapshotId] = then } // snapshot now r.snapshots[snapshotId] = &Snapshot{ extStartSN: r.getExtHighestSNAdjusted() + 1, packetsDuplicate: r.packetsDuplicate, bytesDuplicate: r.bytesDuplicate, packetsLostOverridden: r.packetsLostOverridden, nacks: r.nacks, plis: r.plis, firs: r.firs, maxJitter: 0.0, maxJitterOverridden: 0.0, maxRtt: 0, } // make a copy so that it can be used independently now := *r.snapshots[snapshotId] return then, &now } // ---------------------------------- func AggregateRTPStats(statsList []*livekit.RTPStats) *livekit.RTPStats { startTime := time.Time{} endTime := time.Time{} packets := uint32(0) bytes := uint64(0) packetsLost := uint32(0) packetsDuplicate := uint32(0) bytesDuplicate := uint64(0) packetsPadding := uint32(0) bytesPadding := uint64(0) packetsOutOfOrder := uint32(0) frames := uint32(0) keyFrames := uint32(0) lastKeyFrame := time.Time{} jitter := 0.0 maxJitter := float64(0) gapHistogram := make(map[int32]uint32, GapHistogramNumBins) nacks := uint32(0) nackMisses := uint32(0) plis := uint32(0) lastPli := time.Time{} layerLockPlis := uint32(0) lastLayerLockPli := time.Time{} firs := uint32(0) lastFir := time.Time{} rtt := uint32(0) maxRtt := uint32(0) for _, stats := range statsList { if startTime.IsZero() || startTime.After(stats.StartTime.AsTime()) { startTime = stats.StartTime.AsTime() } if endTime.IsZero() || endTime.Before(stats.EndTime.AsTime()) { endTime = stats.EndTime.AsTime() } packets += stats.Packets bytes += stats.Bytes packetsLost += stats.PacketsLost packetsDuplicate += stats.PacketsDuplicate bytesDuplicate += stats.BytesDuplicate packetsPadding += stats.PacketsPadding bytesPadding += stats.BytesPadding packetsOutOfOrder += stats.PacketsOutOfOrder frames += stats.Frames keyFrames += stats.KeyFrames if lastKeyFrame.IsZero() || lastKeyFrame.Before(stats.LastKeyFrame.AsTime()) { lastKeyFrame = stats.LastKeyFrame.AsTime() } jitter += stats.JitterCurrent if stats.JitterMax > maxJitter { maxJitter = stats.JitterMax } for burst, count := range stats.GapHistogram { gapHistogram[burst] += count } nacks += stats.Nacks nackMisses += stats.NackMisses plis += stats.Plis if lastPli.IsZero() || lastPli.Before(stats.LastPli.AsTime()) { lastPli = stats.LastPli.AsTime() } layerLockPlis += stats.LayerLockPlis if lastLayerLockPli.IsZero() || lastLayerLockPli.Before(stats.LastLayerLockPli.AsTime()) { lastLayerLockPli = stats.LastLayerLockPli.AsTime() } firs += stats.Firs if lastFir.IsZero() || lastPli.Before(stats.LastFir.AsTime()) { lastFir = stats.LastFir.AsTime() } rtt += stats.RttCurrent if stats.RttMax > maxRtt { maxRtt = stats.RttMax } } if endTime.IsZero() { endTime = time.Now() } elapsed := endTime.Sub(startTime).Seconds() packetLostRate := float64(packetsLost) / elapsed packetLostPercentage := float32(packetsLost) / (float32(packets) + float32(packetsLost)) * 100.0 packetRate := float64(packets) / elapsed packetDuplicateRate := float64(packetsDuplicate) / elapsed packetPaddingRate := float64(packetsPadding) / elapsed bitrate := float64(bytes) * 8.0 / elapsed bitrateDuplicate := float64(bytesDuplicate) * 8.0 / elapsed bitratePadding := float64(bytesPadding) * 8.0 / elapsed frameRate := float64(frames) / elapsed return &livekit.RTPStats{ StartTime: timestamppb.New(startTime), EndTime: timestamppb.New(endTime), Duration: elapsed, Packets: packets, PacketRate: packetRate, Bytes: bytes, Bitrate: bitrate, PacketsLost: packetsLost, PacketLossRate: packetLostRate, PacketLossPercentage: packetLostPercentage, PacketsDuplicate: packetsDuplicate, PacketDuplicateRate: packetDuplicateRate, BytesDuplicate: bytesDuplicate, BitrateDuplicate: bitrateDuplicate, PacketsPadding: packetsPadding, PacketPaddingRate: packetPaddingRate, BytesPadding: bytesPadding, BitratePadding: bitratePadding, PacketsOutOfOrder: packetsOutOfOrder, Frames: frames, FrameRate: frameRate, KeyFrames: keyFrames, LastKeyFrame: timestamppb.New(lastKeyFrame), JitterCurrent: jitter / float64(len(statsList)), JitterMax: maxJitter, GapHistogram: gapHistogram, Nacks: nacks, NackMisses: nackMisses, Plis: plis, LastPli: timestamppb.New(lastPli), LayerLockPlis: layerLockPlis, LastLayerLockPli: timestamppb.New(lastLayerLockPli), Firs: firs, LastFir: timestamppb.New(lastFir), RttCurrent: rtt / uint32(len(statsList)), RttMax: maxRtt, } }