配额和限制

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

Logging 用量限额

以下限制适用于 Cloud Logging 的使用。使用 除日志存储分区和接收器数量限制外， 已修复；您无法提高或降低它们。

类别 最大值
大小 LogEntry 256 KB1
尺寸 审核日志条目 512 KiB
标签数 64/LogEntry
LogEntry 标签键的长度 512 B2
LogEntry 标签值的长度 64 KB2
长度 日志记录查询语言查询 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 天后

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

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

3 此限制也适用于结算账号、文件夹和 组织结构，不具有层级结构。例如，如果您有多个 组织中的 Google Cloud 项目，那么您可以配置多达 每个 Google Cloud 项目 200 个接收器；为此 那么您还可以配置多达 200 个 在组织级别分配接收器

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

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

6 时间戳不在这些边界内的日志条目 日志存储分区中被拒绝的条目。Logging API 接受时间较早的条目 这些条目可以路由到接收器目标位置 存储在日志存储空间中。Logging API 拒绝带有时间戳的条目 并返回 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 项目每分钟 60 GB

1 使用排除对象过滤器不会减少此数字 因为日志在 entries.write 请求后被排除 。

2 该值是默认设置。

3 此限制也适用于结算账号、文件夹和 组织结构，不具有层级结构。

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

5 每日控制请求配额适用于 API 请求 用于创建和更新排除项及接收器的通过 每分钟控制请求配额适用于 每日控制请求配额，外加用于删除日志和 管理基于日志的指标

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

请求更改 Cloud Logging API 配额

您可以使用 Google Cloud 控制台。 如需了解详情，请参阅查看和管理配额。

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

优化“entries.list”的使用

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

  • 确保有效使用 Cloud Logging API。如需更多信息 请参阅优化 API 的使用。

  • 如果您事先知道要分析的日志条目超出了 entries.list 配额，然后配置日志接收器以导出您的 到支持的目标位置

  • 如需分析 Logging 之外的日志条目，您可以执行以下操作： 来追溯复制 将日志记录到 Cloud Storage 存储分区。将日志复制到 您可以与 Cloud Storage 存储桶之外的 记录并在 Cloud Storage 中运行脚本。

基于日志的指标

以下限制适用于 用户定义的基于日志的指标 除了指标描述符的数量外 这些限制是固定的您无法提高或降低它们。

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

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

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

审核日志记录

审核日志的大小上限如下： 表格。这些值可以帮助您估算 接收器目标位置。

审核日志类型 大小上限
管理员活动 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 不会针对复制日志或通过 日志浏览器页面或日志分析页面。

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