Sitelet https://github.com/supabase/supabase/pull/49503
Skip to content

docs: move inspect and advisors into observability - #49503

Draft
SaxonF wants to merge 2 commits into
masterfrom
docs/observability-inspect-advisors
Draft

docs: move inspect and advisors into observability#49503
SaxonF wants to merge 2 commits into
masterfrom
docs/observability-inspect-advisors

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 ← this PR
  2. docs: split Studio logs from ClickHouse log queries #49501 split Studio logs from ClickHouse queries
  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. First layer in the observability stack.

What is the current behavior?

Inspect and advisors live under Database (/guides/database/inspect, /guides/database/database-advisors). Observability readers have to leave the monitoring section to find them.

What is the new behavior?

  • Moves inspect into /guides/monitoring-and-debugging/inspect
  • Adds /guides/monitoring-and-debugging/advisors (replaces the Database Advisors page)
  • Adds redirects and updates Studio/docs links so old URLs keep working
  • Adds both pages to the existing Monitoring nav so they are discoverable before the later IA PR

Additional context

Inspect and advisors pages render as standard MDX. Redirects cover /docs/guides/database/inspect, /docs/guides/database/database-advisors, and /docs/guides/database/database-linter. Debugging-guide content is unchanged except the inspect URL.

Self-review

  • No leftover /guides/database/inspect or /guides/database/database-advisors links in docs guides or Studio linter/AI surfaces (historical blog posts left as-is)
  • Smoke test path updated to /docs/guides/monitoring-and-debugging/advisors
Open in Web Open in Cursor 

Relocate database inspect and advisors guides under the observability
section, with redirects and Studio/docs link updates so existing URLs
keep working.

Co-authored-by: Saxon Fletcher <SaxonF@users.noreply.github.com>
@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)
design-system Ready Ready Preview Aug 25, 2026 12:06am
docs Ready Ready Preview, v0 Aug 25, 2026 12:06am
studio-self-hosted Ready Ready Preview Aug 25, 2026 12:06am
studio-staging Ready Ready Preview Aug 25, 2026 12:06am
ui-library Ready Ready Preview Aug 25, 2026 12:06am
zone-www-dot-com Ready Ready Preview, v0 Aug 25, 2026 12:06am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
studio Ignored Ignored Aug 25, 2026 12:06am

Request Review

@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 ↗︎.

Apply Prettier wrapping on Studio linter links, the advisors smoke test,
and the federated-docs table row.

Co-authored-by: Saxon Fletcher <SaxonF@users.noreply.github.com>
@github-actions

github-actions Bot commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

🎭 Playwright Test Results (next)

passed  239 passed
flaky  4 flaky
skipped  5 skipped

Details

stats  248 tests across 29 suites
duration  7 minutes, 31 seconds
commit  ac07215

Flaky tests

Features › column-editor-types.spec.ts › column editor complex types › FK selector flags a mismatch between same-named enums from different schemas
Features › queue-table-operations.spec.ts › Queue Table Operations › pending changes persist when switching between tables
Features › realtime-inspector.spec.ts › Realtime Inspector › Basic Inspector UI › can join and leave a channel
Features › rls-policies.spec.ts › RLS Policies › Create RLS Policy › should cancel policy creation

Skipped tests

Features › auth-users.spec.ts › should show web3 users as enabled when the matching web3 provider is enabled
Features › sql-editor.spec.ts › SQL Editor › snippet favourite works as expected
Features › sql-editor.spec.ts › SQL Editor › share with team works as expected
Features › sql-editor.spec.ts › SQL Editor › folders works as expected
Features › sql-editor.spec.ts › SQL Editor › other SQL snippets actions work as expected

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