GTPv2-C sessions
gtp_sessionsPairs GTPv2-C requests with responses by sequence number and peer, then reports session messages, subscriber IDs, APN, TEIDs, cause codes and latency, filterable by IMSI, APN or TEID.
Instructions
Pair GTPv2-C requests with responses by sequence number and peer pair. A response
sent by the request's target towards another address (a NAT or proxy boundary) is
paired too and its path is given as response_path. Reports
message names (Create Session, Modify Bearer, Delete Session, Echo, ...), IMSI, MSISDN,
APN, F-TEIDs with interface names, cause code and name, allocated UE address (PAA),
round-trip ms and unanswered: true. Narrow with imsi (digits), apn (case-insensitive; a network
identifier such as internet also matches internet.mnc001.mcc001.gprs) or teid (decimal or 0x hex; matches the header TEID or any F-TEID):
the matching requests select sequence numbers, then both halves of each transaction
are fetched so responses are kept. filter is a raw display filter ANDed with gtpv2,
e.g. gtpv2.message_type == 32; it applies literally to each packet.
More detail: resource schema://tools/gtp_sessions.
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": "gtp_sessions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| apn | No | APN (DNN) name, such as internet | |
| end | No | Same forms as start | |
| imsi | No | IMSI, 6 to 15 digits | |
| path | Yes | Capture file (absolute, in an allowed dir) or open_capture handle | |
| teid | No | GTP TEID: an int or hex string such as 0xc001 | |
| 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 | ||
| offset | No | ||
| window | No | ||
| dropped | No | ||
| summary | No | keys: by_message, unanswered, failed, legs_without_response, legs_near_capture_end, unanswered_near_capture_end, duplicates | |
| has_more | No | ||
| returned | No | ||
| selection | No | ||
| next_offset | No | ||
| total_found | No | ||
| transactions | No | rows with keys: time, src, dst, request_frame, answer_frame, rtt_ms, unanswered, unmatched_answer, leg_without_response, near_capture_end, duplicate_of_frame, chain, note, message, response, seq, teid, imsi, msisdn, apn, rat_type, ebi, request_fteids, cause, cause_name, accepted, paa, response_fteids, response_path | |
| total_matched | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| total_is_lower_bound | No |