配额和限制

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

Logging 用量限额

以下限制适用于 Cloud Logging 的使用。除了日志分桶和回流数量限制外，这些限制是固定的；您不能增加或减少它们。

类别 最大值
LogEntry 的大小 256 KB1
审核日志条目的大小 512 KiB
标签数量 每 LogEntry 64 个
LogEntry 标签键的长度 512 B2
LogEntry 标签值的长度 64 KB2
Logging 查询语言查询的长度 20,000 个字符
查询扇出4 200 个存储桶
接收器的数量 每个 Google Cloud 项目 200 个3
接收器包含项过滤条件的长度 20,000 个字符
接收器排除项过滤条件的长度 20,000 个字符
排除项过滤条件的数量 每个接收器 50 个
日志存储分区的数量 每个 Google Cloud 项目 100 个3、4、5
编入索引的自定义字段的数量 每个日志存储分区 20 个
日志查看次数 每个日志存储分区 30 次
可存储在日志存储分区中的最早时间戳6 过去 30 天
可存储在日志存储分区中的未来时间戳6 最多 1 天后
每个资源的日志范围数量 100
日志范围中包含的日志视图和项目的数量 100
日志范围中包含的项目数量 5
每个 Google Cloud 项目的分析视图数量上限7 100
每个 Google Cloud 项目在每个区域中的分析视图数量上限7 50
每个 Google Cloud 项目中可存储 Google Analytics 视图的区域数量上限7 10

1 此近似限额根据内部数据大小（而非实际的 REST API 请求大小）计算。
2 写入关联的日志条目时，Cloud Logging 会截断超大的标签键和值。
3 此限制也适用于结算账号、文件夹和组织，并且没有分层。例如，如果您的组织中有多个 Google Cloud 项目，则可为每个 Google Cloud 项目配置最多 200 个接收器。对于同一组织，您还可以在组织级层配置最多 200 个接收器。
4 此限制是可能包含资源日志条目的存储分区数上限。如需了解详情，请参阅查询返回错误。
5 此限制包括待删除的存储分区。
6 日志存储分区会拒绝时间戳超出这些边界的日志条目。Logging API 接受时间戳较早的条目，这些条目可以路由到接收器目的地，但不会存储在日志存储空间中。Logging API 会拒绝时间戳超过 1 天的条目，并返回 INVALID_ARGUMENT 错误。
7此功能目前处于公开预览版阶段。

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 项目每分钟 120,000 个1, 3
entries.write 请求速率（按区域）
正在添加配额；如需了解详情，请参阅 每个区域的提取配额		 在以下区域，每个 Google Cloud 项目每分钟 4.8 GB： asia-east1、 asia-northeast1、 asia-southeast1、 asia-south1、 europe-west1、 europe-west2、 europe-west3、 europe-west4、 us-central1、 us-east4、 us-west1 1、3

在所有其余区域，每个 Google Cloud 项目每分钟 300 MB1、3
entries.list 请求数 每个 Google Cloud 项目每分钟 60 个2、3
单个 entries.write 命令中的不同资源名称数量
4		 1000
每分钟的控制请求数5 600
控制请求5 次/天 每个 Google Cloud 项目 1,000 个
单个 entries.list 请求中的 Google Cloud 项目或其他资源名称的数量
 100
并发复制操作数 每个 Google Cloud 项目 1 个3
导出到 Pub/Sub 主题的速率6 每个 Google Cloud 项目每分钟 60 GB

1 使用排除过滤条件不会减少此数量，因为日志排除操作是在 entries.write 请求执行后进行的。
2此值为默认设置。
3 此限制也适用于结算账号、文件夹和组织，并且没有分层结构。
4 日志条目的 logName 字段用于指定日志条目的资源名称。
5 每日控制请求配额适用于用于创建和更新排除项和接收器的 API 请求。每分钟控制请求配额适用于每日控制请求配额中包含的所有内容，以及用于删除日志和管理基于日志的指标的 API 请求。
6 如果导出速率超出配额，系统会在日志条目中记录错误。“摘要”字段指示接收器配置错误，错误代码列为 topic_over_quota。

每个区域的数据提取配额

自 2025 年 4 月 22 日起，Cloud Logging 配额将按 Google Cloud 项目限制写入提取区域的数据量。自该日期起，Cloud Logging 将不再限制 Google Cloud 项目发出的 API entries.write 请求数量。此项变更旨在加强隔离，并保护区域性资源免受提取过载的影响。

下表显示了每个区域的默认配额：

提取区域 默认值
asia-east1、asia-northeast1、asia-southeast1、asia-south1、europe-west1、europe-west2、europe-west3、europe-west4、us-central1、us-east4、us-west1 每个 Google Cloud 项目每分钟 4.8 GB
所有其他地区 每个 Google Cloud 项目每分钟 300 MB

区域配额的默认值超出了大多数用户的数据提取量。不过，如果在 2025 年 4 月 22 日之前，您的项目在某个区域的前六个月或更长时间内的提取量接近或超过该区域的默认配额，则您的初始配额会包含一次性自动增加的配额。因此，您的配额可能会高于上表中的默认配额。

您可以在 2025 年 4 月 22 日之前查看地区级配额，但我们将在该日期之后才会强制执行配额。如需了解如何查看配额，请参阅查看 Logging 配额。

2025 年 4 月 22 日之后，entries.write 请求数量配额将更改为无限。

如果您在 2025 年 4 月 22 日之后超出区域配额，系统可能会拒绝您对 Cloud Logging API 的写入请求，并返回“资源耗尽”错误消息。如需了解有助于您避免超出配额的建议，请参阅管理和监控 Logging 配额。

查看 Cloud Logging API 配额

如需查看 Cloud Logging API 配额，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往配额和系统限制页面：

    前往配额和系统限制

    如果您使用搜索栏查找此页面，请选择子标题为 IAM 和管理的结果。

  2. 过滤 Cloud Logging API 服务的配额列表。

请求更改 Cloud Logging API 配额

您可以使用 Google Cloud 控制台请求增加或减少 Logging API 限额。如需了解详情，请参阅查看和管理配额。

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

管理和监控 Cloud Logging API 配额

为防止因超出配额而导致服务中断，您可以执行以下操作：

  • 使用自动配额调整功能可监控配额用量并为您申请配额增加。如需了解详情，请参阅配额调整器。
  • 针对配额创建提醒，以便在用量达到一定水平时通知您。如需了解详情，请参阅设置配额提醒。

优化 entries.list 的使用

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

  • 确保您有效使用 Cloud Logging API。如需了解详情，请参阅优化 API 使用情况。

  • 如果您事先知道要分析的日志条目超出了 entries.list 配额，请配置日志接收器，将日志导出到受支持的目的地。

  • 如需在 Logging 之外分析日志条目，您可以将 Logging 中已存在的日志条目回溯复制到 Cloud Storage 存储分区。将日志复制到 Cloud Storage 存储分区后，您可以与 Logging 外部的审核人员共享日志条目，并在 Cloud Storage 中运行脚本。

  • 如需在“日志记录”中汇总和分析日志条目，请将日志条目存储在日志存储分区中，然后升级该日志存储分区以使用 Log Analytics。如需了解这些步骤，请参阅配置日志存储分区。

    借助 Log Analytics，您可以使用 BigQuery 标准 SQL 查询日志条目。

基于日志的指标

以下限制适用于用户定义的基于日志的指标。 除了指标描述符数量外，这些限制是固定的；您不能增加或减少它们。

类别 最大值
标签数量 每个指标 10 个
标签值的长度 1024 B
标签说明的长度 800 B
过滤器的长度1 20,000 个字符
指标描述符的长度 8000 B
指标描述符的数量 每个 Google Cloud 项目 500 个2
活跃的时间序列数量3 每个指标 30,000 次
直方图桶的数量 每个自定义分布指标 200 个
数据保留 请参阅 Cloud Monitoring：数据保留

1 每个基于日志的指标都包含一个过滤条件。当日志条目与过滤条件匹配时，系统会统计该日志条目。过滤条件是使用 Logging 查询语言定义的。
2 此限制也适用于结算账号、文件夹和组织，并且没有层次结构。
3如果您在过去 24 小时内向某时间序列写入过数据点，则该时间序列便处于活跃状态。

审核日志记录

下表显示了审核日志的大小上限。这些值可帮助您估算接收器目标位置中所需的空间。

审核日志类型 大小上限
管理员活动 512 KiB
数据访问 512 KiB
系统事件 512 KiB
政策拒绝 512 KiB

日志保留期限

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

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

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

价格

Cloud Logging 不会对将日志路由到受支持的目标位置收费；但目标位置可能会收费。除了 _Required 日志存储分区外，Cloud Logging 会对将日志流式传输到日志存储分区以及存储时间超过日志存储分区默认保留期限的部分收费。

Cloud Logging 不会对复制日志、创建日志范围或分析视图，以及通过 Logs Explorer 或 Log Analytics 页面发出的查询收费。

有关详情，请参阅以下文档：