jaeger_search_traces
Search Jaeger traces by service, operation, tags, time range, and duration. Filter to find specific issues like errors or slow performance.
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 |
|---|---|---|---|
| end | No | End time in microseconds since Unix epoch UTC (optional). If omitted and start is set, defaults to now. | |
| 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. | |
| limit | No | Maximum number of traces to return (1-1500, default 20). | |
| start | No | Start time in microseconds since Unix epoch UTC (optional). Example: 1713400000000000 for 2024-04-18 00:00:00 UTC. | |
| 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'. | |
| max_duration | No | Maximum trace duration filter (optional). Format: '100ms', '500ms'. Use to find fast traces or exclude outliers. | |
| min_duration | No | Minimum trace duration filter (optional). Format: '100ms', '1.5s', '2m'. Use to find slow traces. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| traces | Yes | ||
| service | Yes | ||
| returned | Yes | ||
| operation | Yes | ||
| truncated | Yes |