Skip to content

Add Active Session History docs#23158

Open
bsanchez-the-roach wants to merge 7 commits intomainfrom
DOC-16498
Open

Add Active Session History docs#23158
bsanchez-the-roach wants to merge 7 commits intomainfrom
DOC-16498

Conversation

@bsanchez-the-roach
Copy link
Copy Markdown
Contributor

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 2, 2026

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

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

@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 2, 2026

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 2, 2026

Deploy Preview for cockroachdb-api-docs canceled.

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

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 2, 2026

Netlify Preview

Name Link
🔨 Latest commit 0d342da
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/69e29a24c7ef3d00083c23e5
😎 Deploy Preview https://deploy-preview-23158--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.

@github-actions
Copy link
Copy Markdown

Diagram Anchor Check: Passed

All sql-grammar.html#anchor references in SQL diagram files resolve correctly against stmt_block.html.

Copy link
Copy Markdown

@kevin-v-ngo kevin-v-ngo left a comment

Choose a reason for hiding this comment

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

Great doc Brandon! Added my feedback.

Comment thread src/current/v26.2/active-session-history.md Outdated
Comment thread src/current/v26.2/active-session-history.md Outdated
Comment thread src/current/v26.2/active-session-history.md Outdated
Comment thread src/current/v26.2/active-session-history.md Outdated
Comment thread src/current/v26.2/active-session-history.md Outdated
Comment thread src/current/v26.2/active-session-history.md Outdated
Comment thread src/current/v26.2/active-session-history.md Outdated
Comment thread src/current/v26.2/active-session-history.md
Comment thread src/current/v26.2/active-session-history.md Outdated
Comment thread src/current/v26.2/active-session-history.md Outdated
Comment thread src/current/v26.2/active-session-history.md Outdated
@bsanchez-the-roach bsanchez-the-roach requested a review from a team as a code owner April 16, 2026 20:04
Comment thread src/current/v26.2/active-session-history.md
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- [Metrics]({% link {{ page.version.version }}/metrics.md %})
- CPU profiles
- A script (`hot-ranges.sh`) that summarizes the hottest ranges (ranges receiving a high number of reads or writes)
- [Active Session History]({% link {{ page.version.version }}/active-session-history.md %}) data
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.

@alyshanjahani-crl
Is this in the right spot? In the list of unfilterable items?

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Sorry what is this referring to? what is included in the debug.zip?

ASH tables aren't dumped as part of debug.zip directly

  • indirectly though the heap_profiler directory that is included in debug.zip will have ASH dumps/reports whenever goroutine dumps were taken or cpu profiles.
  • indirectly through logs - ash logs periodically to ops channel

Copy link
Copy Markdown
Contributor Author

@bsanchez-the-roach bsanchez-the-roach Apr 17, 2026

Choose a reason for hiding this comment

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

@alyshanjahani-crl I was basing this on the following from the current draft of the doc:

Debug zip integration
When the environment sampler triggers goroutine dumps or CPU profiles, ASH writes aggregated report files (.txt and .json) alongside them. These reports are included in cockroach debug zip output. The lookback window for these reports is controlled by the obs.ash.log_interval cluster setting.

Can you help me be more specific about this? So they're not in a separate part of the zip, ASH data instead appears within the existing heap profiles and log files? If so I can remove the change I made to that file.

Comment thread src/current/v26.2/active-session-history.md
Comment thread src/current/v26.2/active-session-history.md
Comment thread src/current/v26.2/active-session-history.md Outdated
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