Sitelet https://github.com/supabase/supabase/pull/49501#partial-pull-merging
Skip to content

docs: split Studio logs from ClickHouse log queries - #49501

Draft
SaxonF wants to merge 1 commit into
docs/observability-inspect-advisorsfrom
docs/observability-logs
Draft

docs: split Studio logs from ClickHouse log queries#49501
SaxonF wants to merge 1 commit into
docs/observability-inspect-advisorsfrom
docs/observability-logs

Conversation

@SaxonF

@SaxonF SaxonF commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

Stack

Draft stack extracted from docs/monitoring. Merge bottom-up. Troubleshooting / debugging-guide rewrite is out of scope.

  1. docs: move inspect and advisors into observability #49503 move inspect and advisors
  2. docs: split Studio logs from ClickHouse log queries #49501 split Studio logs from ClickHouse queries ← this PR
  3. docs: treat reports as signal dashboards, not fix lists #49500 treat reports as signal dashboards
  4. docs: add Observe the data hub for logs, metrics, and advisors #49502 add Observe the data hub
  5. docs: add reusable monitoring agent setup components #49506 add agent setup components
  6. docs: add hire-an-agent templates for observability routines #49504 add hire-an-agent templates
  7. docs: restructure observability navigation and overview #49505 restructure observability nav and overview

I have read the CONTRIBUTING.md file.

YES

What kind of change does this PR introduce?

Docs update. Second layer in the observability stack.

What is the current behavior?

/guides/monitoring-and-debugging/logs mixes the Studio Logs UI with ClickHouse query syntax, sources, and recording extra events.

What is the new behavior?

  • Logs is the Studio interface guide (filters, log types, inspecting a row)
  • Query and filter logs (advanced-log-filtering) owns ClickHouse SQL, sources, MCP/API/CLI access, and recording extra Postgres/API/Realtime events
  • Log field reference explains log_attributes query paths
  • Nav labels and cross-links follow the new titles

Additional context

Forward links to the later Observe the data hub are added in #49502.

Self-review

  • Existing #querying-with-the-logs-explorer and #configuring-pgauditlog anchors now live on Query and filter logs
  • Debugging-guide links that pointed at the old Logs Explorer heading were retargeted so they still resolve
Open in Web Open in Cursor 

@coderabbitai

coderabbitai Bot commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@vercel

vercel Bot commented Aug 24, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, v0 Aug 25, 2026 12:02am
6 Skipped Deployments
Project Deployment Actions Updated (UTC)
studio Ignored Ignored Aug 25, 2026 12:02am
design-system Skipped Skipped Aug 25, 2026 12:02am
studio-self-hosted Skipped Skipped Aug 25, 2026 12:02am
studio-staging Skipped Skipped Aug 25, 2026 12:02am
ui-library Skipped Skipped Aug 25, 2026 12:02am
zone-www-dot-com Skipped Skipped Aug 25, 2026 12:02am

Request Review

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Aug 24, 2026
@supabase

supabase Bot commented Aug 24, 2026

Copy link
Copy Markdown

This pull request has been ignored for the connected project xguihxuzqibwxjnimxev because there are no changes detected in supabase directory. You can change this behaviour in Project Integrations Settings ↗︎.


Preview Branches by Supabase.
Learn more about Supabase Branching ↗︎.

Keep Logs as the Studio interface guide and move query syntax, sources,
and recording extra events into Query and filter logs, with matching
nav and cross-links.

Co-authored-by: Saxon Fletcher <SaxonF@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants