diff --git a/changelog/24.0/24.0.0/summary.md b/changelog/24.0/24.0.0/summary.md index c3118314555..bf7a89b9959 100644 --- a/changelog/24.0/24.0.0/summary.md +++ b/changelog/24.0/24.0.0/summary.md @@ -14,6 +14,7 @@ - [JSON_EXTRACT now supports dynamic path arguments](#query-serving-json-extract-dynamic-args) - **[VTTablet](#minor-changes-vttablet)** - [New Experimental flag `--init-tablet-type-lookup`](#vttablet-init-tablet-type-lookup) + - [QueryThrottler Observability Metrics](#vttablet-querythrottler-metrics) - [New `in_order_completion_pending_count` field in OnlineDDL outputs](#vttablet-onlineddl-in-order-completion-count) - [Tablet Shutdown Tracking and Connection Validation](#vttablet-tablet-shutdown-validation) - **[VTOrc](#minor-changes-vtorc)** @@ -75,6 +76,21 @@ When enabled, the tablet uses its alias to look up the tablet type from the exis **Note**: Vitess Operator–managed deployments generally do not keep tablet records in the topo between restarts, so this feature will not take effect in those environments. +#### QueryThrottler Observability Metrics + +VTTablet now exposes new metrics to track QueryThrottler behavior. + +Four new metrics have been added: + +- **QueryThrottlerRequests**: Total number of requests evaluated by the query throttler +- **QueryThrottlerThrottled**: Number of requests that were throttled +- **QueryThrottlerTotalLatencyNs**: Total time each request takes in query throttling, including evaluation, metric checks, and other overhead (nanoseconds) +- **QueryThrottlerEvaluateLatencyNs**: Time taken to make the throttling decision (nanoseconds) + +All metrics include labels for `Strategy`, `Workload`, and `Priority`. The `QueryThrottlerThrottled` metric has additional labels for `MetricName`, `MetricValue`, and `DryRun` to identify which metric triggered the throttling and whether it occurred in dry-run mode. + +These metrics help monitor throttling patterns, identify which workloads are throttled, measure performance overhead, and validate behavior in dry-run mode before configuration changes. + #### New `in_order_completion_pending_count` field in OnlineDDL outputs OnlineDDL migration outputs now include a new `in_order_completion_pending_count` field. When using the `--in-order-completion` flag, this field shows how many migrations must complete before the current migration. The field is visible in `SHOW vitess_migrations` queries and `vtctldclient OnlineDDL show` outputs.