HTTP transactions
http_transactionsPair HTTP/1.x requests with responses and follow HTTP/2 or gRPC streams to find slow endpoints, failing status codes, and response sizes per host, method, and path.
Instructions
Which HTTP endpoints are slow or failing, what status codes came back, how
big were the responses, what did gRPC return? HTTP/1.x requests paired with their
responses by tshark (pipelining included) and HTTP/2 / gRPC followed per stream.
view="requests" (default) gives each request with status, sizes, response_ms and gRPC
status; view="endpoints" aggregates per host, method and path; summary names issues.
Filters: host (the name and its subdomains), path_prefix, method, status (404 or a
class such as "5xx"), min_ms (response_ms at least); filter is a display filter ANDed
with http || http2. No decryption: HTTPS needs TLS keys tshark already has.
More detail: resource schema://tools/http_transactions.
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": "http_transactions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Same forms as start | |
| host | No | Host name, or part of it | |
| path | Yes | Capture file (absolute, in an allowed dir) or open_capture handle | |
| view | No | requests (one row each) or endpoints (per method, host and path) | requests |
| limit | No | Most rows per page | |
| start | No | ISO 8601, epoch s, +Ns from start, -Ns from end | |
| filter | No | Extra display filter, ANDed | |
| method | No | HTTP method (GET, POST, ...) | |
| min_ms | No | Keep requests slower than this many ms | |
| 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 |
| status | No | Status code or class: 404, 5xx, 4xx | |
| columns | No | Row keys to keep (frame keys stay) | |
| path_prefix | No | Request path prefix, such as /api | |
| max_output_kb | No | Lower output cap, KB |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | ||
| count | No | ||
| error | No | ||
| offset | No | ||
| window | No | ||
| dropped | No | ||
| summary | No | ||
| has_more | No | ||
| requests | No | rows with keys: frame, response_frame, stream, h2_stream, client, server, version, method, host, uri, query, status, reason, content_type, request_bytes, response_bytes, response_ms, ttfb_ms, response_decoded_from, paired_by, grpc, grpc_status, grpc_status_name, stream_reset_by, reset_error, unanswered, near_capture_end | |
| returned | No | ||
| endpoints | No | rows with keys: host, method, uri, count, status, unanswered, response_ms, ttfb_ms, response_bytes, grpc_status, servers, slowest_frame, first_frame | |
| next_offset | No | ||
| total_found | No | ||
| total_matched | No | ||
| display_filter | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| undissected_http | No | ||
| total_is_lower_bound | No |