traces_search
Search distributed traces across observability backends to find requests by service, operation, tags, time window, duration, or error state. Narrow results with provider-native queries and filters.
Instructions
Search distributed traces. Backend: Jaeger. Param semantics vary by provider: service works for jaeger/zipkin/skywalking (skywalking expects a service id); query is a provider-native raw query (Tempo TraceQL).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "traces_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | JSON-encoded tag filter (Jaeger only) | |
| limit | No | Max traces to return | |
| query | No | Provider-native raw query (Tempo TraceQL) | |
| state | No | Trace state filter (SkyWalking) | |
| service | No | Service name (jaeger/zipkin) or service id (skywalking) | |
| lookback | No | Time window (e.g. "1h", "30m", "2d") | 1h |
| operation | No | Operation/span/endpoint name filter | |
| max_duration | No | Maximum duration (Jaeger only) | |
| min_duration | No | Minimum duration (e.g. "500ms", "1s") | |
| annotation_query | No | Zipkin annotation query (e.g. "http.status_code=500 and error") |