租户端 存储 日志服务（CLS） 产品简介 API日志上传限制

API日志上传限制

最近更新时间: 2026-03-13 09:03:00

写入限制

日志写入限制及说明如下表所示：

限制项说明
上传日志一个 pb 包里 logGroup 不能超过10个。
一个 pb 包里 logGroup 包含日志条数最多为10000条，至少包含1条。
log 中单个 value 最大为1MB。
一个 pb 包里 logGroup 部分所有 Value 大小最大总和为5MB。
Log 中的 Key 不能以 _ 开头，且不能是以下保留字段："__FILENAME__"、"__TIMESTAMP__"、"__LOGSETID__"、"__TOPICID__"。
单次上传请求的包体压缩前不能超过6MB。
频控单个主题分区写请求限制：500QPS。超限返回状态码429，提示错误 SpeedQuotaExceed 。写频率较大时，建议分裂主题分区。
<strong>说明：</strong>
此处500QPS不代表500条日志。 一次请求中的 pb 包可以包含多条日志批量上传。

流控单个主题分区压缩后写流量限制：5MB/s。超限返回状态码429，提示错误 SpeedQuotaExceed。写流量较大时，建议 分裂主题分区。