From cbea07edbff42d3fc457300bc26d6a01d68e155b Mon Sep 17 00:00:00 2001 From: Thomas <31189692+ecktoteckto@users.noreply.github.com> Date: Sun, 9 Feb 2025 15:47:20 +0100 Subject: [PATCH] docs(billing): revamp disk throughput usage --- .../NavigationMenu.constants.ts | 4 + .../guides/platform/manage-your-usage.mdx | 1 + .../manage-your-usage/disk-throughput.mdx | 74 +++++++++++++++++++ .../manage-your-usage/read-replicas.mdx | 4 +- 4 files changed, 81 insertions(+), 2 deletions(-) create mode 100644 apps/docs/content/guides/platform/manage-your-usage/disk-throughput.mdx diff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts index 4074740ef9e..fe909e1f8a0 100644 --- a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts +++ b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts @@ -2131,6 +2131,10 @@ export const platform: NavMenuConstant = { name: 'Disk Size', url: '/guides/platform/manage-your-usage/disk-size', }, + { + name: 'Disk Throughput', + url: '/guides/platform/manage-your-usage/disk-throughput', + }, { name: 'Edge Function Invocations', url: '/guides/platform/manage-your-usage/edge-function-invocations', diff --git a/apps/docs/content/guides/platform/manage-your-usage.mdx b/apps/docs/content/guides/platform/manage-your-usage.mdx index b09a6be1e4b..750b96a1fbc 100644 --- a/apps/docs/content/guides/platform/manage-your-usage.mdx +++ b/apps/docs/content/guides/platform/manage-your-usage.mdx @@ -12,6 +12,7 @@ Each subpage breaks down a specific usage item and details what you're charged f - [Storage Size](/docs/guides/platform/manage-your-usage/storage-size) - [Storage Image Transformations](/docs/guides/platform/manage-your-usage/storage-image-transformations) - [Disk Size](/docs/guides/platform/manage-your-usage/disk-size) +- [Disk Throughput](/docs/guides/platform/manage-your-usage/disk-throughput) - [Edge Function Invocations](/docs/guides/platform/manage-your-usage/edge-function-invocations) - [IPv4](/docs/guides/platform/manage-your-usage/ipv4) - [Custom Domains](/docs/guides/platform/manage-your-usage/custom-domains) diff --git a/apps/docs/content/guides/platform/manage-your-usage/disk-throughput.mdx b/apps/docs/content/guides/platform/manage-your-usage/disk-throughput.mdx new file mode 100644 index 00000000000..3784236bf86 --- /dev/null +++ b/apps/docs/content/guides/platform/manage-your-usage/disk-throughput.mdx @@ -0,0 +1,74 @@ +--- +id: 'manage-usage-disk-throughput' +title: 'Manage Disk Throughput usage' +--- + +## What you are charged for +Each database has a dedicated disk, and you are charged for its provisioned disk throughput. However, unless you explicitly opt in for additional throughput, no charges apply. + +Refer to our [disk guide](/docs/guides/platform/compute-and-disk#disk) for details on how disk throughput, disk IOPS, disk size, disk type and compute size interact, along with their limitations and constraints. + + + Launching a Read Replica creates an additional database with its own dedicated disk. Read Replicas inherit the primary database's disk throughput settings. You are charged for the provisioned throughput of the Read Replica. + + +## How charges are calculated +Disk throughput is charged by Mbps-Hrs (Mbps stands for Megabits per second). 1 Mbps-Hrs represents disk throughput of 1 Mbps being provisioned for 1 hour. For example, having 10 Mbps provisioned for 5 hours results in 50 Mbps-Hrs (10 Mbps × 5 hours). + +### Usage on your invoice +Usage is shown as "Disk Throughput Mbps-Hrs" on your invoice. + +## Pricing +Pricing depends on the [disk type](/docs/guides/platform/compute-and-disk#disk-types), with type gp3 being the default. + +### General purpose disks (gp3) +$0.00013 per Mbps-Hrs ($0.095 per Mbps per month). gp3 disks come with a baseline throughput of 125 Mbps. You are only charged for provisioned throughput exceeding these 125 Mbps. + +| Plan | Included Disk Throughput | Over-Usage per Mbps per month | Over-Usage per Mbps-Hrs | +|------------|--------------------------|-------------------------------|-------------------------| +| Pro | 125 Mbps | $0.095 | $0.00013 | +| Team | 125 Mbps | $0.095 | $0.00013 | +| Enterprise | Custom | Custom | Custom | + +### High performance disks (io2) +There are no charges. Throughput scales with IOPS at no additional cost. + +## Billing examples +### No additional throughput configured +| Line Item | Units | Costs | +|-------------------------------|-----------|---------| +| Pro Plan | 1 | $25 | +| | | | +| Compute Hours Micro Project 1 | 744 hours | $10 | +| Disk Throughput Project 1 | 125 Mbps | $0 | +| | | | +| **Subtotal** | | **$35** | +| Compute Credits | | -$10 | +| **Total** | | **$25** | + +### Additional throughput configured +| Line Item | Units | Costs | +|-------------------------------|-----------|-------------| +| Pro Plan | 1 | $25 | +| | | | +| Compute Hours Large Project 1 | 744 hours | $110 | +| Disk Throughput Project 1 | 200 Mbps | $7.13 | +| | | | +| **Subtotal** | | **$142.13** | +| Compute Credits | | -$10 | +| **Total** | | **$132.13** | + +### Additional throughput configured with Read Replica +| Line Item | Units | Costs | +|-------------------------------|-----------|-------------| +| Pro Plan | 1 | $25 | +| | | | +| Compute Hours Large Project 1 | 744 hours | $110 | +| Disk Throughput Project 1 | 200 Mbps | $7.13 | +| | | | +| Compute Hours Large Replica | 744 hours | $110 | +| Disk Throughput Replica | 200 Mbps | $7.13 | +| | | | +| **Subtotal** | | **$259.26** | +| Compute Credits | | -$10 | +| **Total** | | **$249.26** | \ No newline at end of file diff --git a/apps/docs/content/guides/platform/manage-your-usage/read-replicas.mdx b/apps/docs/content/guides/platform/manage-your-usage/read-replicas.mdx index 84be495338f..ce8366f3980 100644 --- a/apps/docs/content/guides/platform/manage-your-usage/read-replicas.mdx +++ b/apps/docs/content/guides/platform/manage-your-usage/read-replicas.mdx @@ -15,13 +15,13 @@ Compute is charged by the hour, meaning you are charged for the exact number of Read Replicas run on the same Compute size as the primary database. **Disk Size** -Refer to [Manage Disk Size usage]() for details on how charges are calculated. The disk size of a Read Replica is 1.25x the size of the primary disk to account for WAL archives. With a Read Replica you go beyond the subscription plan's free quota for Disk Size. +Refer to [Manage Disk Size usage](/docs/guides/platform/manage-your-usage/disk-size) for details on how charges are calculated. The disk size of a Read Replica is 1.25x the size of the primary disk to account for WAL archives. With a Read Replica you go beyond the subscription plan's free quota for Disk Size. **Provisioned Disk IOPS (optional)** Read Replicas inherit any additional provisioned Disk IOPS from the primary database. Refer to [Manage Disk IOPS usage]() for details on how charges are calculated. **Provisioned Disk Throughput (optional)** -Read Replicas inherit any additional provisioned Disk Throughput from the primary database. Refer to [Manage Disk Throughput usage]() for details on how charges are calculated. +Read Replicas inherit any additional provisioned Disk Throughput from the primary database. Refer to [Manage Disk Throughput usage](/docs/guides/platform/manage-your-usage/disk-throughput) for details on how charges are calculated. **IPv4 (optional)** If the primary database has a configured IPv4 address, its Read Replicas are also assigned one, with charges for each. Refer to [Manage IPv4 usage](/docs/guides/platform/manage-your-usage/ipv4) for details on how charges are calculated.