Docs/telemetry mcp tools by smeubank · Pull Request #48417 · supabase/supabase

smeubank · 2026-07-28T20:17:50Z

I have read the CONTRIBUTING.md file.

YES

What kind of change does this PR introduce?

docs update

What is the current behavior?

the PR will be merged to this one: #48243

once these 2 are merged:

What is the new behavior?

documents agent related features that will be useful for the skill we will be shipping

Additional context

Add any other context or screenshots.

Summary by CodeRabbit

Documentation
- Renamed the Telemetry section to Monitoring and Debugging.
- Reorganized documentation into dedicated Debugging and Monitoring sections.
- Added troubleshooting guidance for isolating issues and finding product-specific resources.
- Added curated listings for monitoring and debugging guides.
- Improved log documentation with links to debugging guidance and advanced filtering tips.

vercel · 2026-07-28T20:17:56Z

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

Project	Deployment	Actions	Updated (UTC)
docs	Error		Jul 31, 2026 10:41am

6 Skipped Deployments

Project	Deployment	Updated (UTC)
studio	Ignored	Jul 31, 2026 10:41am
design-system	Skipped	Jul 31, 2026 10:41am
studio-self-hosted	Skipped	Jul 31, 2026 10:41am
studio-staging	Skipped	Jul 31, 2026 10:41am
ui-library	Skipped	Jul 31, 2026 10:41am
zone-www-dot-com	Skipped	Jul 31, 2026 10:41am

supabase · 2026-07-28T20:17:57Z

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

coderabbitai · 2026-07-28T20:18:35Z

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: b1ccedc7-9659-4b4a-81ac-ac1d524aa078

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

📝 Walkthrough

Walkthrough

Telemetry documentation is renamed to “Monitoring and Debugging,” with new debugging and monitoring content listings, reorganized navigation, updated debugging and logs guides, and revised landing-page content.

Changes

Monitoring and Debugging documentation

Layer / File(s)	Summary
Telemetry content listing definitions and registration `apps/docs/data/content-listings/telemetry.data.ts`, `apps/docs/data/content-listings/index.ts`	Adds debugging and monitoring listing groups and registers them in `CONTENT_LISTINGS`.
Monitoring and debugging guide content `apps/docs/content/guides/telemetry.mdx`, `apps/docs/content/guides/telemetry/debugging.mdx`, `apps/docs/content/guides/telemetry/logs.mdx`	Updates the landing page, debugging workflow, product-specific debugging links, log guidance, and section anchors.
Navigation structure update `apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts`	Renames the telemetry navigation section and reorganizes it into Debugging and Monitoring groups.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

supabase/supabase#47762: Updates overlapping telemetry navigation, debugging, and logs documentation.
supabase/supabase#47914: Also modifies the telemetry logs guide and Logs Explorer guidance.
supabase/supabase#48243: Renames and restructures the telemetry documentation and navigation.

Suggested reviewers: jeremenichelli

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title is brief and matches the docs/telemetry and MCP tooling focus of the PR, though it is a bit broad.
Description check	✅ Passed	The description matches the required template and includes the key sections, with only brief detail in the behavior fields.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch docs/telemetry-mcp-tools

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.}

- telemetry.mdx: adds "Start here" decision tree, docs-first architecture note in the AI agents section, and expanded chaos-o11y mention - debugging.mdx: adds MCP tip admonition at the top; adds "For AI agents" section at the bottom describing the get_logs-first workflow - logs.mdx: adds debugging guide back-link at the top; adds advanced-log- filtering cross-link at the end of best practices Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

addressing some feedback

display as grid and ensure they display equally in each section with only 2 columns

…s split this committ assume we will have merged or should be merged to gether with cahnges on skills and MCP - supabase/agent-skills#112 - supabase/mcp#333 query_logs (hosted only, ClickHouse SQL) is now the preferred tool for production projects; get_logs remains the only option for local and self-hosted. Updates the MCP tools table, log-querying section, and skill step 3 in ai-agents.mdx, and the tip admonition in debugging.mdx. logs.mdx already had this right at line 321.

