Skip to content

Plan distribution over time graph docs#23103

Open
bsanchez-the-roach wants to merge 3 commits intomainfrom
DOC-15932
Open

Plan distribution over time graph docs#23103
bsanchez-the-roach wants to merge 3 commits intomainfrom
DOC-15932

Conversation

@bsanchez-the-roach
Copy link
Copy Markdown
Contributor

@bsanchez-the-roach bsanchez-the-roach commented Mar 10, 2026

DOC-15932

Seems like an innocuous ticket but it required a bunch of changes to existing screenshots, and is being backported to older versions, hence all the file changes.

Please verify that the versions here {24.3, 25.2, 25.3, 25.4, 26.1, 26.2} are correct.

Changes to the troubleshooting-query-plan-regressions.md file are only for {25.4, 26.1, 26.2} because older versions don't have that page.

@netlify
Copy link
Copy Markdown

netlify bot commented Mar 10, 2026

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit a10f875
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/69b320965c503200082a8caa

@netlify
Copy link
Copy Markdown

netlify bot commented Mar 10, 2026

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit a10f875
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/69b3209635e9e50008c2c350

@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 10, 2026

Cross-Version Link Check Passed

All cross-version link issues have been resolved. Good job!

@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 10, 2026

Files changed:

@netlify
Copy link
Copy Markdown

netlify bot commented Mar 10, 2026

Netlify Preview

Name Link
🔨 Latest commit a10f875
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/69b320968643d60009df797b
😎 Deploy Preview https://deploy-preview-23103--cockroachdb-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.


<img src="{{ 'images/v26.2/ui_plan_table.png' | relative_url }}" alt="Plan table" style="border:1px solid #eee;max-width:100%" />

#### Plan Distribution Over Time
Copy link
Copy Markdown
Contributor Author

@bsanchez-the-roach bsanchez-the-roach Mar 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please verify that the versions that will receive this change {24.3, 25.2, 25.3, 25.4, 26.1, 26.2} are correct.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jasonlmfong, can you confirm here please?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This was not backported so it is only available on 26.2 onwards


#### Plan Distribution Over Time

The **Plan Distribution Over Time** graph displays the execution counts for every query plan used within the selected time interval. Each bar in the graph displays the total statement execution count for a given fifteen minute window within the selected interval. If multiple query plans were used in that window, the bar will be stacked, and each query plan will be represented by a different color. The key below the graph indicates the plan gist associated with each color. More information about these query plans can be found in the [plan table](#plan-table).
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This detail here: "for a given fifteen minute window", I don't know that it's correct. Can someone tell me what determines the interval of time by which statement executions are grouped together into a single bar on the graph?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It should be an hour by default based on the cluster setting. We shouldn't have don't anything differently on the UI for this graph and others. @jasonlmfong, please correct me here.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure why you saw 15 minutes...perhaps it was the in-memory stats? 🤔 @jasonlmfong

Copy link
Copy Markdown
Member

@jasonlmfong jasonlmfong Mar 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

they are grouped into aggregated timestamps which are by default rounded down to the closest hour
these are able to be affected by the cluster setting sql.stats.aggregation.interval, which affects all things related to statement/transactions stats, which might be why yours was showing 15 minutes?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants