jaeger_search_traces
Search Jaeger traces by service, operation, tags, and duration filters. Returns a list of trace summaries for further inspection.
Instructions
Search Jaeger traces with rich filters.
Wraps GET /api/traces. Returns a list of trace summaries — use
jaeger_get_trace to drill into a specific trace for span details.
The tags parameter accepts a JSON string so the LLM can construct
arbitrary tag filters. Durations (min_duration/max_duration) are
forwarded as-is to Jaeger (e.g. '100ms', '1.5s').
Examples:
- Use when: "Show me recent 500 errors in order-service"
→ service='order-service', tags='{"http.status_code":"500"}'.
- Use when: "Find slow traces (>1s) for checkout endpoint"
→ service='checkout', operation='POST /checkout',
min_duration='1s'.
- Use when: "Give me the last 5 traces in the last hour"
→ limit=5, set start to (now - 3600s) in microseconds.
- Don't use when: You already have a traceID and want full details
(call jaeger_get_trace directly — one fewer round trip).
- Don't use when: You want service dependency topology
(call jaeger_get_dependencies).
Returns:
dict with service / operation / returned / truncated /
traces (list of :class:TraceSummary).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| service | Yes | Service name to search traces for (required). Use jaeger_list_services to discover valid names. | |
| operation | No | Operation name filter (optional). Use jaeger_list_operations to discover valid names. Example: 'GET /api/orders' or 'grpc.health.v1.Health/Check'. | |
| tags | No | JSON string of tag key-value pairs to filter by (optional). Example: '{"http.status_code":"500"}' to find 5xx errors, or '{"error":"true"}' for any error spans. | |
| start | No | Start time in microseconds since Unix epoch UTC (optional). Example: 1713400000000000 for 2024-04-18 00:00:00 UTC. | |
| end | No | End time in microseconds since Unix epoch UTC (optional). If omitted and start is set, defaults to now. | |
| min_duration | No | Minimum trace duration filter (optional). Format: '100ms', '1.5s', '2m'. Use to find slow traces. | |
| max_duration | No | Maximum trace duration filter (optional). Format: '100ms', '500ms'. Use to find fast traces or exclude outliers. | |
| limit | No | Maximum number of traces to return (1-1500, default 20). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| service | Yes | ||
| operation | Yes | ||
| returned | Yes | ||
| truncated | Yes | ||
| traces | Yes |