本页面详细介绍使用 Cloud Logging 时适用的限制。
如需了解 Logging 注入和存储的每月配额,请参阅 Cloud Logging 价格摘要。
如需详细了解 Logging 价格,请参阅 Google Cloud 的运维套件价格: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 个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 小时 |
公开尾随会话数 | 每个 Google Cloud 项目 10 个3 |
返回的实时尾随条目数 | 每分钟 60000 |
受限字段的数量 | 每个存储桶 20 个 |
受限字段的大小 | 800 B |
entries.write 请求的大小 | 10 MB |
entries.write 请求数 | 每个 Google Cloud 项目每分钟 1200001、3 |
entries.list 请求的数量 | 每个 Google Cloud 项目每分钟 602、3 |
每分钟控制请求数 4 | 600 |
每天的控制请求数量4 | 每个 Google Cloud 项目 1000 个 |
单个 entries.list 请求中 Google Cloud 项目或其他资源名称的数量 | 100 |
并发复制操作数 | 每个 Google Cloud 项目 1 个3 |
1 使用排除过滤器不会减少此数字,因为在entries.write 请求之后会排除日志。
2此值是默认设置。
3 此限制也适用于结算帐号、文件夹和组织,并且没有层次结构。
4 每日控制请求配额适用于创建和更新排除项及接收器的 API 请求。每分钟控制请求配额适用于每日控制请求配额中包含的所有指标,以及用于删除日志和管理基于日志的指标的 API 请求。
请求更改 Cloud Logging API 配额
您可以使用 Google Cloud 控制台申请更高或更低的 Logging API 限额:
在“配额”页面中,使用复选框选择 Cloud Logging API,然后点击修改配额。
如果出现错误
Edit is not allowed for this quota
,您可以与支持团队联系,请求更改配额。另请注意,必须在 Google Cloud 项目中启用结算功能才能点击复选框。在配额更改面板中,选择相应服务以展开视图,然后填写新限额和请求说明字段。点击下一步。
在详细联系信息面板中填写表单。
点击提交请求。
如需了解详情,请参阅处理配额。
优化entries.list
的使用
entries.list 的预期用途是搜索匹配日志。如果您经常会用尽 entries.list
配额,请参阅高效读取和列出日志,获取有关如何优化用量的提示。
基于日志的指标
使用用户定义的基于日志的指标时,存在以下限制。除了指标描述符的数量之外,这些限制是固定的;您无法增加或减少这些限制。
类别 | 最大值 |
---|---|
标签数量 | 每个指标 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 天之间的任意值。如需了解如何设置保留规则,请参阅配置自定义保留。