本页面详细介绍使用 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 中运行脚本。
- 如需在 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 价格摘要
目标页面费用:
- VPC 流日志生成费用 在 Cloud Logging 中发送 Virtual Private Cloud 流日志后将其排除时适用。