配额和限制

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

Logging 用量限额

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

类别 上限
日志条目的大小 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 个345
编入索引的自定义字段的数量 每个日志存储桶 20 个
日志查看次数 每个日志存储桶 30 个
可以存储在日志存储分区中的最早时间戳6 过去 30 天
可存储在日志存储分区中的未来时间戳6 未来 1 天(最多 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 项目每分钟 12 万次1、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 项目每秒 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 配额,请考虑采取以下措施:

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

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

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

  • 如需汇总和分析 Logging 中的日志条目,请创建或升级日志存储桶以使用 Log Analytics。借助 Log Analytics,您可以使用 BigQuery 标准 SQL 查询日志条目。

基于日志的指标

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

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

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

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

日志保留期限

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

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

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

价格

在将日志路由到受支持的目标位置时,Cloud Logging 不会产生费用;但是,目标位置可能会产生费用。除 _Required 日志存储桶外,Cloud Logging 会针对将日志流式传输到日志存储桶,以及对超出日志存储桶默认保留期限的存储收费。

Cloud Logging 不对日志复制或通过 Logs Explorer 页面或 Log Analytics 页面发出的查询收费。

有关详情,请参阅以下文档: