Skip to content

Commit

Permalink
[DOC-10386][DOC-11063] Update Plan a Standard Cluster, Cloud landing …
Browse files Browse the repository at this point in the history
…page
  • Loading branch information
mdlinville committed Sep 21, 2024
1 parent 75bfcbf commit 3991f00
Show file tree
Hide file tree
Showing 4 changed files with 305 additions and 128 deletions.
6 changes: 4 additions & 2 deletions src/current/cockroachcloud/basic-cluster-management.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,11 +35,13 @@ The monthly cost estimate is calculated using simple extrapolation that assumes

## Edit cluster capacity

On the **Overview** page, you can edit your resource limits. Changes apply to the current and future billing cycles. For more details, refer to [Plan a CockroachDB {{ site.data.products.basic }} cluster]({% link cockroachcloud/plan-your-cluster-basic.md %}).
The price-performance characteristics of CockroachDB {{ site.data.products.basic }} vary significantly depending on the workload. It can be difficult to estimate a workload's compute requirements in advance. To increase or decrease a cluster's capacity:

1. In the **Capacity used this month** section of your cluster's [**Overview** page]({% link cockroachcloud/cluster-overview-page.md %}), click **Update capacity**.

1. On the **Capacity** page, set the configure the new resource limits. In the sidebar, click **Update cluster**.
1. On the **Capacity** page, edit the resource limits. In the sidebar, click **Update cluster**.

Changes apply to the current and future billing cycles. For more details, refer to [Plan a CockroachDB {{ site.data.products.basic }} cluster]({% link cockroachcloud/plan-your-cluster-basic.md %}).

## Edit regions

Expand Down
6 changes: 5 additions & 1 deletion src/current/cockroachcloud/cluster-management.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,8 @@ From the **Overview** page, you can connect to your cluster. For more informatio

## Edit cluster capacity

The price-performance characteristics of CockroachDB {{ site.data.products.standard }} vary significantly depending on the workload. It can be difficult to estimate a workload's compute requirements in advance. To increase or decrease a cluster's provisioned capacity:

To edit your cluster's capacity:

1. Navigate to the cluster's **Overview** page.
Expand All @@ -46,11 +48,13 @@ To edit your cluster's capacity:
1. Enter the desired number of request units per second or use the slider to increase or decrease the request units per second.

{{site.data.alerts.callout_success}}
You can decrease the provisioned capacity only three times within a 7-day period.
You can decrease the provisioned capacity only three times within a 7-day period. You can increase the provisioned capacity at any time.
{{site.data.alerts.end}}

1. In the sidebar, verify the new estimated cost for the cluster and click **Update cluster**.

