Overview
The Supabase integration enables Steadwing to access your Supabase projects, database metrics, and configuration data. During root cause analysis, Steadwing can investigate database performance issues, connection pool problems, authentication errors, and service health to identify the underlying causes of incidents.Why Use Supabase with Steadwing?
Database Health Monitoring
Monitor PostgreSQL performance, connection pools, and query metrics
Service Status Tracking
Track the health status of all Supabase services (Auth, Storage, PostgREST)
Configuration Analysis
Analyze database and API configurations to identify misconfigurations
Schema Investigation
Inspect table schemas, functions, and database branches during incidents
Setup Instructions
Step 1: Connect Supabase OAuth
- Navigate to Steadwing Settings
- Find the Supabase integration card
- Click the Connect button (toggle switch)
- You will be redirected to Supabase’s authorization page
- Select the organization you want to connect
- Click Authorize to grant Steadwing access to your Supabase projects
Step 2: Verify Connection
- Return to Steadwing Settings
- Confirm the Supabase integration shows as Connected
- The integration will now be available during incident analysis
How Supabase Integration Works
Data Collection
Steadwing can query Supabase for:- Service Health - Real-time health status of all Supabase services
- Database Metrics - PostgreSQL configuration, connection pool stats, and performance data
- Project Information - All projects, branches, and their configurations
- Schema Details - Table schemas, database functions, and stored procedures
- Storage Data - Storage buckets and their configurations
- Auth Configuration - Authentication settings and providers
- Network Settings - Network restrictions, bans, and security configurations
Root Cause Analysis
When analyzing an incident, Steadwing:- Checks overall Supabase service health status
- Investigates PostgreSQL and PostgREST configurations
- Analyzes connection pool settings (PgBouncer)
- Reviews authentication configuration for auth-related issues
- Inspects table schemas and database functions
- Examines database branches and their configurations
- Provides database-specific insights in the RCA report
Available Capabilities
Database Management
- List all database tables and their schemas
- Retrieve database function definitions
- Inspect database branches and configurations
- View backup history
Project Configuration
- Get PostgreSQL configuration settings
- Review PostgREST API configuration
- Check PgBouncer connection pooling settings
- Analyze authentication configuration
Service Monitoring
- Monitor service health status across all components
- Track project upgrade status
- Review network restrictions and security settings
- Inspect pgsodium encryption configuration
Configuration
Required Permissions
The Supabase OAuth integration requires:- Read access to your Supabase organization
- Read access to project configurations
- Read access to database metadata
- Modify database data
- Change project configurations
- Delete or create resources
- Access sensitive user data
Supported Features
- Service health monitoring
- Database configuration analysis
- Schema and function inspection
- Connection pool monitoring
- Authentication configuration review
- Storage bucket management
- Network security analysis
FAQs
What Supabase data does Steadwing access?
What Supabase data does Steadwing access?
Steadwing reads project configurations, database schemas, service health status, and metadata. It does NOT access your actual database data, user information, or modify any settings.
Can I limit Steadwing's access to specific Supabase projects?
Can I limit Steadwing's access to specific Supabase projects?
The OAuth flow grants access at the organization level. You can control which projects Steadwing analyzes by managing your Supabase organization permissions.
Does Steadwing modify my Supabase configuration?
Does Steadwing modify my Supabase configuration?
No, Steadwing only has read access. It cannot modify database configurations, change settings, or alter any data.
How does Steadwing use Supabase data during RCA?
How does Steadwing use Supabase data during RCA?
When an incident occurs, Steadwing queries relevant Supabase metrics and configurations to identify database-related issues like connection pool exhaustion, slow queries, or service degradation.
Can I disconnect the Supabase integration?
Can I disconnect the Supabase integration?
Yes, go to Settings, find the Supabase integration, and click the toggle to disconnect. This will revoke Steadwing’s access to your Supabase organization.
What happens if my Supabase OAuth token expires?
What happens if my Supabase OAuth token expires?
OAuth tokens are automatically refreshed by Supabase. If the connection is lost, you’ll need to reconnect by following the setup instructions again.