本页面详细介绍使用 Cloud Logging 时适用的限制。
Logging 用量限额
以下限制适用于 Cloud Logging 的使用。除日志存储分区和接收器的数量限制外,这些限制是固定的,您无法增加或减少它们。
类别 | 最大值 |
---|---|
LogEntry 的大小 |
256 KB1 |
审核日志条目的大小 | 512 KiB |
标签数 | 64/LogEntry |
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 天后 |
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 项目每分钟 60 GB |
1 使用排除项过滤器不会减少此数量,因为日志会在 entries.write
请求发出后排除。
2 该值是默认设置。
3 此限制也适用于结算帐号、文件夹和组织,不具有层次结构。
4 日志条目的 logName
字段指定日志条目的资源名称。
5 每日控制请求配额适用于用于创建和更新排除项与接收器的 API 请求。每分钟控制请求配额适用于每日控制请求配额中包含的所有资源,以及用于删除日志和管理基于日志的指标的 API 请求。
6 如果导出速率超过配额,系统会将错误记录在日志条目中。摘要字段指示接收器配置错误,错误代码列为 topic_over_quota
。
请求更改 Cloud Logging API 配额
您可以使用 Google Cloud 控制台申请更高或更低的 Logging API 限额。如需了解详情,请参阅查看和管理配额。
如果出现错误 Edit is not allowed for this quota
,您可以与支持团队联系,请求更改配额。另请注意,必须为 Google Cloud 项目启用结算功能才能点击相应的复选框。
优化“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 此限制也适用于结算帐号、文件夹和组织,不具有层次结构。
审核日志记录
下表显示了审核日志的大小上限。这些值可以帮助您估算接收器目标位置中所需的空间。
审核日志类型 | 大小上限 |
---|---|
管理员活动 | 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 不会就复制日志或通过日志浏览器页面或日志分析页面发出的查询收费。
有关详情,请参阅以下文档:
- Cloud Logging 价格摘要
目标页面费用:
- 当您在 Cloud Logging 中发送 Virtual Private Cloud 流日志后又将其排除时,需支付 VPC 流日志生成费用。