tencent cloud

Cloud Log Service

Topic Partition

Download
Focus Mode
Font Size
Last updated: 2026-05-11 18:01:12
A topic partition is the smallest read/write unit of CLS. A log topic can contain multiple partitions, the number of which determines the maximum data read/write capabilities of a single log topic. The data read/write capabilities of a single topic partition are as follows:
Category
Description
Frequency control
A single topic partition supports a maximum of 200 QPS of read operations. It will return the status code 429 with an error message of "SpeedQuotaExceed" when this limit is exceeded.
A single topic partition supports a maximum of 500 QPS of write operations. It will return the status code 429 with an error message of "SpeedQuotaExceed" when this limit is exceeded.
Note:
Here, 500 QPS does not equate to 500 log entries per second. A single protobuf package from one request may include multiple log entries for batch upload.
Traffic throttling
There is no limit on the read traffic of a single topic partition. However, it is recommended that the traffic be maintained within 5 MB/s.
The write traffic limit on a single topic partition after data compression is 5 MB/s. If the limit is exceeded, the system returns status code 429 with the error SpeedQuotaExceed.
If a log topic has 10 partitions, its maximum supported write throughput for compressed logs is 5MB/s * 10 = 50MB/s. By default, a single log topic can have a maximum of 50 partitions, corresponding to a maximum write throughput for compressed logs of 5MB/s * 50 = 250MB/s. If 50 partitions do not meet your business requirements, you can contact us to request an exception for a larger number of partitions.
Note:
In practice, it is recommended to enable the Auto Split feature when you create a topic. CLS will automatically increase the number of topic partitions based on actual data volume, eliminating the need for manual partition management.

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback