Find identifier across captures
find_identifierLocate capture files that mention an IMSI, MSISDN, IP address, SIP Call-ID, or Diameter Session-Id; returns hit counts, timestamps, and protocol breakdowns to pick the right file for pcap_info.
Instructions
Find which capture files mention an identifier. path is one capture or a
directory inside the allowed roots (its .pcap/.pcapng/.cap files are scanned, not
subdirectories). identifier is an IMSI, MSISDN, IPv4/IPv6 address, SIP Call-ID or
Diameter Session-Id; kind is auto, imsi, msisdn, ip, call_id or session_id (auto
searches digits as both IMSI and MSISDN). Returns one row per file with hits: hit
count, first and last timestamp and a per-protocol breakdown, sorted by hits. At most
max_files files are opened (capped by the server), each under the usual packet,
size and time limits, and the whole call shares one time budget; files that could
not be read are listed under errors. Use it to pick the file before pcap_info.
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>",
"identifier": "<identifier>"
},
"name": "find_identifier"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Same forms as start | |
| kind | No | auto, imsi, msisdn, ip, call_id, session_id | auto |
| path | Yes | Absolute path of a capture file or a directory of captures | |
| start | No | ISO 8601, epoch s, +Ns from start, -Ns from end | |
| offset | No | Rows to skip (next_offset) | |
| redact | No | Replace subscriber identifiers in this result with tokens; ids+ips hides every IP too | off |
| max_files | No | Most files read in this call | |
| identifier | Yes | IMSI, MSISDN, IP, Call-ID or Diameter Session-Id |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | ||
| note | No | ||
| count | No | ||
| error | No | ||
| files | No | rows with keys: path, hits, first, last, protocols, truncated, truncated_reason, first_frame, last_frame | |
| errors | No | rows with keys: path, error, message | |
| offset | No | ||
| window | No | ||
| dropped | No | ||
| has_more | No | ||
| returned | No | ||
| identifier | No | ||
| total_hits | No | ||
| files_found | No | ||
| next_offset | No | ||
| total_found | No | ||
| files_scanned | No | ||
| total_matched | No | ||
| display_filter | No | ||
| files_with_hits | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| files_not_scanned | No | ||
| partially_scanned | No | ||
| files_outside_window | No | ||
| total_is_lower_bound | No | ||
| subdirectories_with_captures | No |