Cloud Trace 实行两种不同类型的配额:API 请求的速率配额,以及发送给 Trace 的 Span 的提取量配额。
Trace API 用量限额
API 方法 | 总配额单元数 |
---|---|
GetTrace 1 ListTraces 2 ListSpan 1 |
每 60 秒 300 个 |
PatchTraces 1 BatchWriteSpans 1 CreateSpan 1 |
每 60 秒 4800 个 |
1 每次 API 调用消耗一个配额单元。
2 每调用一次 API 消耗 25 个配额单元。
GetTrace
、ListTraces
和 ListSpan
这三个 API 命令每 60 秒共可使用 300 个配额单元。以下两个不同示例说明了您可以如何使用全部可用配额单元。
- 每 60 秒进行 12 次
ListTraces
API 调用。 - 每 60 秒进行 10 次
ListTraces
API 调用和 50 次GetTrace
API 调用。
Cloud Trace API 的其他限制和限额如下:
限制和限额 | 值 |
---|---|
每次 GetTrace 调用的 Span 数上限 |
1000 |
每次 PatchTraces 调用的 Span 数上限 |
25000 |
每次 ListTraces 调用的跟踪记录数上限 |
1000(在 ROOTSPAN/Minimal 视图中) 100(在 COMPLETE 视图中) |
每个跟踪记录的 Span 数上限 | 1000 |
每个跟踪记录的字节数上限 | 50 MB |
每个 Span 的标签/特性数上限 | 32 |
每个标签/特性键的大小 | 128 字节 |
每个标签/特性值的大小 | 256 字节 |
请求更改 Cloud Trace API 配额
您可以使用 Google Cloud 控制台请求更高或更低的 Cloud Trace API 限额:
在“配额”页面中,使用复选框选择 Cloud Trace API,然后点击修改配额。
如果出现错误
Edit is not allowed for this quota
,您可以与支持团队联系,请求更改配额。另请注意,必须在 Google Cloud 项目上启用结算功能才能点击复选框。在配额更改面板中,选择相应服务以展开视图,然后填写新限额和请求说明字段。点击下一步。
在详细联系信息面板中填写表单。
点击提交请求。
如需了解详情,请参阅处理配额。
Trace 每日 Span 提取量限额
每天的跟踪记录 Span 提取量配额取决于结算账号历史记录和您申请增加的配额。下表列出了配额分配范围:
Category | 配额单元数 |
---|---|
Span 提取量 | 每天 300 万 - 每天 50 亿 |
配额与费用的关系
Cloud Trace 价格取决于 Trace Span 提取量和扫描量。系统会将延迟数据打包到由 span 组成的跟踪记录中trace。这些 span 由 Cloud Trace 后端提取,然后提供数据,以便在 Google Cloud 控制台中实时查看和报告。 在您查看跟踪记录数据时,系统会在检索过程中扫描存储的 span。
每日 Span 配额限定了可提取的 Span 数量上限,达到此限制后,API 调用会失败并给出资源耗尽错误。API 速率配额限定了进行 API 调用的速率上限,达到此限制后,API 调用会失败并给出资源耗尽错误。
每次 API 调用都会消耗 API 配额。每次 API 写入调用还会消耗每日 Span 提取量配额。例如,如果您需要修补 10000 个 Span,可以有以下选择:
发送一个带有 10000 个 Span 的
patchTraces
请求。发送 10000 个
patchTraces
请求,每个请求带有 1 个 Span,并将这些请求分为在若干分钟内发出,以免超过 API 配额限制。
第一种方法使用 1 个 API 配额单元,第二种方法使用 10000 个 API 配额单元。两种方法均使用 10000 个每日 Span 提取量配额单元。这两种方法的价格相同,因为价格取决于提取的 Span 数,而不是 API 调用数。
Trace 保留期限
类别 | 保留期限 |
---|---|
所有跟踪记录 Span 数据 | 30 天 |
分析报告 | 30 天 |
管理您的配额
请定期查看配额用量或创建提醒政策,以免配额用尽,导致无法了解应用性能。如需详细了解如何监控 API 请求并了解其响应,请参阅监控 API 用量。
如需查看您的 Cloud Trace API 配额和每日 Span 提取量配额,请参阅查看您的配额。
如需减少您使用的 API 配额单元数和每日 Span 提取量配额单元数,请参阅限制用量。
如需申请增加您的 API 配额单元或每日 Span 提取量配额,请参阅申请更高配额。
如需详细了解如何创建提醒政策来监控 Trace API 配额以及速率跟踪记录 Span 提取量,请参阅创建超出配额的提醒。