Service quotas
Your Cumulocity service includes so-called quotas. These quotas ensure that the service operates within the guarantees of the Cumulocity service-level agreements.
The following types of quotas are used:
- Hard: Services enforce this quota so that it cannot be exceeded.
- Soft: Services are guaranteed to operate within the specified service-level agreements as long as the quotas are not exceeded; however, exceeding the quotas may result in a degraded user experience and no assurance of meeting the service-level agreements.
The quotas listed here reflect the maximum values for the cloud subscriptions unless indicated otherwise. If you’re unsure whether a specific cloud service quota is sufficient for your use case, we recommend reaching out to your sales contact to discuss your needs and explore potential options. Some quotas may be adjustable through professional services, depending on the system dimensioning and your specific requirements. For Edge deployments, consult the Cumulocity Edge documentation.
Platform
General
| Quota | Type | Value |
|---|---|---|
| Tenant amount | Soft | 2000 |
Microservices
| Quota | Type | Value |
|---|---|---|
| Microservice name length | Hard | 23 |
| Microservice image size | Hard | 500 MB |
| Threads in a microservice | Hard | 10240 |
| Retained log size | Hard | 35 MB |
Domain model
| Quota | Type | Value |
|---|---|---|
| Document size | Hard | 16 MB |
| Document size | Soft | 1 MB |
| Array size within document | Soft | 1000 |
| Children of an inventory object | Soft | 1000 |
| Property size | Soft | 32 KB |
REST API
| Quota | Type | Value |
|---|---|---|
| API request duration | Hard | 5 minutes |
Realtime APIs
| Quota | Type | Value |
|---|---|---|
| MQTT message size (Core MQTT) | Hard | 16 KB |
| Notifications 2.0 message backlog | Hard | 25 MiB |
| Notifications 2.0 time-to-live | Hard | 36 hours |
| Microservice-based data broker message backlog | Hard | 50 MiB |
| Microservice-based data broker time-to-live | Hard | 36 hours |
| Streaming Analytics and Streaming Lake offloading message backlog | Hard | 1 GiB |
MQTT Service
| Quota | Type | Value |
|---|---|---|
| Client identifier length | Hard | 128 bytes |
| Topic name length | Hard | 256 bytes |
| Topics | Unlimited | |
| Concurrent client connections (per tenant)1 | Hard | 1000 connections |
| Client connection rate (per tenant) | Hard | 100 per second |
| Inbound message publishing rate (per tenant) | Hard | 1000 per second |
| Inbound message publishing rate (per client) | Soft | 100 per second |
| Outbound message publishing rate (per tenant) | Hard | 100 per second |
| Maximum message size (per tenant) | Hard | 128 KiB |
| Maximum aggregate throughput (per tenant, connected clients x message size x publishing rate) | Soft | 1 MiB per second |
| Message backlog (per tenant, total for all MQTT topics) | Hard | 1 GiB |
| Message time-to-live (per tenant) | Hard | 36 hours |
These default quotas are set to support reliable operation on Cumulocity’s shared cloud environments. Significantly higher quotas can be configured for dedicated environments.
Applications and services
| Quota | Type | Value |
|---|---|---|
| Devices shown on the Cockpit home page map | Hard | 100 |
| Data points in a graph | Hard | 5000 |
Protocols
| Quota | Type | Value |
|---|---|---|
| File size for LWM2M bulk registration | Hard | 10 MB |
| Concurrent pending LWM2M operations per device | Hard | 10 |
| Maximum number of Loriot devices that can be registered per deployment | Soft | 40000 |
| Maximum number of Loriot devices that can be registered per tenant | Soft | 20000 |
DataHub
| Quota | Type | Value |
|---|---|---|
| Number of tenants | Soft | 250 |
| Number of Dremio users per tenant | Soft | 40 |
| Number of active offloaders per tenant | Soft | 100 |
| Number of offloadings per tenant per hour | Soft | 20 |
| Offloading frequency | Hard | hourly |
| Offloaded leaf properties2 | Soft | 6400 |
| Query time out | Soft | 4 min |
| Query job retention | Hard | 1 day |
| Rows in a query job | Hard | 1000000 |
| Rows in a high performance query | Soft | 1000000 |
| Parallel high performance queries per tenant | Hard | 18 |
Additional quotas from the Dremio engine may apply for DataHub customers.
-
MQTT Service hard quotas documented as per tenant can be increased if necessary to support your use case, with any additional usage charged for. ↩︎
-
Leaf properties are properties with elementary types (text, number, boolean). The total count of leaf properties offloaded into the same table should not exceed the limit. ↩︎