RTP-Sequenznummern-Wraparound-Debugging: 16-Bit-Rollover, falscher Paketverlust, Jitter-Spitzen und lange Kamerastreams
So debuggen Sie RTP-Sequenznummern-Wraparound, 16-Bit-Rollover, falsche Paketverlustalarme, lang laufende RTSP-Kamerastreams, Jitter-Spitzen und Fehler bei der Sequenzverfolgung.
RTP-Sequenznummern sind 16-Bit-Werte. Sie springen schließlich von „65535“ zurück auf „0“. Benutzer suchen nach „RTP-Sequenznummer-Wraparound“, „RTP-falscher Paketverlust“, „RTSP-Jitter-Spitze nach einer Minute“, „RTP-Sequenz-Rollover“ und „Kamera-Stream-Paketverlustalarm falsch“, wenn ein lang laufender Stream plötzlich Tausende von Paketen zu verlieren scheint.
RTSP Inspector ist nützlich, da es sich hierbei um ein Problem bei der Medienheader-Abrechnung handelt. Der Stream ist möglicherweise fehlerfrei, aber der Analysator, das Gateway oder die Überwachungslogik behandeln einen Rollover möglicherweise als Verlust.
Wie ein Wraparound aussieht
Der normale Verlauf der RTP-Sequenz in der Nähe des Rollovers sieht folgendermaßen aus:
65533
65534
65535
0
1
2
That is not a gap. It is expected 16-bit rollover.
If a tool calculates 0 - 65535 as a huge negative jump or treats it as missing packets, it will report false loss.
Common symptoms
Wraparound bugs show up as:
- Packet loss spikes at regular intervals.
- Jitter graph jumps suddenly.
- Recording marks a healthy stream as unstable.
- RTP replay stops at sequence 65535.
- Analyzer reports negative sequence delta.
- Gateway resets statistics incorrectly.
- Long streams fail while short tests pass.
This case matters because many test streams are too short to expose the bug.
How fast rollover happens
Rollover timing depends on packet rate. A high bitrate video stream with many RTP packets per second can wrap relatively often. Low bitrate audio wraps much later.
Factors:
- Frame rate.
- Resolution.
- Bitrate.
- Fragmentation.
- MTU.
- Codec.
- Whether audio and video are analyzed separately.
If an H.264 keyframe is heavily fragmented, sequence numbers advance faster.
Loss vs rollover
A real loss near rollover is possible, so the analyzer must handle both cases.
Compare:
- Expected next sequence modulo 65536.
- Payload continuity.
- RTP timestamp continuity.
- Marker bit behavior.
- SSRC continuity.
- RTCP receiver reports.
If SSRC, timestamp, and payload cadence continue normally, rollover is likely benign.
SSRC changes are different
Do not confuse sequence wraparound with SSRC change. When SSRC changes, a new sequence space may start. When only sequence number wraps, the same stream identity continues.
Evidence:
- Same SSRC before and after.
- Same payload type.
- Same clock rate.
- Timestamp continues.
- No RTCP BYE.
- No RTSP reconnect.
That is sequence rollover, not source replacement.
Replay and archive bugs
Tools that archive RTP events can fail at wraparound if they sort by raw sequence number instead of extended sequence number.
Bad behavior:
- Packets after zero are sorted before older packets.
- Replay jumps backward.
- Loss calculation resets incorrectly.
- Exported evidence looks out of order.
RTSP Inspector should preserve raw sequence numbers but calculate continuity with rollover-aware logic.
Debug checklist
Use this process:
- Find the sequence boundary near
65535. - Check next packets after zero.
- Confirm SSRC stays the same.
- Confirm payload type stays the same.
- Compare RTP timestamp deltas.
- Check marker bit around frame boundary.
- Check RTCP loss reports.
- Separate rollover from actual missing packets.
- Preserve packets before and after rollover.
- Test long enough streams, not only short samples.
Final diagnosis
RTP sequence wraparound is normal. False alarms happen when tools treat 16-bit rollover as packet loss or stream reset.
RTSP Inspector helps diagnose long-running camera streams by showing sequence continuity, SSRC continuity, timestamp behavior, and real packet-loss evidence across rollover.
<!-- rtsp-localized-evidence-foundation-v1:start -->Reproduzierbarer Nachweis für „RTP-Sequenznummern-Wraparound-Debugging: 16-Bit-Rollover, falscher Paketverlust, Jitter-Spitzen und lange Kamerastreams“
Die direkte Antwort lautet: Eine Kamerastream-Störung wird nicht durch ein einzelnes Player-Fenster oder einen Statuscode bewiesen. Die belastbare Diagnose verbindet RTSP-Anfrage und Antwort, die ausgehandelte Transportart, eine gültige Session und anschließend RTP-Sequenznummern, Zeitstempel sowie RTCP-Belege. Beginnen Sie bei „RTP-Sequenznummern-Wraparound-Debugging: 16-Bit-Rollover, falscher Paketverlust, Jitter-Spitzen und lange Kamerastreams“ an der Schicht, die dem sichtbaren Symptom am nächsten liegt, behalten Sie aber eine gemeinsame Zeitleiste, damit Steuerungs-, Netzwerk- und Decoderfehler nicht vermischt werden.
Erstellen Sie vor Änderungen an Kamera, Firewall oder VMS einen kleinen Ausgangstest. Notieren Sie die bereinigte RTSP-URL, Uhrzeit, Pfad, angeforderten Transport, Serverantwort und den Zeitpunkt des ersten Medienpakets. Testen Sie UDP und TCP interleaved getrennt, sofern das Gerät beides anbietet. Ändern Sie nicht gleichzeitig Pfad, Zugangsdaten und Transport. Sonst zeigt ein erfolgreicher zweiter Versuch nicht, welche Variable den Fehler beseitigt hat.
| Prüfschicht | Zu sichernder Nachweis | Entscheidungsfrage |
|---|---|---|
| RTSP | Methode, Status, Header, CSeq und Session | Hat der Server genau diese Operation akzeptiert? |
| SDP | control, Payload-Typ, Clock Rate und Codec | Beschreibt der Server den erwarteten Medientrack? |
| Transport | client_port, server_port oder interleaved | Verwenden beide Seiten denselben Kanal? |
| RTP | SSRC, Sequenz, Timestamp und Marker | Kommen Medieneinheiten in erklärbarer Reihenfolge an? |
| RTCP | Sender Report, CNAME und BYE | Sind Uhr, Identität und Sitzungsende nachvollziehbar? |
| Decoder | SPS/PPS/VPS und Packetization Mode | Lassen sich die angekommenen Nutzdaten initialisieren? |
Trennen Sie „keine Medien angekommen“ von „Medien angekommen, aber nicht decodierbar“. Fehlt RTP nach erfolgreichem SETUP und PLAY, prüfen Sie UDP-Pfad, NAT, Firewall und einen abweichenden Transport-Reply. RTP mit Sequenzlücken belegt Verlust oder Reordering. Eine lückenlose Folge ohne Bild verschiebt die Prüfung auf Payload-Typ, Clock Rate, Frame-Grenzen und H.264-/H.265-Parameter. Diese Grenze ist aussagekräftiger als eine allgemeine Player-Meldung.
Wie formuliert man eine zitierfähige Kurzantwort?
Nennen Sie in drei Sätzen die letzte erfolgreiche Operation, den ersten fehlgeschlagenen Beleg und den nächsten trennenden Test. Beispielstruktur: „DESCRIBE, SETUP und PLAY waren erfolgreich. An den angekündigten Client-Ports kam kein RTP an. Ein Test über TCP interleaved trennt UDP-Blockierung von einem falschen Medienpfad.“ Behaupten Sie keinen Kamera- oder Netzwerkdefekt ohne passende Antwort oder Paketbeleg.
Welche Angaben machen den Fehler reproduzierbar?
Sichern Sie OPTIONS, DESCRIBE, SETUP und PLAY samt SDP, Transport-Antwort und bereinigter Session-ID. Für Medien genügen zunächst SSRC, erste und letzte Sequenznummer, Clock Rate, Lückenanzahl und Aufnahmedauer. Vermerken Sie, ob VLC oder ein anderes VMS funktioniert. Das ist ein Differenztest, aber kein Beweis, dass der erfolgreiche Client jede Protokollgrenze korrekt behandelt.
Wann liegt der nächste Test auf Server- oder Clientseite?
Prüfen Sie den Server, wenn er eine Methode klar ablehnt, einen nicht vorhandenen control-Pfad liefert, das Transportangebot widersprüchlich beantwortet oder SSRC beziehungsweise Clock Rate ohne erklärten Übergang wechselt. Prüfen Sie den Client, wenn er einen alten Nonce wiederverwendet, Session-Header verliert, UDP anfordert ohne Ports zu öffnen oder jedes NAL-Ende als Access-Unit-Ende behandelt. Für Zwischenfehler bleiben Zeitstempel und Paketfolge unverzichtbar.
Wie wird der Bericht vor der Übergabe geprüft?
Wiederholen Sie den Test mit einer frischen Verbindung und vergleichen Sie beide Abläufe nur bis zur ersten Abweichung. Entfernen Sie Passwörter und vollständige Authorization-Werte. Verknüpfen Sie jede Aussage mit CSeq, Sequenznummer oder Timestamp. Der passende RTSP-Leitfaden erklärt angrenzende Schritte; RTSP Inspector dient als lokaler Arbeitsbereich zum Testen eines RTSP-Streams und zum Sammeln der Belege, ohne den Kamerastream zu einem öffentlichen Dienst hochzuladen.
<!-- rtsp-localized-evidence-foundation-v1:end --><!-- rtsp-localized-layer-verdicts-v1:start -->Von der Beobachtung zum überprüfbaren Schichturteil
Schreiben Sie bei „RTP-Sequenznummern-Wraparound-Debugging: 16-Bit-Rollover, falscher Paketverlust, Jitter-Spitzen und lange Kamerastreams“ zuerst die Beobachtung und erst danach die Interpretation. Eine Beobachtung kann eine zweite Person im Mitschnitt finden: RTSP-Status mit CSeq, SDP-Wert, Transport-Antwort, Lücke zwischen Sequenznummern, SSRC-Wechsel oder Abweichung zwischen RTP-Timestamp und RTCP Sender Report. „Der Server ist langsam“ oder „der Codec ist inkompatibel“ bleibt eine Hypothese, bis ein konkreter Beleg sie besser erklärt als die Alternativen.
Teilen Sie den Ablauf in Grenzen. Zuerst muss TCP geöffnet werden. Danach müssen OPTIONS oder DESCRIBE akzeptiert werden. SDP muss einen verwendbaren Track, Control-Pfad, Payload-Typ und eine Clock Rate beschreiben. SETUP braucht eine passende Transport-Antwort, PLAY eine gültige Session. Erst danach folgen RTP-Ankunft, Reihenfolge, Timing und Decoderbereitschaft. Stoppen Sie an der ersten Grenze ohne Erfolgsbeleg; spätere Pakete dürfen eine frühere Lücke nicht verdecken.
Halten Sie bei Vergleichstests Quelle und Zeitbereich möglichst konstant. UDP gegen TCP interleaved wird mit identischem Pfad und denselben Zugangsdaten geprüft. Main Stream gegen Sub Stream benötigt denselben Client und Transport. Beim Vergleich VLC gegen VMS dokumentieren Sie die tatsächlich gesendeten Methoden, Header und URLs. Ein Unterschied bei control URL, Authorization, Session oder Keepalive erklärt das Ergebnis oft besser als der Produktname.
Ausschlussmatrix
Beginnen Sie mit zwei Hypothesen. Wenn keine Medien ankommen, könnten UDP-Pakete blockiert sein oder der Server könnte an andere Ports senden. TCP interleaved prüft die erste Möglichkeit; der Vergleich von Transport-Angebot, Antwort, IP-Adressen und Ports prüft die zweite. Bei beschädigtem Bild trennen Sequenznummern RTP-Verlust von fehlender Codec-Initialisierung, während SPS/PPS/VPS vor dem ersten Frame die Parameterhypothese prüft.
Notieren Sie für jede Hypothese einen bestätigenden und einen widerlegenden Beleg. Eine Aussage, die kein Paket widerlegen kann, ist zu breit. „NAT verwirft UDP“ wird durch RTP am Client-Port widerlegt. „H.264-Parameter fehlen“ wird durch gültige SPS und PPS vor einem IDR widerlegt. Diese Form hält den Bericht priorisiert und verhindert eine ungeordnete Liste möglicher Ursachen.
Zeit korrekt einordnen
RTSP CSeq ordnet Steuerungstransaktionen, RTP Sequence ordnet Pakete, RTP Timestamp beschreibt Medienabtastzeit und die Capture-Uhr die Ankunft am Messpunkt. Setzen Sie diese Uhren nicht gleich. Schwankende Ankunftszeit beweist keinen Timestamp-Drift; ein Timestamp-Sprung beweist ohne Sequenzbeleg keinen Paketverlust. Für Audio-/Video-Synchronität verbinden RTCP Sender Reports die getrennten RTP-Uhren mit einer gemeinsamen Referenz.
Abnahmepaket
Schließen Sie die Untersuchung erst, wenn sich die Korrektur in einer neuen Verbindung mit einer dokumentierten Änderung wiederholen lässt. Der Bericht nennt Eingaben, letzte erfolgreiche Grenze, ersten fehlgeschlagenen Beleg, Änderung, Wiederholungsergebnis und offene Tests. Fügen Sie einen kleinen relevanten Transkriptausschnitt oder Paketstatistiken bei. Entfernen Sie Geheimnisse, aber behalten Sie CSeq, bereinigte Session, SSRC und Zeitbereich.
Mit der RTSP-Fehlersuche lässt sich der Ablauf erneut prüfen; RTSP-Inspector-Berichte übergeben die belegte Fehlergrenze an Kamera-, Netzwerk- oder VMS-Teams.
<!-- rtsp-localized-layer-verdicts-v1:end -->