Skip to content

docs: Rewrite PerfettoSQL getting-started guide#5302

Open
LalitMaganti wants to merge 9 commits intomainfrom
dev/lalitm/docs-sql-getting-started-rewrite
Open

docs: Rewrite PerfettoSQL getting-started guide#5302
LalitMaganti wants to merge 9 commits intomainfrom
dev/lalitm/docs-sql-getting-started-rewrite

Conversation

@LalitMaganti
Copy link
Copy Markdown
Member

Improve the getting-started guide for new users:

  • Add scheduling, stack sampling, heap profiling, and heap graph
    sections as first-class core concepts with query examples.
  • Clarify that UI "tracks" and trace processor "tracks" are different
    concepts; remove misleading scheduling-as-track example.
  • Lead with stdlib views (thread_slice, process_slice,
    thread_or_process_slice) as the recommended way to add context to
    slices, with manual JOINs as a secondary option.
  • Add callsite/frame join examples for profiling data and point to
    stdlib summary trees for full callstack aggregation.
  • Add best practices section (filter early, use LIMIT, prefer stdlib,
    nanosecond timestamps).
  • Remove confusing ancestor/descendant_slice_by_stack sections.

Improve the getting-started guide for new users:
- Add scheduling, stack sampling, heap profiling, and heap graph
  sections as first-class core concepts with query examples.
- Clarify that UI "tracks" and trace processor "tracks" are different
  concepts; remove misleading scheduling-as-track example.
- Lead with stdlib views (thread_slice, process_slice,
  thread_or_process_slice) as the recommended way to add context to
  slices, with manual JOINs as a secondary option.
- Add callsite/frame join examples for profiling data and point to
  stdlib summary trees for full callstack aggregation.
- Add best practices section (filter early, use LIMIT, prefer stdlib,
  nanosecond timestamps).
- Remove confusing ancestor/descendant_slice_by_stack sections.
@LalitMaganti LalitMaganti force-pushed the dev/lalitm/docs-sql-getting-started-rewrite branch from 898a99c to 44d1a93 Compare March 26, 2026 16:11
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.

2 participants