jaeger_compare_windows
Detect performance changes by comparing trace aggregates between two time windows for a service, showing per-operation latency and error rate differences.
Instructions
Compare aggregate trace behavior between two time periods for a service.
Fetches traces from both time windows, aggregates span statistics per operation, then compares the aggregate behavior to detect performance changes.
Examples: - Use when: "Did our latest deployment affect performance?" → compare pre-deploy and post-deploy time windows for the service. - Use when: "Which operations got slower after the database upgrade?" → check the comparison_p95_us and p95_delta_pct columns for increases. - Use when: "Are we seeing new error patterns?" → look for operations with increased error_rate_delta. - Use when: "Did we add or remove any API endpoints?" → check added_count and removed_count in the summary. - Don't use when: You want to compare two specific traces (use jaeger_compare_traces instead). - Don't use when: You want full span detail for a single trace (use jaeger_get_trace instead).
Returns: WindowComparisonOutput with per-operation diffs and summary statistics.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum traces to fetch per window (default 100). | |
| service | Yes | Service name to compare across time windows. | |
| operation | No | Optional operation name filter. | |
| baseline_end | Yes | Baseline window end time (Unix timestamp in microseconds). | |
| baseline_start | Yes | Baseline window start time (Unix timestamp in microseconds). | |
| comparison_end | Yes | Comparison window end time (Unix timestamp in microseconds). | |
| comparison_start | Yes | Comparison window start time (Unix timestamp in microseconds). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| service | Yes | ||
| operations | Yes | ||
| added_count | Yes | ||
| baseline_end | Yes | ||
| faster_count | Yes | ||
| slower_count | Yes | ||
| removed_count | Yes | ||
| baseline_start | Yes | ||
| comparison_end | Yes | ||
| comparison_start | Yes | ||
| total_operations | Yes | ||
| overall_deviation_score | Yes |