Search Traces
search_tracesSearch Sentry traces and spans to analyze request, endpoint, HTTP, DB, and AI/LLM latency, throughput, and slowness over time, and find spans linked to matching logs, metrics, or spans.
Instructions
Search Sentry traces and spans: requests, endpoints, HTTP and DB calls, and AI/LLM calls, for latency, throughput, and slowness over time. Also finds spans whose trace has a matching log, metric, or span. Returns individual events, counts, and aggregates; for grouped issue lists, use search_issues. For exceptions, use search_errors; for log lines, use search_logs.
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": "search_traces"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort field, - prefix for descending, such as -count() for aggregates. Omit unless you need a specific order. | |
| fresh | No | Bypass cached reads. | |
| limit | No | Maximum number of results to return. | |
| query | No | What to find, in natural language or Sentry search syntax. Put environment, release, and other filters here. | |
| fields | No | Columns to return; omit unless you need exact columns. Include aggregates such as count() or avg() for statistics. | |
| period | No | Relative time window, e.g. `30m`, `24h`, `7d`, `90d`. | |
| regionUrl | No | ||
| projectSlug | No | ||
| organizationSlug | No | The organization slug, from `find_organizations`. In `org/project` notation, the part before the slash. | |
| includeExplanation | No | Explain how the query was translated or repaired. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Opens these results in Sentry. | |
| notes | Yes | ||
| query | Yes | ||
| results | Yes | ||
| resultType | Yes | ||
| timeSeries | Yes | ||
| explanation | Yes | ||
| executedSearch | Yes | ||
| presentationHint | Yes | ||
| suggestedActions | Yes |