To learn more, refer to [Plan a CockroachDB {{ site.data.products.standard }} cluster]({% link plan-your-cluster.md %}#provisioned-capacity).

## Manage cluster upgrades

By default, major-version and patch upgrades are automatically applied to CockroachDB {{ site.data.products.standard }} clusters. To control when a cluster is upgraded to a new major version, you can disable automatic major-version upgrades. Patch upgrades are always applied automatically.
Expand Down
243 changes: 239 additions & 4 deletions src/current/cockroachcloud/index.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,247 @@
---
title: CockroachDB Cloud Docs
summary: CockroachDB Cloud is a fully hosted and fully managed service created and owned by Cockroach Labs that makes deploying, scaling, and managing CockroachDB effortless.
toc: false
contribute: false
title: CockroachDB Cloud docs
summary: Learn more about CockroachDB Cloud, a fully-managed service created and owned by Cockroach Labs that makes deploying, scaling, and managing CockroachDB effortless.
toc: true
contribute: true
cta: false
homepage: true
docs_area:
---

## Overview

CockroachDB {{ site.data.products.cloud }} is a fully-managed service run by Cockroach Labs, which simplifies deployment and management of CockroachDB deployments. This page provides an introduction to CockroachDB {{ site.data.products.cloud }} provides an overview of each type of cluster: CockroachDB {{ site.data.products.standard }}, CockroachDB {{ site.data.products.basic }}, and CockroachDB {{ site.data.products.advanced }}.

To get started right away, you can [sign up for a CockroachDB {{ site.data.products.cloud }} account](https://cockroachlabs.cloud) and [create a cluster]({% link cockroachcloud/create-your-cluster.md %}) using [trial credits]({% link cockroachcloud/billing-management.md %}#view-credits-balance).

## Plans

When you create a cluster in CockroachDB {{ site.data.products.cloud }}, you select its plan. A CockroachDB {{ site.data.products.cloud }} organization can include clusters of each plan. This section provides an overview of each plan. For a more detailed comparison, refer to [Compare plans](#compare-plans).

- **CockroachDB {{ site.data.products.basic }}**: TODO

- **CockroachDB {{ site.data.products.standard }}**: TODO

- ** CockroachDB {{ site.data.products.advanced }}**: TODO

## Compare plans

This section summarizes key details about each plan to help you make the best choice for each cluster and its workload. For more details, refer to:

- [Plan a CockroachDB {{ site.data.products.basic }} cluster]({% link cockroachcloud/plan-a-basic-cluster.md %})
- [Plan a CockroachDB {{ site.data.products.standard }} cluster]({% link cockroachcloud/plan-your-cluster.md %})
- [Plan a CockroachDB {{ site.data.products.advanced }} cluster]({% link cockroachcloud/plan-an-advanced-cluster.md %})

<table markdown="1">
<thead>
<tr>
<td>&nbsp;</td>
<td>**CockroachDB {{ site.data.products.basic }}**<br />Usage-based billing only</td>
<td>**CockroachDB {{ site.data.products.standard }}**<br />Provisioned compute, usage-based storage, data transfer, backups, and Change Data Capture (CDC)</td>
<td>**CockroachDB {{ site.data.products.advanced }}**<br />Provisioned compute, storage, and IOPS with usage-based billing for data transfer, backups, and CDC</td>
</tr>
</thead>
<tbody>
<tr>
<td>[Compute](#compute)</td>
<td>Usage-based via [Request Units]({% link cockroachcloud/create-a-basic-cluster.md %}#edit-cluster-capacity)</td>
<td>Provisioned; cost per hour based on [vCPU quantity, cloud provider, and regions]({% link cockroachcloud/create-your-cluster.md %}#edit-cluster-capacity).</td>
<td>Provisioned; cost per hour per node based on [vCPU quantity, cloud provider, and region]({% link cockroachcloud/create-an-advanced-cluster.md %}#edit-cluster-capacity)</td>
</tr>
<tr>
<td>IOPS</td>
<td>Usage-based via Request Units</td>
<td>Factored into storage costs</td>
<td>Provisioned based on storage costs and varies per cloud provider</td>
</tr>
<tr>
<td>Data storage</td>
<td>Usage-based
<td>Usage-based, varies per cloud provider and region</td>
<td>Provisioned; billed per hour per node and varies per cloud provider and region</td>
</tr>
<tr>
<td>Managed backup storage</td>
<td>Daily backups included in Request Unit costs</td>
<td>Usage-based, varies per cloud provider and region.<br /><br />Currently not charged during [Usage-based backup metrics Preview]({% link {{ site.current_cloud_version}}/essential-metrics.md %}#backup-and-restore).</td>
<td>Usage-based, varies per cloud provider and region.<br /><br />Currently not charged during [Usage-based backup metrics Preview]({% link {{ site.current_cloud_version}}/essential-metrics.md %}#backup-and-restore).</td>
</tr>
<tr>
<td>[Data transfer](#data-transfer)</td>
<td>Usage-based via Request Units</td>
<td>Usage-based; cloud provider list price<br /><br />Currently not charged during [Usage-based backup metrics Preview]({% link {{ site.current_cloud_version}}/essential-metrics.md %}#backup-and-restore)</td>
<td>Usage-based; cloud provider list price<br /><br />Currently not charged during [Usage-based backup metrics Preview]({% link {{ site.current_cloud_version}}/essential-metrics.md %}#backup-and-restore)</td>
</tr>
<tr>
<td>[Change Data Capture]({% link {{site.current_cloud_version}}/change-data-capture-overview.md %})</td>
<td>Usage-based via Request Units</td>
<td>Usage-based.<br /><br />Currently not charged during [Usage-based backup metrics Preview]({% link {{ site.current_cloud_version}}/essential-metrics.md %}#backup-and-restore)</td>
<td>Usage-based.<br /><br />Currently not charged during [Usage-based backup metrics Preview]({% link {{ site.current_cloud_version}}/essential-metrics.md %}#backup-and-restore)</td>
</tr>
</tbody>
</table>

To learn more about pricing in CockroachDB {{ site.data.products.cloud }}, refer to [Pricing](https://www.cockroachlabs.com/pricing/).

## More details

This section supplements the details in [Compare plans](#compare-plans). Select a plan to learn more.

<div class="filters clearfix">
<button class="filter-button" data-scope="basic">CockroachDB {{ site.data.products.basic }}</button>
<button class="filter-button" data-scope="standard">CockroachDB {{ site.data.products.standard }}</button>
<button class="filter-button" data-scope="advanced">CockroachDB {{ site.data.products.advanced }}</button>
</div>

### Compute

<section class="filter-content" markdown="1" data-scope="basic">

For CockroachDB {{ site.data.products.basic }}, compute is usage-based and calculated in Request Units.

</section>

<section class="filter-content" markdown="1" data-scope="standard">

A CockroachDB {{ site.data.products.standard }} cluster's provisioned compute capacity is configured when the cluster is created and can be modified over time. This capacity represents the peak processing power the deployment can handle at any given time.

Provisioned compute is calculated in vCPU-hours, with rates depending on the cloud provider and the region. Billing is based on the capacity reserved, not the actual usage. Charges are accumulated throughout the month to determine the total monthly compute charges.

In a multi-region cluster, the price of the most expensive region is applied to the entire cluster’s compute capacity. The compute cost is calculated by multiplying the total provisioned capacity by the highest rate per vCPU-hour among all regions.

Refer to [Pricing](https://www.cockroachlabs.com/pricing/).

</section>

<section class="filter-content" markdown="1" data-scope="advanced">

Each node of a CockroachDB {{ site.data.products.advanced }} cluster is provisioned with dedicated vCPU resources. You can [customize]({% link create-an-advanced-cluster.md %}#step-5-configure-cluster-capacity) the number of vCPUs per node. This configuration applies to all nodes in the cluster. Compute costs are based on the vCPUs provisioned for each node, at rates that vary rates depending on the cloud provider and region.

Compute charges are calculated hourly by multiplying the hourly rate of the provisioned compute per node and number of nodes per cluster. These charges are accumulated throughout the month to determine the total monthly compute charges. When you configure your cluster's capacity, you are implicitly selecting a _machine type_ offered by the cloud provider. Different machine types are billed at different rates. The hourly compute cost is calculated by multiplying the hourly rate of the machine type by the number of nodes.

Refer to [Pricing](https://www.cockroachlabs.com/pricing/).

</section>

### Storage

{{site.data.alerts.callout_info}}
There is no charge for backup storage during [Usage-based backup metrics Preview]({% link {{ site.current_cloud_version}}/essential-metrics.md %}#backup-and-restore)
{{site.data.alerts.end}}

<section class="filter-content" markdown="1" data-scope="basic">

Storage for CockroachDB {{ site.data.products.basic }} is automatically provisioned on demand, eliminating the need for manual management. Costs are based on actual usage and adjust dynamically as data is added or removed, starting from zero.

Storage is billed hourly, with [rates](https://www.cockroachlabs.com/pricing) depending on the cloud provider and the region where the cluster is hosted.{% comment %}TODO: Resolve this contradiction. https://cockroachlabs.slack.com/archives/C05KHQULKFB/p1726955009576009{% endcomment %}

</section>

<section class="filter-content" markdown="1" data-scope="standard">

Storage for CockroachDB {{ site.data.products.standard }} is automatically provisioned on demand, eliminating the need for manual management. Costs are based on actual usage and adjust dynamically as data is added or removed, starting from zero.

A CockroachDB {{ site.data.products.standard }} cluster maintains a minimum of three replicas of your data, which are maintained at no additional cost. If you add further replicas, each will incur a storage cost equal to that of the logical database size. For more details, refer to [Plan a CockroachDB {{ site.data.products.standard }} cluster]({% link cockroachcloud/plan-your-cluster.md %}).

Storage is billed hourly, with [rates](https://www.cockroachlabs.com/pricing) specific to each cloud provider and the region where the cluster is hosted. CockroachDB {{ site.data.products.cloud }} measures storage in GiB-hour. Hourly storage charges are accumulated throughout the month to determine the total monthly storage charges.

</section>

<section class="filter-content" markdown="1" data-scope="advanced">

Each CockroachDB {{ site.data.products.advanced }} cluster is provisioned with dedicated storage, configured when the cluster is created. The storage configuration applies to all nodes in the cluster. Storage is billed hourly, with [rates](https://www.cockroachlabs.com/pricing) depending on the cluster's cloud provider and regions. Storage costs are independent of compute costs, and you can adjust your cluster's storage capacity without altering its vCPU or memory configurations. Refer to [Plan a CockroachDB {{ site.data.products.advanced }} cluster]({% link cockroachcloud/plan-an-advanced-cluster.md %}).

- **AWS**: For CockroachDB {{ site.data.products.advanced }} on AWS, storage charges are calculated per hour by multiplying the storage size in GiB by the hourly rate charged by AWS, plus any additional charges for IOPS.
- **GCP and Azure**: For CockroachDB {{ site.data.products.advanced }} on GCP or Azure, storage charges are calculated per hour by multiplying the storage size in GiB by the hourly rate charged by the cloud provider, with no additional fees for IOPS.

Hourly storage charges are accumulated throughout the month to determine the total monthly storage charges.

</section>

### Data transfer

{{site.data.alerts.callout_info}}
There is no charge for data transfer during [Usage-based backup metrics Preview]({% link {{ site.current_cloud_version}}/essential-metrics.md %}#backup-and-restore)
{{site.data.alerts.end}}

<section class="filter-content" markdown="1" data-scope="basic">
For CockroachDB {{ site.data.products.basic }}, data transfer is included in the Request Unit price.
</section>

{% capture standard_and_advanced_data_transfer %}
The usage data is based on the volume of data transferred (per GiB), using the cloud provider's rate for the type of data transfer: to the same region, across regions, or across the public internet.
{% endcapture %}

{% capture standard_and_advanced_cross_and_public %}
- **Cross-region**: When data is transferred from one region to another, this incurs additional cross-region charges, also known as inter-region charges. Data transfer across regions typically incurs higher costs than same-region transfer.
- **Public internet**: When data, manual backups, or logs are transferred or exported out of your cluster to SQL clients, third-party tools or storage, it is classified as public-internet data transfer.
{% endcapture %}

Cloud providers may calculate each category differently. Refer to the documentation for the Cloud provider (AWS, GCP, or Azure).
{% endcapture %}

<section class="filter-content" markdown="1" data-scope="standard">
For CockroachDB {{ site.data.products.standard }}, data transfer is billed based on usage.

{{ standard_and_advanced_data_transfer }}

- **Same-region**: CockroachDB {{ site.data.products.standard }} stores data in three availability zones (AZs) per region. Data transfer among the AZs in the same region is classified as same-region data transfer.
{{ standard_and_advanced_cross_and_public }}

</section>

<section class="filter-content" markdown="1" data-scope="advanced">
For CockroachDB {{ site.data.products.advanced }}, data transfer is billed based on usage.

{{ standard_and_advanced_data_transfer }}

- **Same-region**: CockroachDB {{ site.data.products.advanced }} requires a minimum of three nodes per region, in three availability zones (AZs). Data transfer among the AZs in the same region is classified as same-region data transfer.
{{ standard_and_advanced_cross_and_public }}

</section>

### Changefeeds

All CockroachDB {{ site.data.products.cloud }} clusters can use [Enterprise Changefeeds](% link {{ site.current_cloud_version}}/how-does-an-enterprise-changefeed-work.md %).

{{site.data.alerts.callout_info}}
There is no charge for changefeeds during [Usage-based backup metrics Preview]({% link {{ site.current_cloud_version}}/essential-metrics.md %}#backup-and-restore)
{{site.data.alerts.end}}

<section class="filter-content" markdown="1" data-scope="basic">

In CockroachDB {{ site.data.products.basic }}, Change Data Capture is included in the Request Unit price.
</section>

<section class="filter-content" markdown="1" data-scope="standard">

In CockroachDB {{ site.data.products.standard }}, Change Data Capture is billed monthly based on usage, and is calculated monthly based on the total GiB watched across all of a cluster's changefeeds, with the following thresholds:

- &lt; 5 GiB/month
- 5-100 GiB/month
- 100-250 GiB/month
- &gt; 250 GiB/month

</section>

<section class="filter-content" markdown="1" data-scope="advanced">

In CockroachDB {{ site.data.products.standard }}, Change Data Capture is billed monthly based on usage, and is calculated monthly based on the total GiB watched across all of a cluster's changefeeds, with the following thresholds:

- &lt; 5 GiB/month
- 5-100 GiB/month
- 100-250 GiB/month
- &gt; 250 GiB/month

</section>

## Next steps

- [Plan a CockroachDB {{ site.data.products.basic }} cluster]({% link cockroachcloud/plan-a-basic-cluster.md %}) and [Create a CockroachDB {{ site.data.products.basic }} cluster]({% link cockroachcloud/create-a-basic-cluster.md %}).
- [Plan a CockroachDB {{ site.data.products.standard }} cluster]({% link cockroachcloud/plan-your-cluster.md %}) and [Create a CockroachDB {{ site.data.products.standard }} cluster]({% link create-your-cluster.md %})
- [Plan a CockroachDB {{ site.data.products.advanced }} cluster]({% link cockroachcloud/plan-an-advanced-cluster.md %}) and [Create a CockroachDB {{ site.data.products.advanced }} cluster]{% link cockroachcloud/create-an-advanced-cluster.md %}

{% comment %}Old content below
<div class="home-header mb-xl-5 bg-cover bg-cover__bg-gradient-purple-blue">
<div class="p-2 p-md-5">
<h1 class="m-0 text-white">CockroachDB Cloud Docs</h1>
Expand Down Expand Up @@ -150,3 +384,4 @@ docs_area:
</div>

</div>
{% endcomment %}
Loading

0 comments on commit 3991f00

Please sign in to comment.