The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.
TypeScript aialternativeauthdatabasedenoembeddingsexamplefirebasenextjsoauth2pgvectorpostgispostgrespostgresqlpostgrestrealtimesupabasevectorswebsockets
feat(docs)add Logs Ingest + Logs Query manage-usage pages (#46095)
Steven Eubankf5c732b45787
diff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.tsindex 76847319bea..9c8f760b612 100644--- a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts+++ b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts@@ -2789,6 +2789,18 @@ export const platform: NavMenuConstant = {name: 'Branching',url: '/guides/platform/manage-your-usage/branching' as `/${string}`,},+ {+ name: 'Logs',+ url: '/guides/platform/manage-your-usage/logs' as `/${string}`,+ },+ {+ name: 'Logs Ingest',+ url: '/guides/platform/manage-your-usage/logs-ingest' as `/${string}`,+ },+ {+ name: 'Logs Query',+ url: '/guides/platform/manage-your-usage/logs-query' as `/${string}`,+ },{name: 'Log Drains',url: '/guides/platform/manage-your-usage/log-drains' as `/${string}`,diff --git a/apps/docs/content/_partials/billing/pricing/pricing_logs_ingest.mdx b/apps/docs/content/_partials/billing/pricing/pricing_logs_ingest.mdxnew file mode 100644index 00000000000..f089dfa717a--- /dev/null+++ b/apps/docs/content/_partials/billing/pricing/pricing_logs_ingest.mdx@@ -0,0 +1,9 @@+<Price price="0.50" /> per GB. You are only charged for usage exceeding your subscription plan's+quota.++| Plan | Quota | Over-Usage per GB |+| ---------- | ------ | ---------------------- |+| Free | 5 GB | - |+| Pro | 5 GB | <Price price="0.50" /> |+| Team | 5 GB | <Price price="0.50" /> |+| Enterprise | Custom | Custom |diff --git a/apps/docs/content/_partials/billing/pricing/pricing_logs_query.mdx b/apps/docs/content/_partials/billing/pricing/pricing_logs_query.mdxnew file mode 100644index 00000000000..1301aadb7a4--- /dev/null+++ b/apps/docs/content/_partials/billing/pricing/pricing_logs_query.mdx@@ -0,0 +1,9 @@+<Price price="0.002" /> per GB. You are only charged for usage exceeding your subscription plan's+quota.++| Plan | Quota | Over-Usage per GB |+| ---------- | -------- | ----------------------- |+| Free | 1,000 GB | - |+| Pro | 1,000 GB | <Price price="0.002" /> |+| Team | 1,000 GB | <Price price="0.002" /> |+| Enterprise | Custom | Custom |diff --git a/apps/docs/content/guides/platform/cost-control.mdx b/apps/docs/content/guides/platform/cost-control.mdxindex 95a247925d4..580e67fcb77 100644--- a/apps/docs/content/guides/platform/cost-control.mdx+++ b/apps/docs/content/guides/platform/cost-control.mdx@@ -34,6 +34,8 @@ When the Spend Cap is off, we recommend monitoring your usage and costs on the [- [Disk Size](/docs/guides/platform/manage-your-usage/disk-size)- [Egress](/docs/guides/platform/manage-your-usage/egress)- [Edge Function Invocations](/docs/guides/platform/manage-your-usage/edge-function-invocations)+- [Logs Ingest](/docs/guides/platform/manage-your-usage/logs-ingest)+- [Logs Query](/docs/guides/platform/manage-your-usage/logs-query)- [Monthly Active Users](/docs/guides/platform/manage-your-usage/monthly-active-users)- [Monthly Active SSO Users](/docs/guides/platform/manage-your-usage/monthly-active-users-sso)- [Monthly Active Third Party Users](/docs/guides/platform/manage-your-usage/monthly-active-users-third-party)diff --git a/apps/docs/content/guides/platform/manage-your-usage/logs-ingest.mdx b/apps/docs/content/guides/platform/manage-your-usage/logs-ingest.mdxnew file mode 100644index 00000000000..af40d0e9678--- /dev/null+++ b/apps/docs/content/guides/platform/manage-your-usage/logs-ingest.mdx@@ -0,0 +1,73 @@+---+id: 'manage-usage-logs-ingest'+title: 'Manage Logs Ingest usage'+---++<Admonition type="caution" title="Coming soon">++Logs pricing is being rolled out. Quotas and rates on this page are confirmed but billing enforcement is not yet live. This page will be updated when the rollout is complete.++</Admonition>++## What you are charged for++You are charged for the total volume of log data that Supabase ingests across all your project's services (Postgres, API gateway, Auth, Storage, Realtime, Edge Functions, etc.) during the billing cycle, measured in GB.++## How charges are calculated++Logs Ingest is charged per GB of log data ingested during the billing cycle.++### Usage on your invoice++Usage is shown as "Logs Ingest" on your invoice.++## Pricing++<$Partial path="billing/pricing/pricing_logs_ingest.mdx" />++## Billing examples++### Within quota++The organization's Logs Ingest usage is within the quota, so no charges for Logs Ingest apply.++| Line Item | Units | Costs |+| ------------------- | --------- | ------------------------ |+| Pro Plan | 1 | <Price price="25" /> |+| Compute Hours Micro | 744 hours | <Price price="10" /> |+| Logs Ingest | 2 GB | <Price price="0" /> |+| **Subtotal** | | **<Price price="35" />** |+| Compute Credits | | -<Price price="10" /> |+| **Total** | | **<Price price="25" />** |++### Exceeding quota++The organization's Logs Ingest usage exceeds the quota by 7 GB, incurring charges for this additional usage.++| Line Item | Units | Costs |+| ------------------- | --------- | -------------------------- |+| Pro Plan | 1 | <Price price="25" /> |+| Compute Hours Micro | 744 hours | <Price price="10" /> |+| Logs Ingest | 12 GB | <Price price="3.5" /> |+| **Subtotal** | | **<Price price="38.5" />** |+| Compute Credits | | -<Price price="10" /> |+| **Total** | | **<Price price="28.5" />** |++## View usage++You can view Logs Ingest usage on the [organization's usage page](/dashboard/org/_/usage) of the Dashboard. The page shows the usage of all projects by default. To view the usage for a specific project, select it from the dropdown. You can also select a different time period.++{/* TODO: Add screenshots once Studio surfaces are live */}++## Optimize usage++Every service in your Supabase project automatically generates Logs — you don't write them directly. Log volume scales with your application's traffic and behavior. To reduce ingest volume:++- **Reduce log-level verbosity** in your Edge Functions and server-side code (for example, `info` → `warn` in production).+- **Audit verbose logging in your application code.** Application-level logs forwarded to Supabase services count toward ingest.+- **Cap log payload size.** Large structured payloads inflate GB-billed volume quickly.+- **Investigate spikes.** Use the [**Logs Explorer**](/dashboard/project/_/logs-explorer) section of the Dashboard to find services or endpoints producing unusually high volume.++## Exceeding Quotas++<$Partial path="billing/exceeding_usage_quotas.mdx" />diff --git a/apps/docs/content/guides/platform/manage-your-usage/logs-query.mdx b/apps/docs/content/guides/platform/manage-your-usage/logs-query.mdxnew file mode 100644index 00000000000..6983989b27f--- /dev/null+++ b/apps/docs/content/guides/platform/manage-your-usage/logs-query.mdx@@ -0,0 +1,70 @@+---+id: 'manage-usage-logs-query'+title: 'Manage Logs Query usage'+---++<Admonition type="caution" title="Coming soon">++Logs pricing is being rolled out. Quotas and rates on this page are confirmed but billing enforcement is not yet live. This page will be updated when the rollout is complete.++</Admonition>++## What you are charged for++You are charged for the volume of log data scanned when you read logs via the Studio UI, the Management API, the CLI, or any other interface, measured in GB.++## How charges are calculated++Logs Query is charged per GB of log data scanned during the billing cycle.++### Usage on your invoice++Usage is shown as "Logs Query" on your invoice.++## Pricing++<$Partial path="billing/pricing/pricing_logs_query.mdx" />++## Billing examples++### Within quota++The organization's Logs Query usage is within the quota, so no charges for Logs Query apply.++| Line Item | Units | Costs |+| ------------------- | --------- | ------------------------ |+| Pro Plan | 1 | <Price price="25" /> |+| Compute Hours Micro | 744 hours | <Price price="10" /> |+| Logs Query | 300 GB | <Price price="0" /> |+| **Subtotal** | | **<Price price="35" />** |+| Compute Credits | | -<Price price="10" /> |+| **Total** | | **<Price price="25" />** |++### Exceeding quota++The organization's Logs Query usage exceeds the quota by 4,000 GB, incurring charges for this additional usage.++| Line Item | Units | Costs |+| ------------------- | --------- | ------------------------ |+| Pro Plan | 1 | <Price price="25" /> |+| Compute Hours Micro | 744 hours | <Price price="10" /> |+| Logs Query | 5,000 GB | <Price price="8" /> |+| **Subtotal** | | **<Price price="43" />** |+| Compute Credits | | -<Price price="10" /> |+| **Total** | | **<Price price="33" />** |++## View usage++You can view Logs Query usage on the [organization's usage page](/dashboard/org/_/usage) of the Dashboard. The page shows the usage of all projects by default. To view the usage for a specific project, select it from the dropdown. You can also select a different time period.++{/* TODO: Add screenshots once Studio surfaces are live */}++## Optimize usage++- **Narrow your query time ranges.** Querying a 7-day window scans 7× more data than a 1-day window.+- **Use filters early.** Adding service or endpoint filters reduces the volume scanned.+- **Be cautious with programmatic log access.** Polling the logs API frequently from scripts, agents, or third-party integrations can inflate query GB rapidly. If you need to stream logs continuously, [Log Drains](/docs/guides/platform/manage-your-usage/log-drains) are a more cost-effective option than repeated queries.++## Exceeding Quotas++<$Partial path="billing/exceeding_usage_quotas.mdx" />diff --git a/apps/docs/content/guides/platform/manage-your-usage/logs.mdx b/apps/docs/content/guides/platform/manage-your-usage/logs.mdxnew file mode 100644index 00000000000..26a334c289e--- /dev/null+++ b/apps/docs/content/guides/platform/manage-your-usage/logs.mdx@@ -0,0 +1,32 @@+---+id: 'manage-usage-logs'+title: 'Manage Logs usage'+---++<Admonition type="caution" title="Coming soon">++Logs pricing is being rolled out. Quotas and rates on this page are confirmed but billing enforcement is not yet live. This page will be updated when the rollout is complete.++</Admonition>++Logs usage is metered on two SKUs:++- **Logs Ingest** — the total GB of log data Supabase ingests across all your project's services (Postgres, API gateway, Auth, Storage, Realtime, Edge Functions, etc.) during the billing cycle.+- **Logs Query** — the total GB of log data scanned when you read logs via the Studio UI, the Management API, the CLI, or any other interface.++Each plan includes a free quota for both. Usage beyond the quota is billed per GB.++| SKU | Included (per month) | Over-Usage (Pro, Team) |+| ----------- | -------------------- | ------------------------------ |+| Logs Ingest | 5 GB | <Price price="0.50" /> per GB |+| Logs Query | 1,000 GB | <Price price="0.002" /> per GB |+| Enterprise | Custom | Custom |++For full billing details, invoice examples, and optimization tips, see the per-SKU pages:++- [Manage Logs Ingest usage](/docs/guides/platform/manage-your-usage/logs-ingest)+- [Manage Logs Query usage](/docs/guides/platform/manage-your-usage/logs-query)++## Logs vs log drains++[Log Drains](/docs/guides/platform/manage-your-usage/log-drains) stream logs out of Supabase to external destinations (Datadog, Better Stack, your own S3 bucket, etc.) and are billed separately on drain hours and events. Draining logs does not replace or reduce Logs Ingest charges — ingest is metered when Supabase processes your logs, drains are metered when Supabase streams them out. These are separate billing primitives, not overlapping charges.diff --git a/apps/docs/content/guides/telemetry/logs.mdx b/apps/docs/content/guides/telemetry/logs.mdxindex c8957dd2465..ad999526a22 100644--- a/apps/docs/content/guides/telemetry/logs.mdx+++ b/apps/docs/content/guides/telemetry/logs.mdx@@ -4,7 +4,7 @@ title: 'Logging'description: 'Getting started with Supabase Log Browser'----The Supabase Platform includes a Logs Explorer that allows log tracing and debugging. Log retention is based on your [project's pricing plan](/pricing).+The Supabase Platform includes a Logs Explorer that allows log tracing and debugging. Log retention is based on your [project's pricing plan](/pricing). For details on how Logs usage is billed, see [Manage Logs usage](/docs/guides/platform/manage-your-usage/logs).## Product logsdiff --git a/supa-mdx-lint/Rule003Spelling.toml b/supa-mdx-lint/Rule003Spelling.tomlindex 69eedcf2661..09cbdba4640 100644--- a/supa-mdx-lint/Rule003Spelling.toml+++ b/supa-mdx-lint/Rule003Spelling.toml@@ -172,6 +172,7 @@ allow_list = ["Authn","Authy","B-tree",+ "Better Stack","Basejump","BigQuery","Bitbucket",