RTP streams and call quality
rtp_streamsExtract RTP streams and quality metrics linked to SIP calls, including loss, jitter, RTCP reports, and MOS estimates; use heuristic decoding when SIP/SDP is missing.
Instructions
RTP streams with quality figures, linked to their SIP call. Per stream (SSRC plus
source and destination address:port): the Call-ID whose SDP advertised the
destination (or source) address and port (linked_by), payload type and codec
from the SDP rtpmap (or the static payload-type table), packets, expected, lost and
lost_pct, duplicates, sequence_errors, out_of_order, max/mean interarrival delta,
RFC 3550 max/mean jitter in ms, duration, the reverse stream's SSRC or one_way,
RTCP reception reports about the stream (fraction lost, cumulative lost, jitter,
round trip where the LSR matches a captured SR) and mos_estimate: a simplified
G.107 E-model score from loss, jitter, delay and codec. It is an ESTIMATE from
network metrics only (method and inputs are returned), never a measured MOS.
rtcp_xr lists RTCP XR VoIP metrics the endpoints reported themselves.
call_id keeps the streams of one call (RTP to or from its SDP addresses is read,
so a NATed source is still found); ssrc (decimal or 0x hex) keeps one stream.
tshark decodes RTP from the SDP in the capture; for a capture without the SIP
signalling set heuristic: true (heuristic RTP/RTCP over UDP, may misread other
UDP traffic as RTP). filter is ANDed with the RTP filter.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "rtp_streams"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Same forms as start | |
| path | Yes | Capture file (absolute, in an allowed dir) or open_capture handle | |
| ssrc | No | RTP SSRC: decimal or 0x hex | |
| limit | No | Most rows per page | |
| start | No | ISO 8601, epoch s, +Ns from start, -Ns from end | |
| filter | No | Extra display filter, ANDed | |
| offset | No | Rows to skip (next_offset) | |
| output | No | summary: all but rows, plus 3 rows (<8 KB) | rows |
| redact | No | Replace subscriber identifiers in this result with tokens; ids+ips hides every IP too | off |
| call_id | No | SIP Call-ID of the call | |
| columns | No | Row keys to keep (frame keys stay) | |
| heuristic | No | Also decode RTP without SIP/SDP (heuristic RTP over UDP) | |
| max_output_kb | No | Lower output cap, KB |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| calls | No | rows with keys: call_id, sdp | |
| count | No | ||
| error | No | ||
| notes | No | ||
| offset | No | ||
| window | No | ||
| dropped | No | ||
| rtcp_xr | No | rows with keys: frame, time, reporter_ssrc, r_factor, mos_lq, mos_cq, round_trip_ms | |
| streams | No | rows with keys: ssrc, src, dst, call_id, linked_by, sdp_frame, payload_type, codec, codec_source, clock_rate, payload_types, first_time, last_time, duration_s, first_frame, last_frame, packets, expected, lost, lost_pct, duplicates, sequence_errors, out_of_order, max_delta_ms, mean_delta_ms, max_jitter_ms, mean_jitter_ms, telephone_event_packets, marker_packets, rtcp, mos_estimate, reverse_ssrc, one_way, expected_one_way, issues | |
| summary | No | ||
| has_more | No | ||
| returned | No | ||
| mos_method | No | ||
| next_offset | No | ||
| total_found | No | ||
| total_matched | No | ||
| display_filter | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| total_is_lower_bound | No |