From 6dda32b1d98e1ff98d3ac6955650f2bb5ae2ca63 Mon Sep 17 00:00:00 2001 From: Chris Chinchilla Date: Mon, 13 Oct 2025 16:11:26 +0200 Subject: [PATCH] Separate reports sections --- .../NavigationMenu.constants.ts | 19 +- apps/docs/content/guides/api/reports.mdx | 14 + .../content/guides/auth/debugging/reports.mdx | 14 + apps/docs/content/guides/database/reports.mdx | 223 ++++++++++++++ .../docs/content/guides/functions/reports.mdx | 12 + apps/docs/content/guides/realtime/reports.mdx | 14 + .../guides/storage/debugging/reports.mdx | 14 + .../docs/content/guides/telemetry/reports.mdx | 283 ------------------ 8 files changed, 309 insertions(+), 284 deletions(-) create mode 100644 apps/docs/content/guides/api/reports.mdx create mode 100644 apps/docs/content/guides/auth/debugging/reports.mdx create mode 100644 apps/docs/content/guides/database/reports.mdx create mode 100644 apps/docs/content/guides/functions/reports.mdx create mode 100644 apps/docs/content/guides/realtime/reports.mdx create mode 100644 apps/docs/content/guides/storage/debugging/reports.mdx diff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts index 2b7d9e57a0f..ffb68377a57 100644 --- a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts +++ b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts @@ -794,6 +794,7 @@ export const auth: NavMenuConstant = { { name: 'Debugging', items: [ + { name: 'Reports', url: '/guides/auth/debugging/reports', enabled: billingEnabled }, { name: 'Error Codes', url: '/guides/auth/debugging/error-codes' }, { name: 'Troubleshooting', @@ -1110,6 +1111,11 @@ export const database: NavMenuConstant = { name: 'Debugging', url: undefined, items: [ + { + name: 'Reports', + url: '/guides/database/reports' as `/${string}`, + enabled: billingEnabled, + }, { name: 'Timeouts', url: '/guides/database/postgres/timeouts' as `/${string}`, @@ -1435,7 +1441,10 @@ export const api: NavMenuConstant = { { name: 'Tools', url: '/guides/api', - items: [{ name: 'SQL to REST API Translator', url: '/guides/api/sql-to-rest' }], + items: [ + { name: 'Reports', url: '/guides/api/reports', enabled: billingEnabled }, + { name: 'SQL to REST API Translator', url: '/guides/api/sql-to-rest' }, + ], }, { name: 'Guides', @@ -1568,6 +1577,11 @@ export const functions: NavMenuConstant = { name: 'Debugging', url: undefined, items: [ + { + name: 'Reports', + url: '/guides/functions/reports' as `/${string}`, + enabled: billingEnabled, + }, { name: 'Local Debugging with DevTools', url: '/guides/functions/debugging-tools' as `/${string}`, @@ -1817,6 +1831,8 @@ export const realtime: NavMenuConstant = { name: 'Debugging', url: undefined, items: [ + { name: 'Reports', url: '/guides/realtime/reports', enabled: billingEnabled }, + { name: 'Operational Error Codes', url: '/guides/realtime/error_codes', items: [] }, { name: 'Troubleshooting', url: '/guides/realtime/troubleshooting' }, ], @@ -1945,6 +1961,7 @@ export const storage: NavMenuConstant = { name: 'Debugging', url: undefined, items: [ + { name: 'Reports', url: '/guides/storage/debugging/reports', enabled: billingEnabled }, { name: 'Logs', url: '/guides/storage/debugging/logs' }, { name: 'Error Codes', url: '/guides/storage/debugging/error-codes' }, { name: 'Troubleshooting', url: '/guides/storage/troubleshooting' }, diff --git a/apps/docs/content/guides/api/reports.mdx b/apps/docs/content/guides/api/reports.mdx new file mode 100644 index 00000000000..73b36590277 --- /dev/null +++ b/apps/docs/content/guides/api/reports.mdx @@ -0,0 +1,14 @@ +--- +title: 'API Gateway Reports' +description: 'Reports to help debug API Gateway issues' +--- + +The API Gateway report analyzes traffic patterns and performance characteristics of requests flowing through your Supabase project's API layer. + +| Chart | Description | Key Insights | +| --------------- | ----------------------------------------- | ------------------------------------------------ | +| Total Requests | Overall API request volume | Traffic patterns and growth trends | +| Response Errors | Error rates with 4XX and 5XX status codes | API reliability and user experience issues | +| Response Speed | Average API response times | Performance bottlenecks and optimization targets | +| Network Traffic | Request and response egress usage | Data transfer patterns and cost implications | +| Top Routes | Most frequently accessed API endpoints | Usage patterns and optimization priorities | diff --git a/apps/docs/content/guides/auth/debugging/reports.mdx b/apps/docs/content/guides/auth/debugging/reports.mdx new file mode 100644 index 00000000000..1d59efe9c16 --- /dev/null +++ b/apps/docs/content/guides/auth/debugging/reports.mdx @@ -0,0 +1,14 @@ +--- +title: 'Auth Reports' +description: 'Reports to help debug authentication issues' +--- + +The Auth report focuses on user authentication patterns and behaviors within your Supabase project. + +| Chart | Description | Key Insights | +| ------------------------ | --------------------------------------------- | ----------------------------------------------- | +| Active Users | Count of unique users performing auth actions | User engagement and retention patterns | +| Sign In Attempts by Type | Breakdown of authentication methods used | Password vs OAuth vs magic link preferences | +| Sign Ups | Total new user registrations | Growth trends and onboarding funnel performance | +| Auth Errors | Error rates grouped by status code | Authentication friction and security issues | +| Password Reset Requests | Volume of password recovery attempts | User experience pain points | diff --git a/apps/docs/content/guides/database/reports.mdx b/apps/docs/content/guides/database/reports.mdx new file mode 100644 index 00000000000..0aa2a8d5aa8 --- /dev/null +++ b/apps/docs/content/guides/database/reports.mdx @@ -0,0 +1,223 @@ +--- +title: 'Database Reports' +description: 'Reports to help debug database issues' +--- + +The Database report provides the most comprehensive view into your Postgres instance's health and performance characteristics. These charts help you identify performance bottlenecks, resource constraints, and optimization opportunities at a glance. + +The following charts are available for Free and Pro plans: + +| Chart | Available Plans | Description | Key Insights | +| ---------------------------- | --------------- | -------------------------------------------- | --------------------------------------------- | +| Memory usage | Free, Pro | RAM usage percentage by the database | Memory pressure and resource utilization | +| CPU usage | Free, Pro | Average CPU usage percentage | CPU-intensive query identification | +| Disk IOPS | Free, Pro | Read/write operations per second with limits | IO bottleneck detection and workload analysis | +| Database connections | Free, Pro | Number of pooler connections to the database | Connection pool monitoring | +| Shared Pooler connections | All | Client connections to the shared pooler | Shared pooler usage patterns | +| Dedicated Pooler connections | All | Client connections to PgBouncer | Dedicated pooler connection monitoring | + +{/* supa-mdx-lint-disable-next-line Rule001HeadingCase */} + +## Advanced Telemetry + +The following charts provide a more advanced and detailed view of your database performance and are available only for Teams and Enterprise plans. + +## Memory usage + +Memory usage chart + +| Component | Description | +| ------------------- | ------------------------------------------------------ | +| **Used** | RAM actively used by Postgres and the operating system | +| **Cache + buffers** | Memory used for page cache and Postgres buffers | +| **Free** | Available unallocated memory | + +How it helps debug issues: + +| Issue | Description | +| ------------------------------ | ------------------------------------------------ | +| Memory pressure detection | Identify when free memory is consistently low | +| Cache effectiveness monitoring | Monitor cache performance for query optimization | +| Memory leak detection | Detect inefficient memory usage patterns | + +Actions you can take: + +| Action | Description | +| --------------------------------------------------------------------------- | ---------------------------------------------- | +| [Upgrade compute size](/docs/guides/platform/compute-and-disk#compute-size) | Increase available memory resources | +| Optimize queries | Reduce memory consumption of expensive queries | +| Tune Postgres configuration | Improve memory management settings | +| Implement application caching | Add query result caching to reduce memory load | + +## CPU usage + +CPU usage chart + +| Category | Description | +| ---------- | ------------------------------------------------ | +| **System** | CPU time for kernel operations | +| **User** | CPU time for database queries and user processes | +| **IOWait** | CPU time waiting for disk/network IO | +| **IRQs** | CPU time handling interrupts | +| **Other** | CPU time for miscellaneous tasks | + +How it helps debug issues: + +| Issue | Description | +| ---------------------------------- | -------------------------------------------------- | +| CPU-intensive query identification | Identify expensive queries when User CPU is high | +| IO bottleneck detection | Detect disk/network issues when IOWait is elevated | +| System overhead monitoring | Monitor resource contention and kernel overhead | + +Actions you can take: + +| Action | Description | +| -------------------------------------------------------------- | --------------------------------------------------------------------------- | +| Optimize CPU-intensive queries | Target queries causing high User CPU usage | +| Address IO bottlenecks | Resolve disk/network issues when IOWait is high | +| [Upgrade compute size](/docs/guides/platform/compute-and-disk) | Increase available CPU capacity | +| Implement proper indexing | Use [query optimization](/docs/guides/database/postgres/indexes) techniques | + +## Disk input/output operations per second (IOPS) + +Disk IOPS chart + +This chart displays read and write IOPS with a reference line showing your compute size's maximum IOPS capacity. + +How it helps debug issues: + +| Issue | Description | +| --------------------------------- | ---------------------------------------------------------------- | +| Disk IO bottleneck identification | Identify when disk IO becomes a performance constraint | +| Workload pattern analysis | Distinguish between read-heavy vs write-heavy operations | +| Performance correlation | Spot disk activity spikes that correlate with performance issues | + +Actions you can take: + +| Action | Description | +| -------------------------------------------------------------- | --------------------------------------------------------- | +| Optimize indexing | Reduce high read IOPS through better query indexing | +| Consider read replicas | Distribute read-heavy workloads across multiple instances | +| Batch write operations | Reduce write IOPS by grouping database writes | +| [Upgrade compute size](/docs/guides/platform/compute-and-disk) | Increase IOPS limits with larger compute instances | + +## Disk IO Usage + +Disk IO Usage chart + +This chart displays the percentage of your allocated IOPS (Input/Output Operations Per Second) currently being used. + +How it helps debug issues: + +| Issue | Description | +| --------------------------- | ----------------------------------------------------------- | +| IOPS limit monitoring | Identify when approaching your allocated IOPS capacity | +| Performance correlation | Correlate high IO usage with application performance issues | +| Operation impact assessment | Monitor how database operations affect disk performance | + +Actions you can take: + +| Action | Description | +| -------------------------------------------------------------- | -------------------------------------------------- | +| Optimize disk-intensive queries | Reduce queries that perform excessive reads/writes | +| Add strategic indexes | Reduce sequential scans with appropriate indexing | +| [Upgrade compute size](/docs/guides/platform/compute-and-disk) | Increase IOPS limits with larger compute instances | +| Review database design | Optimize schema and query patterns for efficiency | + +## Disk size + +Disk Size chart + +| Component | Description | +| ------------ | --------------------------------------------------------- | +| **Database** | Space used by your actual database data (tables, indexes) | +| **WAL** | Space used by Write-Ahead Logging | +| **System** | Reserved space for system operations | + +How it helps debug issues: + +| Issue | Description | +| ----------------------------- | ------------------------------------------- | +| Space consumption monitoring | Track disk usage trends over time | +| Growth pattern identification | Identify rapid growth requiring attention | +| Capacity planning | Plan upgrades before hitting storage limits | + +Actions you can take: + +| Action | Description | +| -------------------------------------------------------------------------------- | -------------------------------------------------------------------- | +| Run [VACUUM](https://www.postgresql.org/docs/current/sql-vacuum.html) operations | Reclaim dead tuple space and optimize storage | +| Analyze large tables | Use CLI commands like `table-sizes` to identify optimization targets | +| Implement data archival | Archive historical data to reduce active storage needs | +| [Upgrade disk size](/docs/guides/platform/database-size) | Increase storage capacity when approaching limits | + +## Database connections + +Database connections chart + +| Connection Type | Description | +| --------------- | ------------------------------------------------ | +| **Postgres** | Direct connections from your application | +| **PostgREST** | Connections from the PostgREST API layer | +| **Reserved** | Administrative connections for Supabase services | +| **Auth** | Connections from Supabase Auth service | +| **Storage** | Connections from Supabase Storage service | +| **Other roles** | Miscellaneous database connections | + +How it helps debug issues: + +| Issue | Description | +| ------------------------------- | ----------------------------------------------------------- | +| Connection pool exhaustion | Identify when approaching maximum connection limits | +| Connection leak detection | Spot applications not properly closing connections | +| Service distribution monitoring | Monitor connection usage across different Supabase services | + +Actions you can take: + +| Action | Description | +| ------------------------------------------------------------------------------------------ | --------------------------------------------------------------- | +| [Upgrade compute size](/docs/guides/platform/compute-and-disk#compute-size) | Increase maximum connection limits | +| Implement [connection pooling](/docs/guides/database/connecting-to-postgres#shared-pooler) | Optimize connection management for high direct connection usage | +| Review application code | Ensure proper connection handling and cleanup | diff --git a/apps/docs/content/guides/functions/reports.mdx b/apps/docs/content/guides/functions/reports.mdx new file mode 100644 index 00000000000..223eb3ee7ff --- /dev/null +++ b/apps/docs/content/guides/functions/reports.mdx @@ -0,0 +1,12 @@ +--- +title: 'Edge Function Reports' +description: 'Reports to help debug edge function issues' +--- + +The Edge Functions report provides insights into serverless function performance, execution patterns, and regional distribution across Supabase's global edge network. + +| Chart | Description | Key Insights | +| ---------------------- | ----------------------------------------- | ---------------------------------------------- | +| Execution Status Codes | Function response codes and error rates | Function reliability and error patterns | +| Execution Time | Average function duration and performance | Performance optimization opportunities | +| Invocations by Region | Geographic distribution of function calls | Global usage patterns and latency optimization | diff --git a/apps/docs/content/guides/realtime/reports.mdx b/apps/docs/content/guides/realtime/reports.mdx new file mode 100644 index 00000000000..ddce3e25acb --- /dev/null +++ b/apps/docs/content/guides/realtime/reports.mdx @@ -0,0 +1,14 @@ +--- +title: 'Realtime Reports' +description: 'Reports to help debug realtime issues' +--- + +The Realtime report tracks WebSocket connections, channel activity, and real-time event patterns in your Supabase project. + +| Chart | Description | Key Insights | +| --------------------- | ------------------------------------------------------------- | ------------------------------------------------- | +| Realtime Connections | Active WebSocket connections over time | Concurrent user activity and connection stability | +| Channel Events | Breakdown of broadcast, Postgres changes, and presence events | Real-time feature usage patterns | +| Rate of Channel Joins | Frequency of new channel subscriptions | User engagement with real-time features | +| Total Requests | HTTP requests to Realtime endpoints | API usage alongside WebSocket activity | +| Response Speed | Performance of Realtime API endpoints | Infrastructure optimization opportunities | diff --git a/apps/docs/content/guides/storage/debugging/reports.mdx b/apps/docs/content/guides/storage/debugging/reports.mdx new file mode 100644 index 00000000000..17b92e563d7 --- /dev/null +++ b/apps/docs/content/guides/storage/debugging/reports.mdx @@ -0,0 +1,14 @@ +--- +title: 'Storage Reports' +description: 'Reports to help debug storage issues' +--- + +The Storage report provides visibility into how your Supabase Storage is being utilized, including request patterns, performance characteristics, and caching effectiveness. + +| Chart | Description | Key Insights | +| --------------- | ------------------------------------------ | ------------------------------------------------------ | +| Total Requests | Overall request volume to Storage | Traffic patterns and usage trends | +| Response Speed | Average response time for storage requests | Performance bottlenecks and optimization opportunities | +| Network Traffic | Ingress and egress usage | Data transfer costs and CDN effectiveness | +| Request Caching | Cache hit rates and miss patterns | CDN performance and cost optimization | +| Top Routes | Most frequently accessed storage paths | Popular content and usage patterns | diff --git a/apps/docs/content/guides/telemetry/reports.mdx b/apps/docs/content/guides/telemetry/reports.mdx index e835f985080..35c40864281 100644 --- a/apps/docs/content/guides/telemetry/reports.mdx +++ b/apps/docs/content/guides/telemetry/reports.mdx @@ -28,286 +28,3 @@ Reports can be filtered by time range to focus your analysis on specific periods | Last 28 days | ❌ | ❌ | ✅ | ✅ | --- - -<$Show if="billing:all"> - -## Database - -The Database report provides the most comprehensive view into your Postgres instance's health and performance characteristics. These charts help you identify performance bottlenecks, resource constraints, and optimization opportunities at a glance. - -The following charts are available for Free and Pro plans: - -| Chart | Available Plans | Description | Key Insights | -| ---------------------------- | --------------- | -------------------------------------------- | --------------------------------------------- | -| Memory usage | Free, Pro | RAM usage percentage by the database | Memory pressure and resource utilization | -| CPU usage | Free, Pro | Average CPU usage percentage | CPU-intensive query identification | -| Disk IOPS | Free, Pro | Read/write operations per second with limits | IO bottleneck detection and workload analysis | -| Database connections | Free, Pro | Number of pooler connections to the database | Connection pool monitoring | -| Shared Pooler connections | All | Client connections to the shared pooler | Shared pooler usage patterns | -| Dedicated Pooler connections | All | Client connections to PgBouncer | Dedicated pooler connection monitoring | - - - -{/* supa-mdx-lint-disable-next-line Rule001HeadingCase */} - -### Advanced Telemetry - -The following charts provide a more advanced and detailed view of your database performance and are available only for Teams and Enterprise plans. - -### Memory usage - -Memory usage chart - -| Component | Description | -| ------------------- | ------------------------------------------------------ | -| **Used** | RAM actively used by Postgres and the operating system | -| **Cache + buffers** | Memory used for page cache and Postgres buffers | -| **Free** | Available unallocated memory | - -How it helps debug issues: - -| Issue | Description | -| ------------------------------ | ------------------------------------------------ | -| Memory pressure detection | Identify when free memory is consistently low | -| Cache effectiveness monitoring | Monitor cache performance for query optimization | -| Memory leak detection | Detect inefficient memory usage patterns | - -Actions you can take: - -| Action | Description | -| --------------------------------------------------------------------------- | ---------------------------------------------- | -| [Upgrade compute size](/docs/guides/platform/compute-and-disk#compute-size) | Increase available memory resources | -| Optimize queries | Reduce memory consumption of expensive queries | -| Tune Postgres configuration | Improve memory management settings | -| Implement application caching | Add query result caching to reduce memory load | - -### CPU usage - -CPU usage chart - -| Category | Description | -| ---------- | ------------------------------------------------ | -| **System** | CPU time for kernel operations | -| **User** | CPU time for database queries and user processes | -| **IOWait** | CPU time waiting for disk/network IO | -| **IRQs** | CPU time handling interrupts | -| **Other** | CPU time for miscellaneous tasks | - -How it helps debug issues: - -| Issue | Description | -| ---------------------------------- | -------------------------------------------------- | -| CPU-intensive query identification | Identify expensive queries when User CPU is high | -| IO bottleneck detection | Detect disk/network issues when IOWait is elevated | -| System overhead monitoring | Monitor resource contention and kernel overhead | - -Actions you can take: - -| Action | Description | -| -------------------------------------------------------------- | --------------------------------------------------------------------------- | -| Optimize CPU-intensive queries | Target queries causing high User CPU usage | -| Address IO bottlenecks | Resolve disk/network issues when IOWait is high | -| [Upgrade compute size](/docs/guides/platform/compute-and-disk) | Increase available CPU capacity | -| Implement proper indexing | Use [query optimization](/docs/guides/database/postgres/indexes) techniques | - -### Disk input/output operations per second (IOPS) - -Disk IOPS chart - -This chart displays read and write IOPS with a reference line showing your compute size's maximum IOPS capacity. - -How it helps debug issues: - -| Issue | Description | -| --------------------------------- | ---------------------------------------------------------------- | -| Disk IO bottleneck identification | Identify when disk IO becomes a performance constraint | -| Workload pattern analysis | Distinguish between read-heavy vs write-heavy operations | -| Performance correlation | Spot disk activity spikes that correlate with performance issues | - -Actions you can take: - -| Action | Description | -| -------------------------------------------------------------- | --------------------------------------------------------- | -| Optimize indexing | Reduce high read IOPS through better query indexing | -| Consider read replicas | Distribute read-heavy workloads across multiple instances | -| Batch write operations | Reduce write IOPS by grouping database writes | -| [Upgrade compute size](/docs/guides/platform/compute-and-disk) | Increase IOPS limits with larger compute instances | - -### Disk IO Usage - -Disk IO Usage chart - -This chart displays the percentage of your allocated IOPS (Input/Output Operations Per Second) currently being used. - -How it helps debug issues: - -| Issue | Description | -| --------------------------- | ----------------------------------------------------------- | -| IOPS limit monitoring | Identify when approaching your allocated IOPS capacity | -| Performance correlation | Correlate high IO usage with application performance issues | -| Operation impact assessment | Monitor how database operations affect disk performance | - -Actions you can take: - -| Action | Description | -| -------------------------------------------------------------- | -------------------------------------------------- | -| Optimize disk-intensive queries | Reduce queries that perform excessive reads/writes | -| Add strategic indexes | Reduce sequential scans with appropriate indexing | -| [Upgrade compute size](/docs/guides/platform/compute-and-disk) | Increase IOPS limits with larger compute instances | -| Review database design | Optimize schema and query patterns for efficiency | - -### Disk size - -Disk Size chart - -| Component | Description | -| ------------ | --------------------------------------------------------- | -| **Database** | Space used by your actual database data (tables, indexes) | -| **WAL** | Space used by Write-Ahead Logging | -| **System** | Reserved space for system operations | - -How it helps debug issues: - -| Issue | Description | -| ----------------------------- | ------------------------------------------- | -| Space consumption monitoring | Track disk usage trends over time | -| Growth pattern identification | Identify rapid growth requiring attention | -| Capacity planning | Plan upgrades before hitting storage limits | - -Actions you can take: - -| Action | Description | -| -------------------------------------------------------------------------------- | -------------------------------------------------------------------- | -| Run [VACUUM](https://www.postgresql.org/docs/current/sql-vacuum.html) operations | Reclaim dead tuple space and optimize storage | -| Analyze large tables | Use CLI commands like `table-sizes` to identify optimization targets | -| Implement data archival | Archive historical data to reduce active storage needs | -| [Upgrade disk size](/docs/guides/platform/database-size) | Increase storage capacity when approaching limits | - -### Database connections - -Database connections chart - -| Connection Type | Description | -| --------------- | ------------------------------------------------ | -| **Postgres** | Direct connections from your application | -| **PostgREST** | Connections from the PostgREST API layer | -| **Reserved** | Administrative connections for Supabase services | -| **Auth** | Connections from Supabase Auth service | -| **Storage** | Connections from Supabase Storage service | -| **Other roles** | Miscellaneous database connections | - -How it helps debug issues: - -| Issue | Description | -| ------------------------------- | ----------------------------------------------------------- | -| Connection pool exhaustion | Identify when approaching maximum connection limits | -| Connection leak detection | Spot applications not properly closing connections | -| Service distribution monitoring | Monitor connection usage across different Supabase services | - -Actions you can take: - -| Action | Description | -| ------------------------------------------------------------------------------------------ | --------------------------------------------------------------- | -| [Upgrade compute size](/docs/guides/platform/compute-and-disk#compute-size) | Increase maximum connection limits | -| Implement [connection pooling](/docs/guides/database/connecting-to-postgres#shared-pooler) | Optimize connection management for high direct connection usage | -| Review application code | Ensure proper connection handling and cleanup | - -## Auth - -The Auth report focuses on user authentication patterns and behaviors within your Supabase project. - -| Chart | Description | Key Insights | -| ------------------------ | --------------------------------------------- | ----------------------------------------------- | -| Active Users | Count of unique users performing auth actions | User engagement and retention patterns | -| Sign In Attempts by Type | Breakdown of authentication methods used | Password vs OAuth vs magic link preferences | -| Sign Ups | Total new user registrations | Growth trends and onboarding funnel performance | -| Auth Errors | Error rates grouped by status code | Authentication friction and security issues | -| Password Reset Requests | Volume of password recovery attempts | User experience pain points | - -## Storage - -The Storage report provides visibility into how your Supabase Storage is being utilized, including request patterns, performance characteristics, and caching effectiveness. - -| Chart | Description | Key Insights | -| --------------- | ------------------------------------------ | ------------------------------------------------------ | -| Total Requests | Overall request volume to Storage | Traffic patterns and usage trends | -| Response Speed | Average response time for storage requests | Performance bottlenecks and optimization opportunities | -| Network Traffic | Ingress and egress usage | Data transfer costs and CDN effectiveness | -| Request Caching | Cache hit rates and miss patterns | CDN performance and cost optimization | -| Top Routes | Most frequently accessed storage paths | Popular content and usage patterns | - -## Realtime - -The Realtime report tracks WebSocket connections, channel activity, and real-time event patterns in your Supabase project. - -| Chart | Description | Key Insights | -| --------------------- | ------------------------------------------------------------- | ------------------------------------------------- | -| Realtime Connections | Active WebSocket connections over time | Concurrent user activity and connection stability | -| Channel Events | Breakdown of broadcast, Postgres changes, and presence events | Real-time feature usage patterns | -| Rate of Channel Joins | Frequency of new channel subscriptions | User engagement with real-time features | -| Total Requests | HTTP requests to Realtime endpoints | API usage alongside WebSocket activity | -| Response Speed | Performance of Realtime API endpoints | Infrastructure optimization opportunities | - -## Edge Functions - -The Edge Functions report provides insights into serverless function performance, execution patterns, and regional distribution across Supabase's global edge network. - -| Chart | Description | Key Insights | -| ---------------------- | ----------------------------------------- | ---------------------------------------------- | -| Execution Status Codes | Function response codes and error rates | Function reliability and error patterns | -| Execution Time | Average function duration and performance | Performance optimization opportunities | -| Invocations by Region | Geographic distribution of function calls | Global usage patterns and latency optimization | - -## API gateway - -The API Gateway report analyzes traffic patterns and performance characteristics of requests flowing through your Supabase project's API layer. - -| Chart | Description | Key Insights | -| --------------- | ----------------------------------------- | ------------------------------------------------ | -| Total Requests | Overall API request volume | Traffic patterns and growth trends | -| Response Errors | Error rates with 4XX and 5XX status codes | API reliability and user experience issues | -| Response Speed | Average API response times | Performance bottlenecks and optimization targets | -| Network Traffic | Request and response egress usage | Data transfer patterns and cost implications | -| Top Routes | Most frequently accessed API endpoints | Usage patterns and optimization priorities |