488 that you cannot explain, DTMF that never
registers, or audio that flows one way. The telephony leg speaks SIP for
signalling and RTP for media. The system captures both for you. Thus you
rarely need tcpdump at all.
Signalling is already captured
The system captures every SIP message on every one of your calls automatically. It keys the messages bysid and keeps them in a searchable
store. You reach the store from the console at agent.clutchcall.dev. You do
not run a capture agent, mirror a port, or schedule anything. The SIP gateway
mirrors each message when it sends or receives it. Capture uses HEP (the
Homer Encapsulation Protocol). This is the same open format that Homer and
other SIP-capture stacks speak. Thus the data is portable. On a self-hosted
deployment, you can point your own HEP collector at the same feed.
Capture is tenant-scoped. You only see calls that belong to your
workspace. The system filters traces by your tenant and your DID ranges before
they reach you. Thus a shared managed-cloud plane never leaks another tenant’s
signalling.
- The full SIP transaction: every
INVITE, provisional,200,ACK,BYE, re-INVITE, andREFER, with wire timestamps. - The SDP offered and answered on each leg (codecs, media IP/port, DTMF mode). Thus you can see codec and media-path negotiation without any manual decoding.
- Both B2BUA legs, lined up under the one
sid: the carrier-facing dialog and the agent/endpoint-facing dialog.
Reading a ladder diagram
The capture explorer shows a SIP transaction as a ladder (a flow diagram). Each participant is a vertical line. Time runs top to bottom. Every arrow is one SIP message, annotated with its method or status code and timestamp. For an inbound call to an AI agent it reads like this:- A gap where a message should be. No
ACKafter the200 OK? The dialog never confirmed. No183/200at all after theINVITE? Your response never reached the caller (loss, an ACL, or an unreachable route). - The same message repeated at ~500 ms, 1 s, 2 s intervals. That is SIP retransmission. The sender gets no reply. Follow the arrows to see which hop is silent.
- A
4xx/5xx/6xxinstead of a200. The code and its reason phrase name the rejection. Expand the message to read the headers. - The SDP on each side. Open the
INVITEand the answering response. Compare them=audiolines. A codec list with nothing in common will cause a488. - Timing. Wide gaps between arrows show where the latency lives. Use the ladder timestamps as your first cut before the latency breakdown.
Common telephony packet symptoms
| Symptom | Likely cause | What the ladder / pcap shows — and the fix |
|---|---|---|
The call rings, then the carrier sends an unsolicited BYE | Ringing was signalled with a bare 180 and no media description | The ladder shows 180 Ringing without a 183 Session Progress (SDP) after it. The gateway answers early media with 183 + SDP. If you front your own carrier/SBC, make it send 183 with SDP, not a media-less 180. |
488 Not Acceptable Here on answer | No codec in common between the offer and the answer | Compare the two m=audio SDP lines in the ladder. Phone legs must offer G.711 (PCMU/PCMA). Fix the trunk’s offered codecs. |
A 401/407 challenge loop, the call never sets up | Digest auth fails on a registered endpoint or trunk | The ladder shows repeated INVITE → 407 → INVITE. Check the endpoint/trunk credentials again. A mismatched secret loops here forever. |
Repeated INVITEs, no response at all | Packet loss, or the ACL blocks the source IP | A silent hop in the ladder. Check that the sender’s source IP is allowed and that the route is reachable. See SIP trunk troubleshooting. |
| The call connects, but audio flows only one way | RTP does not reach one side: a NAT/SDP media address problem, or an asymmetric flow | Signalling looks clean, so this is a media problem. Check the SDP c=/m= media address that the far end was told to send to. Then drop to a pcap on the media path (below). See one-way audio. |
| DTMF digits never register | An RFC 2833 telephone-event payload-type mismatch, or the far end sends in-band | The ladder’s SDP shows the negotiated telephone-event PT. Only an RTP pcap shows whether the digits actually arrive. Check that both sides agree on RFC 2833 and the payload type. |
When to drop to a pcap
Built-in capture records signalling (and RTCP/QoS summaries). It does not record the raw RTP audio payload. Take a packet capture when the question is about the media stream itself, and the ladder plus MOS/jitter/loss did not answer it:- One-way or no audio where signalling is clean. You must see whether RTP actually leaves one side and arrives at the other, and on which address.
- DTMF (RFC 2833) that is not detected. Inspect the
telephone-eventpackets and their payload type on the wire. - Codec / payload-type drift. Check that the RTP payload type on the wire matches what the SDP negotiated.
- Loss or jitter patterns that the E-model MOS score flags but does not localize. Packet arrival timing tells you where the gaps are.
1
Capture on a box you actually own
Take the pcap at your SBC or carrier edge, or on a self-hosted engine
host that you control. Do not take it on the managed-cloud media plane.
Filter to the call’s RTP by media IP/port (from the SDP in the ladder)
plus the SIP signalling port. For example:
tcpdump -i <if> -w call.pcap 'udp and (host <media-ip>)'.2
Open it as a VoIP flow
Load the pcap in Wireshark. Use Telephony → VoIP Calls to
reconstruct the dialog. Then use RTP → Stream Analysis to
see per-packet loss, jitter, and sequence gaps. Wireshark builds its own
ladder from the packets. Thus you can line it up against the captured SIP
trace.
3
Match it back to the call
Correlate on the SIP
Call-ID (and your sid) so that the pcap and the
built-in capture describe the same call. The media IP/port to filter on is
the one in the SDP answer that you already read in the ladder.Related
SIP / RTP debugging
The workflow to isolate a telephony-leg fault, start to finish.
Call traces
The assembled per-call event timeline, keyed by sid.
MOS, jitter & loss
The media-quality numbers that tell you when to open a pcap.
Call lifecycle
What each SIP message on the ladder means, and where the agent attaches.
One-way audio
The classic media-path fault that a pcap resolves.
SIP trunk issues
ACLs, auth loops, and unreachable routes at the trunk edge.

