Expert info (warnings, malformed packets)
expert_infoRetrieve tshark expert warnings, errors and malformed-packet flags grouped by severity and protocol to catch decode problems before trusting protocol analysis.
Instructions
tshark's own expert information (-z expert): the warnings, errors and
malformed-packet flags its dissectors raised while decoding, grouped by severity,
group (Malformed, Undecoded, Sequence, Protocol, Checksum, ...), protocol and summary,
with the count, the first frame and up to five sample frames of each (an item tshark
reports only to its statistics, such as TCP "exceeds MSS", has no frames). severity is
the lowest level kept: error, warn (default), note or chat. filter is a display
filter that restricts which packets are examined, e.g. diameter or
sctp.port == 3868. summary gives counts by severity and protocol and the number
of malformed frames. Use it to catch decode problems (a malformed Diameter AVP, an
unknown vendor, a GTP IE tshark could not parse) before trusting the protocol
tools, and for the TCP sequence problems tshark already flags.
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": "expert_info"
}
}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 | |
| 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) | |
| severity | No | Lowest severity listed: chat, note, warn, error | warn |
| max_output_kb | No | Lower output cap, KB |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| error | No | ||
| items | No | rows with keys: severity, group, protocol, summary, count, first_frame, frames, frame_count | |
| offset | No | ||
| window | No | ||
| dropped | No | ||
| summary | No | keys: by_severity, by_protocol, malformed_frames, malformed_first_frames | |
| has_more | No | ||
| returned | No | ||
| severity | No | ||
| next_offset | No | ||
| total_found | No | ||
| total_matched | No | ||
| display_filter | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| total_is_lower_bound | No |