DNS transactions
dns_transactionsAnalyze DNS exchanges by pairing queries with responses to reveal unanswered queries, retransmissions, and server latency in packet captures.
Instructions
DNS queries paired with their responses (by transport, client and server address
and port, DNS id and question name), including the queries that never got one,
which tshark's own dns.time cannot show. Each transaction gives name, type (A,
AAAA, NAPTR, SRV, HTTPS, ...), client, server, rcode and its name (NOERROR,
NXDOMAIN, SERVFAIL, REFUSED, ...), answers and addresses, round-trip ms,
unanswered (with near_capture_end and a note when the capture on its interface
stops before the answer was due: the resolver's slowest answer plus 0.2 s, at most 2 s;
counted in summary.unanswered_near_capture_end),
retransmissions (the same query resent with the same id and port), retry_of
(a new query for a name whose last query was unanswered or failed),
truncated_tc and tcp_fallback_frame (a TC answer followed by the same query
over TCP). servers gives per resolver queries, answered, unanswered share,
rcodes and latency min/p50/p90/p99/max; names lists the names that failed, were
retried or were slow (over 1 s); issues says it in plain words. Copies of one
packet (a capture on several interfaces or GTP legs) are counted once. DNS inside
GTP-U tunnels is read from the inner packet. name keeps that name and the names
under it (case-insensitive); filter is ANDed with dns. Transactions with a
problem come first, then the rest in capture order.
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": "dns_transactions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Same forms as start | |
| name | No | Query name, or the end of it | |
| path | Yes | Capture file (absolute, in an allowed dir) or open_capture handle | |
| 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 |
| columns | No | Row keys to keep (frame keys stay) | |
| max_output_kb | No | Lower output cap, KB |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| error | No | ||
| names | No | rows with keys: name, queries, unanswered, failed, rcodes, retries, slow, types, servers | |
| issues | No | ||
| offset | No | ||
| window | No | ||
| dropped | No | ||
| servers | No | rows with keys: server, queries, answered, unanswered, unanswered_share, rcodes, retransmissions, transports, clients, icmp_errors, rtt_ms | |
| summary | No | ||
| has_more | No | ||
| returned | No | ||
| next_offset | No | ||
| total_found | No | ||
| transactions | No | rows with keys: frame, time, client, server, transport, id, name, type, response_frame, rcode, rcode_name, answers, addresses, cnames, rtt_ms, unanswered, near_capture_end, note, retransmissions, retry_of, truncated_tc, tcp_fallback_frame, fallback_from_udp, duplicate_responses | |
| total_matched | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| total_is_lower_bound | No |