Removes content that depends on supabase/agent-skills#112 and supabase/mcp#341 before those PRs have merged: - Delete ai-agents.mdx (new page documenting query_logs / get_logs / skill) - Remove MCP tip admonition from debugging.mdx - Remove telemetry-ai ContentListings panel from overview - Remove telemetryAI export from telemetry.data.ts - Remove telemetryAI from content-listings index - Remove "AI & automation" nav group from NavigationMenu.constants.ts These changes move to docs/telemetry-mcp-tools which targets this branch as its base and will not merge until the two external PRs land. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

These changes have been removed from the docs PR, which are dependent on changes to the skills and MCP repo, Free those changes to be merged, Do not merge these until the others are in

blacksmith-sh · 2026-07-31T10:42:29Z

Found 3 test failures on Blacksmith runners:

Failures

Test	View Logs
`local-smoke/` `no-credentials.spec.ts:15:3 › docs dev runs locally without credentials › a normal guid` `e page renders and the feedback widget does not crash`	View Logs
`local-smoke/` `no-credentials.spec.ts:28:3 › docs dev runs locally without credentials › database-advi` `sors page renders (full content or graceful fallback, never a crash)`	View Logs
`local-smoke/` `no-credentials.spec.ts:39:3 › docs dev runs locally without credentials › a troubleshoo` `ting article page renders without Supabase credentials`	View Logs

^{Need help on this PR? Tag @codesmith-bot with what you need.}

jeremenichelli · 2026-07-31T14:19:54Z

Closing in favor of docs/telemetry-mcp-tools

smeubank requested a review from a team as a code owner July 28, 2026 20:17

github-actions Bot added the documentation Improvements or additions to documentation label Jul 28, 2026

smeubank marked this pull request as draft July 28, 2026 20:18

smeubank added the do-not-merge Not ready to be merged yet; pending other dependencies label Jul 28, 2026

This was referenced Jul 29, 2026

docs: lead self-hosting overview with what/why/CTA, collapse secondary content #48415

Open

docs(python): add task-oriented client lifecycle guide covering 20+ APIs across 7 pages #48210

Open

smeubank and others added 9 commits July 31, 2026 12:33

docs(telemetry): add AI agents page and restructure nav (MAX)

564e4b8

addressing some feedback

b4c5d3f

addressing some feedback

fix grid

86e0a0e

display as grid and ensure they display equally in each section with only 2 columns

update headers and add links for agents

74179a0

move to the debugging page

f69f1e6

Debugging Skill and MCP dependent changes

64529af

These changes have been removed from the docs PR, which are dependent on changes to the skills and MCP repo, Free those changes to be merged, Do not merge these until the others are in

jeremenichelli force-pushed the docs/telemetry-mcp-tools branch from cca4316 to 64529af Compare July 31, 2026 10:40

This was referenced Jul 31, 2026

Fix/logs usage docs pricing #48533

Closed

docs: document the supabase-js /tracing opt-in subpath #48529

Open

jeremenichelli closed this Jul 31, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Docs/telemetry mcp tools - #48417

Docs/telemetry mcp tools#48417
smeubank wants to merge 9 commits into
masterfrom
docs/telemetry-mcp-tools

smeubank commented Jul 28, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

vercel Bot commented Jul 28, 2026 •

edited

Loading

Uh oh!

supabase Bot commented Jul 28, 2026

Uh oh!

coderabbitai Bot commented Jul 28, 2026 •

edited

Loading

Review skipped

Walkthrough

Changes

Uh oh!

blacksmith-sh Bot commented Jul 31, 2026

Uh oh!

jeremenichelli commented Jul 31, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Uh oh!

Conversation

smeubank commented Jul 28, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

I have read the CONTRIBUTING.md file.

What kind of change does this PR introduce?

What is the current behavior?

What is the new behavior?

Additional context

Summary by CodeRabbit

Uh oh!

vercel Bot commented Jul 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

supabase Bot commented Jul 28, 2026

Uh oh!

coderabbitai Bot commented Jul 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Walkthrough

Changes

Uh oh!

blacksmith-sh Bot commented Jul 31, 2026

Failures

Uh oh!

jeremenichelli commented Jul 31, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

smeubank commented Jul 28, 2026 •

edited by coderabbitai Bot

Loading

vercel Bot commented Jul 28, 2026 •

edited

Loading

coderabbitai Bot commented Jul 28, 2026 •

edited

Loading