Document SQL Server queue length monitoring interval options#8374
Draft
ramonsmits wants to merge 1 commit into
Draft
Document SQL Server queue length monitoring interval options#8374ramonsmits wants to merge 1 commit into
ramonsmits wants to merge 1 commit into
Conversation
Adds QueueLengthQueryDelayInterval and QueueLengthQueryMaxDelayInterval (base cadence + adaptive idle back-off) introduced by Particular/ServiceControl#5555.
mauroservienti
approved these changes
Jun 26, 2026
| The following options tune queue length monitoring (the data behind the throughput graphs) and are available in versions <!-- TODO: confirm first shipping ServiceControl version --> and above: | ||
|
|
||
| * `QueueLengthQueryDelayInterval=<value_in_milliseconds>` - The base interval between queue length refresh queries. The default value is 1000 ms, matching the finest monitoring resolution (one data point per second). This is the cadence used whenever any monitored queue has messages. | ||
| * `QueueLengthQueryMaxDelayInterval=<value_in_milliseconds>` - The upper bound for the adaptive back-off. While *every* monitored queue is empty the interval ramps from `QueueLengthQueryDelayInterval` up to this value, reducing query load on an idle system; it returns to the base interval as soon as any queue has work. The default value is 10000 ms. Set it equal to `QueueLengthQueryDelayInterval` to disable back-off and poll at a constant cadence. |
Member
There was a problem hiding this comment.
Suggested change
| * `QueueLengthQueryMaxDelayInterval=<value_in_milliseconds>` - The upper bound for the adaptive back-off. While *every* monitored queue is empty the interval ramps from `QueueLengthQueryDelayInterval` up to this value, reducing query load on an idle system; it returns to the base interval as soon as any queue has work. The default value is 10000 ms. Set it equal to `QueueLengthQueryDelayInterval` to disable back-off and poll at a constant cadence. | |
| * `QueueLengthQueryMaxDelayInterval=<value_in_milliseconds>` - The upper bound for the adaptive back-off. While *every* monitored queue is empty, the interval ramps from `QueueLengthQueryDelayInterval` up to this value, reducing query load on an idle system; it returns to the base interval as soon as any queue has messages. The default value is 10000 ms. Set it equal to `QueueLengthQueryDelayInterval` to disable back-off and poll at a constant cadence. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Draft. Documents the two new SQL Server transport connection-string options introduced in Particular/ServiceControl#5555:
QueueLengthQueryDelayInterval— base poll cadence for queue length monitoring (default 1000 ms).QueueLengthQueryMaxDelayInterval— ceiling for the adaptive back-off while every monitored queue is idle (default 10000 ms; set equal to the base to disable).Added to the SQL section of
servicecontrol/transports.md, mirroring how the Azure Service Bus transport already documentsQueueLengthQueryDelayInterval.