Capture index (ring-buffer files in time order)
capture_indexIndex a directory of capture files in time order without decoding packets: get per-file time spans, packet and byte counts, gaps, overlaps, and which files cover an incident window.
Instructions
Index a directory of capture files (a ring buffer, a day of rotated files) in time
order without decoding a packet: per file the first and last packet time, duration,
packets, bytes, interfaces and link type, the hole or overlap against the previous
file, and with start/end (same forms as on every tool) covers_window: which files
to open for an incident window. summary gives the span, totals, holes (gaps longer
than min_gap_s seconds between files, default 1), overlaps, ordering (whether
name order is time order: a wrapped ring or renamed files break it) and for a window
window_files and window_covered.
More detail: resource schema://tools/capture_index.
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": "capture_index"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Window end, same forms as start | |
| path | Yes | Absolute path of a directory of capture files | |
| start | No | Window start: ISO 8601, epoch s, +Ns from the first file, -Ns from the last | |
| 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 | |
| min_gap_s | No | Shortest gap between files reported as a hole, seconds |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | ||
| count | No | ||
| error | No | ||
| files | No | rows with keys: path, name, first, last, first_epoch, last_epoch, duration_s, packets, bytes, interfaces, file_type, link_type, covers_window, gap_before_s, overlap_before_s, error, message | |
| issues | No | ||
| offset | No | ||
| window | No | ||
| dropped | No | ||
| summary | No | ||
| has_more | No | ||
| returned | No | ||
| files_found | No | ||
| next_offset | No | ||
| total_found | No | ||
| files_indexed | No | ||
| total_matched | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| files_not_indexed | No | ||
| total_is_lower_bound | No |