配额和限制

本页面详细介绍使用 Cloud Logging 时适用的限制。

如需了解 Logging 存储的每月配额，请参阅 Cloud Logging 价格摘要。

如需详细了解 Logging 价格信息，请参阅 Google Cloud 的运维套件价格：Cloud Logging。

Logging 用量限额

以下限制适用于 Cloud Logging 的使用。除了日志存储分区和接收器的数量限制之外，这些限制是固定的，您无法增加或减少。

Category 上限
日志条目的大小 256 KB1
审核日志条目的大小 512 KiB
标签数 64 个（每个日志条目）
日志条目标签键的长度 512 B2
日志条目标签值的长度 64 KB2
查询的长度 20,000 个字符
查询扇出4 200 个存储桶
接收器的数量 每个 Google Cloud 项目 200 个3
接收器包含项过滤条件的长度 20,000 个字符
接收器排除项过滤条件的长度 20,000 个字符
排除项过滤条件数量 每个接收器 50 个
日志存储分区数量 每个 Google Cloud 项目 100 个3、45
编入索引的自定义字段的数量 每个日志存储桶 20 个
日志查看次数 每个日志存储桶 30 个
可以存储在日志存储分区中的最早时间戳6 过去 30 天
可存储在日志存储分区中的未来时间戳6 最多未来 1 天

1 此近似限额根据内部数据大小（而非实际的 REST API 请求大小）计算。

2 写入关联的日志条目时，Cloud Logging 会截断超大的标签键和值。

3 此限制也适用于结算帐号、文件夹和组织，并且不分层级。例如，如果您在某个组织中有多个 Google Cloud 项目，那么您可以为每个 Google Cloud 项目配置最多 200 个接收器；对于该组织，您还可以在组织级层配置最多 200 个接收器。

4 此限制是可能包含资源日志条目的存储桶数上限。如需了解详情，请参阅查询返回错误。

5 此限制包括待删除的存储分区。

6 时间戳超出这些边界的日志条目将从日志存储分区中排除。Logging API 接受具有较旧时间戳的条目，这些条目可路由到接收器目标位置，但不存储在日志存储空间中。Logging API 会拒绝时间戳超过 1 天的条目，并返回 INVALID_ARGUMENT 错误。

Logging API 配额和限制

以下限制适用于 Logging API 的使用。您可以请求更改 Logging API 的配额和限额；如需了解相关说明，请参阅本页面上的请求更改 Cloud Logging API 配额。

类别 上限
API 用量 如需查看您的配额，请转到 API 信息中心。点击一项 API 并选择配额。
API 页面令牌有效期 24 小时
打开的 Live-tailing 会话数 每个 Google Cloud 项目 10 个3
返回的 Live-tailing 条目数 每分钟 60000
受限字段的数量 每个存储桶 20 个
受限字段的大小 800 B
entries.write 请求的大小 10 MB
entries.write 请求的数量 每个 Google Cloud 项目每分钟 120000 次1、3
entries.list 请求的数量 每个 Google Cloud 项目每分钟 60 次2、3
单个 entries.write 命令中不同资源名称的数量4 1000
控制请求次数：每分钟 5 次 600
控制请求数5/天 每个 Google Cloud 项目 1000 个
单个 entries.list 请求中的 Google Cloud 项目或其他资源名称的数量 100
并发复制操作数 每个 Google Cloud 项目 1 次3
导出到 Pub/Sub 主题的速率6 每个 Google Cloud 项目每秒 1 GB

1 使用排除项过滤器不会减少此数量，因为在发出 entries.write 请求后，日志会被排除。

2这是默认设置。

3 此限制也适用于结算帐号、文件夹和组织，并且不分层级。

4 日志条目的 logName 字段指定日志条目的资源名称。

5 每日控制请求配额适用于用于创建和更新排除项与接收器的 API 请求。每分钟控制请求配额适用于每天控制请求配额中包含的所有内容，以及用于删除日志和管理基于日志的指标的 API 请求。

6 如果导出速率超过配额，则会在日志条目中记录错误。摘要字段指出接收器配置错误，并且错误代码列为 topic_over_quota。

请求更改 Cloud Logging API 配额

您可以使用 Google Cloud 控制台申请更高或更低的 Logging API 限额：

  1. 在“配额”页面中，通过复选框选择 Cloud Logging API，然后点击修改配额。

    如果出现错误 Edit is not allowed for this quota，您可以与支持团队联系，请求更改配额。另请注意，必须为 Google Cloud 项目启用结算功能才能点击复选框。

  2. 在配额更改面板中，选择相应服务以展开视图，然后填写新限额和请求说明字段。点击下一步。

  3. 在详细联系信息面板中填写表单。

  4. 点击提交请求。

如需了解详情，请参阅处理配额。

优化 entries.list 的使用

entries.list 的预期用途是搜索匹配的日志。此方法不适用于对日志条目进行大量检索。如果您经常用尽 entries.list 配额，请考虑以下方案：

基于日志的指标

以下限制适用于您对用户定义的基于日志的指标的使用。除指标描述符数量外，这些限制都是固定的，您无法增加或减少。

Category 最大值
标签数量 10 个（每个指标）
标签值的长度 1024 B
标签说明的长度 800 B
过滤条件的长度 20,000 个字符
指标描述符的长度 8000 B
指标描述符的数量 每个 Google Cloud 项目 500 个2
活跃的时序的数量1 每个指标 30000 个
直方图分区的数量 每个自定义分布指标为 200 个
数据保留 请参阅 Cloud Monitoring：数据保留

1如果您在过去 24 小时内向某时序写入过数据点，则该时序便处于活跃状态。

2 此限制也适用于结算帐号、文件夹和组织，并且不具有分层结构。

日志保留期限

以下 Cloud Logging 保留期限适用于日志存储桶，无论存储桶包含哪些类型的日志，也无论它们是从其他位置复制的。保留信息如下：

日志存储桶 默认保留期限 自定义保留期限
_Required 400 天 不可配置
_Default 30 天 可配置
用户定义 30 天 可配置

对于 _Default 和用户定义的日志存储分区，您可以配置 Cloud Logging，将日志保留期限设为 1 到 3650 天之间的任意值。如需了解如何设置保留规则，请参阅配置自定义保留。