docs: Document limits, incl. for Query History (#6690)

* docs: Document limits, incl. for Query History

* Better wording

Author: igorlukanin

docs/content/Deployment/Cloud/Deployment-Types.mdx

@@ -33,11 +33,11 @@ query pre-aggregations on-demand.
 Development Instances do not provide high-availability nor do they guarantee
 fast response times. Development Instances also hibernate after 60 minutes of
 inactivity, which can cause the first request after hibernation to take
-additional time to process. They also have a 10,000 queries per day limit, and
-are limited to a maximum of 2 Cube Store Workers. We **strongly** advise not
-using a development instance in a production environment, it is for testing and
-learning about Cube only and will not deliver a production-level experience for
-your users.
+additional time to process. They also have [limits][ref-limits] on the maximum
+number of queries per day and the maximum number of Cube Store Workers. We
+**strongly** advise not using a development instance in a production environment,
+it is for testing and learning about Cube only and will not deliver a
+production-level experience for your users.
 
 You can try a Cube Cloud development instance by
 [signing up for Cube Cloud](https://cubecloud.dev/auth/signup) to try it free
@@ -66,7 +66,7 @@ workloads. It consists of several key components, including starting with 2 Cube
 API instances, 1 Cube Refresh Worker and 2 Cube Store Routers - all of which run
 on dedicated infrastructure. The cluster can automatically scale to meet the
 needs of your workload by adding more components as necessary; check the
-[Limits section](#limits) below.
+[Scalability section](#scalability) below.
 
 ## Production multi-cluster
 
@@ -97,24 +97,20 @@ Cube Cloud routes traffic between clusters based on
 Each cluster is billed separately, and all clusters can use auto-scaling to
 match demand.
 
-## Limits
+## Scalability
 
 Cube Cloud also allows adding additional infrastructure to your deployment to
 increase scalability and performance beyond what is available with each
 Production Deployment.
 
-### <--{"id" : "Limits"}--> Cube Store Worker
-
-|                           | Free Tier | Starter | Premium | Enterprise |        Enterprise Premier        |
-| ------------------------- | :-------: | :-----: | :-----: | :--------: | :------------------------------: |
-| Maximum number of workers |     2     |   16    |   16    |     16     | [Talk to Sales][cube-contact-us] |
+### <--{"id" : "Scalability"}--> Cube Store Worker
 
 Cube Store Workers are used to build and persist pre-aggregations. Each Worker
-has a **maximum of 150GB** of storage; additional Cube Store workers can be
+has a **maximum of 150GB** of storage; [additional Cube Store workers][ref-limits] can be
 added to your deployment to both increase storage space and improve
 pre-aggregation performance. A **minimum of 2** Cube Store Workers is required
 for pre-aggregations; this can be adjusted. For a rough estimate, it will take
-approximately 2 Cube Store Workers per 4 gigs of pre-aggregated data per day.
+approximately 2 Cube Store Workers per 4 GB of pre-aggregated data per day.
 
 <InfoBox>
 
@@ -135,14 +131,10 @@ dropdown:
   src="https://ucarecdn.com/3b39c56f-d553-4612-b4f0-07084cc4b742/"
 />
 
-### <--{"id" : "Limits"}--> Cube API Instance
-
-|                 | Free Tier | Starter |  Premium  | Enterprise | Enterprise Premier |
-| --------------- | :-------: | :-----: | :-------: | :--------: | :----------------: |
-| Queries per day |   1,000   | 50,000  | Unlimited | Unlimited  |     Unlimited      |
+### <--{"id" : "Scalability"}--> Cube API Instance
 
 With a Production Deployment, 2 Cube API Instances are included. That said, it
-is very common to use more, and additional Cube API instances can be added to
+is very common to use more, and [additional API instances][ref-limits] can be added to
 your deployment to increase the throughput of your queries. A rough estimate is
 that 1 Cube API Instance is needed for every 5-10 requests-per-second served.
 Cube API Instances can also auto-scale as needed.
@@ -167,5 +159,5 @@ and select from the available options:
   src="https://ucarecdn.com/fbde6a1e-734a-4091-8edd-922dc1ee7e1c/"
 />
 
-[cube-contact-us]: https://cube.dev/contact
 [ref-conf-ref-ctx-to-app-id]: /config#options-reference-context-to-app-id
+[ref-limits]: /cloud/limits#resources

docs/content/Deployment/Cloud/Limits.mdx

@@ -0,0 +1,71 @@
+---
+title: Limits
+permalink: /cloud/limits
+category: Deployment
+subCategory: Cube Cloud
+menuOrder: 7
+---
+
+Cube Cloud implements limits on resource usage on account and deployment
+levels to ensure the best experience for all Cube Cloud users.
+
+<SuccessBox>
+
+Limits apply to Cube Cloud accounts on [all tiers](https://cube.dev/pricing).
+
+</SuccessBox>
+
+## Limit types
+
+Each limit can be of one of the following types:
+
+- *Hard limit* either has a threshold that can't be exceeded or prevents
+further use of a resource when a threshhold is hit until a cool-down period
+passes (e.g., until the next day starts) or the limit is increased (e.g.,
+when a Cube Cloud account upgrades to another tier).
+- *Soft limit* may allow further use of a resource after a threshold is hit.
+
+## Resources
+
+The following resources are subject to limits, depending on [deployment types][ref-deployment-types] and
+[pricing tiers][ref-pricing]:
+
+| Resource                                                        | Free Tier | Starter   | Premium   | Enterprise | Enterprise Premier            |
+| --------------------------------------------------------------- | :-------: | :-------: | :-------: | :--------: | :---------------------------: |
+| Number of deployments                                           | 2         | Unlimited | Unlimited | Unlimited  | Unlimited                     |
+| Number of API instances                                         | 1         | 20        | 20        | 20         | [Contact us][cube-contact-us] |
+| Number of Cube Store workers                                    | 2         | 16        | 16        | 16         | [Contact us][cube-contact-us] |
+| Queries per day ([development instance][ref-dev-instance])      | 1,000     | 10,000    | Unlimited | Unlimited  | Unlimited                     |
+| Queries per day ([production cluster][ref-prod-cluster])        | —         | 50,000    | Unlimited | Unlimited  | Unlimited                     |
+| Queries processed by [Query History][ref-query-history] per day | 1,000     | 50,000    | 100,000   | 200,000    | 300,000                       |
+
+### <--{"id" : "Resources"}--> Number of deployments
+
+This is a hard limit. Consider upgrading to [another tier][ref-pricing].
+
+### <--{"id" : "Resources"}--> Number of API instances
+
+This is a hard limit. Consider upgrading to [another tier][ref-pricing].
+
+### <--{"id" : "Resources"}--> Number of Cube Store workers
+
+This is a hard limit. Consider upgrading to [another tier][ref-pricing].
+
+### <--{"id" : "Resources"}--> Queries per day
+
+This is a hard limit. When a threshold is hit, further queries will not be
+processed. In that case, consider upgrading a development instance to a
+production cluster. Alternatively, consider upgrading to
+[another tier][ref-pricing].
+
+### <--{"id" : "Resources"}--> Queries processed by Query History per day
+
+This is a soft limit. When a threshold is hit, query processing will be
+stopped. Please [contact support][cube-contact-us] for further assistance.
+
+[ref-deployment-types]: /cloud/configuration/deployment-types
+[ref-pricing]: /cloud/pricing
+[ref-query-history]: /cloud/inspecting-queries
+[ref-dev-instance]: /cloud/configuration/deployment-types#development-instance
+[ref-prod-cluster]: /cloud/configuration/deployment-types#production-cluster
+[cube-contact-us]: https://cube.dev/contact