Skip to content

Condense troubleshooting docs #419

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
tembo wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Condense troubleshooting docs #419

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 3 additions & 23 deletions integrations/supabase.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,28 +58,8 @@ When Tembo identifies optimization opportunities, it will:

# Troubleshooting

## Projects Not Appearing
**Projects not appearing?** Wait 2-5 minutes for initial sync, verify you authorized Tembo to access the projects, ensure projects are active (not paused), and try the manual sync button on the Integrations page.

If your Supabase projects don't appear after connecting:
**No query statistics?** Verify `pg_stat_statements` is active in your database, generate some query traffic, and wait 24-48 hours for new projects to collect data.

1. **Wait a few minutes** - Initial sync can take 2-5 minutes depending on the number of projects
2. **Verify Supabase access** - Ensure you authorized Tembo with access to the projects you want to monitor
3. **Check project status** - Projects must be active (not paused) to appear in the list
4. **Manual sync** - Use the sync button on the Integrations page to trigger a refresh

## No Query Statistics Available

If Tembo isn't detecting slow queries or optimization opportunities:

1. **Verify pg_stat_statements** - Supabase enables this extension by default, but verify it's active in your database
2. **Generate query traffic** - The database needs query activity to collect statistics
3. **Check sampling rate** - Ensure your queries are running frequently enough to be captured
4. **Review time range** - Performance data is collected over time; new projects may need 24-48 hours

## Optimization PRs Not Being Created

If Tembo detects issues but isn't creating pull requests:

1. **Map your repository** - Ensure you've mapped your Supabase project to the correct repository
2. **Check repository permissions** - Verify Tembo has write access to create branches and pull requests
3. **Review migration location** - Confirm your database migrations are stored in the mapped repository
**Optimization PRs not being created?** Ensure you've mapped your Supabase project to the correct repository with write access, and confirm your database migrations are stored there.