jaeger_search_traces
Search distributed tracing data in Jaeger using filters for service, operation, tags, duration, and time range to identify performance issues or errors.
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 |