mirror of
https://github.com/supabase/supabase.git
synced 2026-10-06 09:55:06 +03:00
f5c732b457
## Summary Adds documentation for the new Logs pricing SKUs (Ingest and Query) ahead of the July 1 launch. Part of the [O11Y Logs Pricing RFC](https://linear.app/supabase/project/rfc-supabase-observability-product-packaging-and-pricing-77990c05a767) rollout (PRD R6). **This is the docs PR.** Pricing page changes (`apps/www`) and Studio dashboard changes are separate PRs. ### New pages - **Logs overview** (`manage-your-usage/logs.mdx`) — both SKUs at a glance, summary pricing table, Logs vs Log Drains clarification - **Logs Ingest detail** (`manage-your-usage/logs-ingest.mdx`) — full billing details, invoice examples, optimization tips - **Logs Query detail** (`manage-your-usage/logs-query.mdx`) — full billing details, invoice examples, optimization tips - **Pricing partials** for both SKUs (`pricing_logs_ingest.mdx`, `pricing_logs_query.mdx`) ### Updated pages - **Cost control** — added Logs Ingest + Logs Query to "Usage items covered by the Spend Cap" list - **Telemetry/logs** — added link to the new manage-usage overview page - **Navigation sidebar** — added Logs, Logs Ingest, Logs Query entries before Log Drains ### Notes - Screenshots are marked as TODO placeholders — will be added once Studio surfaces are live - Follows the existing manage-usage page pattern (storage-size, MAU, etc.) - Canonical pricing: Ingest $0.50/GB over 5 GB, Query $0.002/GB over 1,000 GB (Free/Pro/Team) ## Test plan - [x] Verify pages render at `/docs/guides/platform/manage-your-usage/logs`, `/logs-ingest`, `/logs-query` - [x] Verify sidebar navigation shows new entries - [x] Verify cost-control page lists both items under "covered by Spend Cap" - [x] Verify `<$Partial />` pricing tables render correctly - [x] Verify telemetry/logs page shows new billing link - [x] Verify no broken links 🤖 Generated with [Claude Code](https://claude.com/claude-code) <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Documentation** * Added guides for managing Logs, Logs Ingest, and Logs Query usage with pricing, billing scenarios, quota examples, and optimization tips * Added Platform → Billing navigation items: Logs, Logs Ingest, Logs Query * Included overage pricing tables, Spend Cap coverage updates, “Coming soon” billing caveats, clarified Logs vs. Log Drains, and linked usage management from the Logging guide * **Chore** * Whitelisted "Better Stack" in spelling checks <!-- review_stack_entry_start --> [](https://app.coderabbit.ai/change-stack/supabase/supabase/pull/46095?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack) <!-- review_stack_entry_end --> <!-- end of auto-generated comment: release notes by coderabbit.ai --> --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>
74 lines
4.2 KiB
Plaintext
74 lines
4.2 KiB
Plaintext
---
|
|
id: 'cost-control'
|
|
title: 'Control your costs'
|
|
---
|
|
|
|
## Spend Cap
|
|
|
|
The Spend Cap determines whether your organization can exceed your subscription plan's quota for any usage item. Scenarios that could lead to high usage—and thus high costs—include system attacks or bugs in your software. The Spend Cap can protect you from these unexpected costs for certain usage items.
|
|
|
|
This feature is available only with the Pro Plan. However, you will not be charged while using the Free Plan.
|
|
|
|
### What happens when the Spend Cap is on?
|
|
|
|
After exceeding the quota for a usage item, further usage of that item is disallowed until the next billing cycle. You don't get charged for over-usage but your services will be restricted according to our [Fair Use Policy](/docs/guides/platform/billing-faq#fair-use-policy) if you consistently exceed the quota.
|
|
|
|
<Admonition type="note">
|
|
|
|
Note that only certain usage items are covered by the Spend Cap.
|
|
|
|
</Admonition>
|
|
|
|
### What happens when the Spend Cap is off?
|
|
|
|
Your projects will continue to operate after exceeding the quota for a usage item. Any additional usage will be charged based on the item's cost per unit, as outlined on the [pricing page](/pricing).
|
|
|
|
<Admonition type="note">
|
|
|
|
When the Spend Cap is off, we recommend monitoring your usage and costs on the [organization's usage page](/dashboard/org/_/usage).
|
|
|
|
</Admonition>
|
|
|
|
### Usage items covered by the Spend Cap
|
|
|
|
- [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)
|
|
- [Realtime Messages](/docs/guides/platform/manage-your-usage/realtime-messages)
|
|
- [Realtime Peak Connections](/docs/guides/platform/manage-your-usage/realtime-peak-connections)
|
|
- [Storage Image Transformations](/docs/guides/platform/manage-your-usage/storage-image-transformations)
|
|
- [Storage Size](/docs/guides/platform/manage-your-usage/storage-size)
|
|
|
|
### Usage items not covered by the Spend Cap
|
|
|
|
Usage items that are predictable and explicitly opted into by the user are excluded.
|
|
|
|
- [Compute](/docs/guides/platform/manage-your-usage/compute)
|
|
- [Branching Compute](/docs/guides/platform/manage-your-usage/branching)
|
|
- [Read Replica Compute](/docs/guides/platform/manage-your-usage/read-replicas)
|
|
- [Custom Domain](/docs/guides/platform/manage-your-usage/custom-domains)
|
|
- Additionally provisioned [Disk IOPS](/docs/guides/platform/manage-your-usage/disk-iops)
|
|
- Additionally provisioned [Disk Throughput](/docs/guides/platform/manage-your-usage/disk-throughput)
|
|
- [IPv4 address](/docs/guides/platform/manage-your-usage/ipv4)
|
|
- [Log Drain Hours](/docs/guides/platform/manage-your-usage/log-drains#log-drain-hours)
|
|
- [Log Drain Events](/docs/guides/platform/manage-your-usage/log-drains#log-drain-events)
|
|
- [Multi-Factor Authentication Phone](/docs/guides/platform/manage-your-usage/advanced-mfa-phone)
|
|
- [Point-in-Time-Recovery](/docs/guides/platform/manage-your-usage/point-in-time-recovery)
|
|
|
|
### What the Spend Cap is not
|
|
|
|
The Spend Cap doesn't allow for fine-grained cost control, such as setting budgets for specific usage item or receiving notifications when certain costs are reached. We plan to make cost control more flexible in the future.
|
|
|
|
### Configure the Spend Cap
|
|
|
|
You can configure the Spend Cap when creating an organization on the Pro Plan or at any time in the Cost Control section of the [organization's billing page](/dashboard/org/_/billing).
|
|
|
|
## Keep track of your usage and costs
|
|
|
|
You can monitor your usage on the [organization's usage page](/dashboard/org/_/usage). The Upcoming Invoice section of the [organization's billing page](/dashboard/org/_/billing) shows your current spending and provides an estimate of your total costs for the billing cycle based on your usage.
|