Skip to content

tidb-cloud: add description for Starter agent plan #22877

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lilin90 wants to merge 7 commits into
base: release-8.5
Choose a base branch
from
+14 −2
Open

tidb-cloud: add description for Starter agent plan #22877

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
f81980e
tidb-cloud: add a note for Starter agent plan
lilin90 May 12, 2026
64deae1
Update notification condition
lilin90 May 12, 2026
beaceea
Apply suggestions from code review
lilin90 May 13, 2026
08efd3f
Apply suggestions from code review
lilin90 May 13, 2026
bbb6d3f
Add branch count
lilin90 May 13, 2026
b7323fc
Update select-cluster-tier.md
lilin90 May 13, 2026
ab7ee26
Reorganize content and update branch page
lilin90 May 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion tidb-cloud/architecture-concepts.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,8 @@ TiDB Cloud makes it easy to scale your database, handle complex management tasks

The Starter plan is ideal for those who are getting started with TiDB Cloud. It provides developers and small teams with the following features:

- **No cost**: This plan is completely free, with no credit card required to get started.
- **No cost**: This plan is free when usage is within the [free quota](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). No credit card is required to get started.

- **Storage**: Provides an initial 5 GiB of row-based storage and 5 GiB of columnar storage.
- **Request Units**: Includes 50 million [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit-ru) for database operations.

Expand Down
4 changes: 4 additions & 0 deletions tidb-cloud/branch-overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,10 @@ Currently, TiDB Cloud branches are in beta and free of charge.

- For each organization in TiDB Cloud, you can create a maximum of five branches by default across all {{{ .starter }}} and Essential instances. The branches of a {{{ .starter }}} or Essential instance will be created in the same region as the instance, and you cannot create branches for a {{{ .starter }}} or Essential instance that is throttled or larger than 100 GiB.

> **Note:**
>
> To better support agent platform builders who need to create a large number of lightweight instances for their end users, TiDB Cloud offers the **Agent Plan**. With this plan, each TiDB Cloud organization can create up to 100 free {{{ .starter }}} instances in total, with each branch counted as a separate instance. To learn more, see the [Agent Plan](/tidb-cloud/select-cluster-tier.md#agent-plan).

- For each branch of a free {{{ .starter }}} instance, 10 GiB storage is allowed. For each branch of a {{{ .starter }}} instance with spending limit > 0, 100 GiB storage is allowed. Once the storage is reached, the read and write operations on this branch will be throttled until you reduce the storage.

- Branches are intended for short-term feature development and functional testing. Because branches lack auto-scaling capability, they are not suitable for performance testing.
Expand Down
9 changes: 8 additions & 1 deletion tidb-cloud/select-cluster-tier.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,8 @@

The free plan is ideal for those who are getting started with {{{ .starter }}}. It provides developers and small teams with the following essential features:

- **No cost**: This plan is completely free, with no credit card required to get started.
- **No cost**: This plan is free when usage is within the [free quota](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). No credit card is required to get started.

- **Storage**: Provides an initial 5 GiB of row-based storage and 5 GiB of columnar storage.
- **Request Units**: Includes 50 million [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit-ru) for database operations.

Expand All @@ -45,6 +46,12 @@

To learn more about the RU consumption of different resources (including read, write, SQL CPU, and network egress), the pricing details, and the throttled information, see [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starter-pricing-details/).

### Agent Plan

To better support agent platform builders who need to create a large number of lightweight instances for their end users, TiDB Cloud offers the **Agent Plan**. With this plan, each TiDB Cloud organization can create up to 100 free {{{ .starter }}} instances in total, with each [branch](/tidb-cloud/branch-overview.md) counted as a separate instance. To learn more and apply for the Agent Plan, fill out the [application form](https://www.pingcap.com/agent-plan/).

Check warning on line 51 in tidb-cloud/select-cluster-tier.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[PingCAP.Ambiguous] Consider using a clearer word than 'a large number of' because it may cause confusion.

Raw Output:
{"message": "[PingCAP.Ambiguous] Consider using a clearer word than 'a large number of' because it may cause confusion.", "location": {"path": "tidb-cloud/select-cluster-tier.md", "range": {"start": {"line": 51, "column": 62}}}, "severity": "INFO"}

You will receive an email notification once your application for the Agent Plan is approved. You will also be notified via email and the TiDB Cloud console when the total number of free {{{ .starter }}} instances (including branches) in your organization reaches 80 and 100.

## {{{ .essential }}} {#essential}

For applications experiencing growing workloads and needing scalability in real time, the Essential plan provides the flexibility and performance to keep pace with your business growth with the following features:
Expand Down
Loading