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.

…overview Renames the section title from "Telemetry" to "Monitoring and Debugging" in nav constants. Replaces the 14-line placeholder overview with a proper entry point: signal-type table, debugging quickstart, log querying intro, log drains, AI agent / MCP callout, and automated monitoring note. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

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

Overview is now a clean navigation page — three ContentListing panels (Debugging / Monitoring / AI & automation) with no how-to content. Detail pages carry the explanatory content; the overview routes to them. 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

Co-authored-by: Jeremias Menichelli <jmenichelli@gmail.com>

…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

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

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

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment, Open in v0	Jul 28, 2026 8:17pm

6 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
studio	Ignored		Jul 28, 2026 8:17pm
design-system	Skipped		Jul 28, 2026 8:17pm
studio-self-hosted	Skipped		Jul 28, 2026 8:17pm
studio-staging	Skipped		Jul 28, 2026 8:17pm
ui-library	Skipped		Jul 28, 2026 8:17pm
zone-www-dot-com	Skipped	Open in v0	Jul 28, 2026 8:17pm

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

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: ba4578d6-0f4e-443b-aa76-5e4739be4322

📥 Commits

Reviewing files that changed from the base of the PR and between 944b41c and cca4316.

📒 Files selected for processing (6)

apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
apps/docs/content/guides/telemetry.mdx
apps/docs/content/guides/telemetry/debugging.mdx
apps/docs/content/guides/telemetry/logs.mdx
apps/docs/data/content-listings/index.ts
apps/docs/data/content-listings/telemetry.data.ts

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

smeubank and others added 14 commits July 23, 2026 13:10

docs(telemetry): remove automated monitoring section from overview

be8a977

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

4ca6186

addressing some feedback

6e42810

addressing some feedback

fix grid

8636c17

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

Update apps/docs/data/content-listings/telemetry.data.ts

9a25a2f

Co-authored-by: Jeremias Menichelli <jmenichelli@gmail.com>

Update apps/docs/content/guides/telemetry/debugging.mdx

eb67105

Co-authored-by: Jeremias Menichelli <jmenichelli@gmail.com>

update headers and add links for agents

caacbeb

move to the debugging page

cbb1bc2

Debugging Skill and MCP dependent changes

cca4316

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

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

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 14 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

Uh oh!

supabase Bot commented Jul 28, 2026

Uh oh!

coderabbitai Bot commented Jul 28, 2026 •

edited

Loading

Walkthrough

Changes

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

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

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!

Walkthrough

Changes

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

smeubank commented Jul 28, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Jul 28, 2026 •

edited

Loading