配额和限制

Cloud Trace 实行两种不同类型的配额:API 请求的速率配额,以及发送给 Trace 的 Span 的提取量配额。

Trace API 用量限额

API 方法 总配额单元数
GetTrace1
ListTraces2
ListSpan1
每 60 秒 300 个
PatchTraces1
BatchWriteSpans1
CreateSpan1
每 60 秒 4800 个

1 每次 API 调用消耗一个配额单元。
2 每调用一次 API 消耗 25 个配额单元。

GetTraceListTracesListSpan 这三个 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 Console 申请更高的 Cloud Trace API 限额:

  1. “配额”页面中,勾选 Cloud Trace API 对应的复选框,然后点击修改配额

    为项目启用结算功能后才能点击该复选框。

  2. 修改配额面板上的表单中,填写您的名字电子邮件电话详情,然后点击下一步

  3. 修改配额面板中,选择服务以展开视图,然后为该服务修改配额,输入您申请的新限额。点击完成

  4. 点击提交请求

本页介绍的其他限额是固定的。

如需了解详情,请访问处理配额

Trace 每日 Span 提取量限制

每天的跟踪记录 Span 提取量配额取决于结算帐号历史记录和您申请增加的配额。下表列出了配额分配范围:

类别 配额单元数
Span 提取量 每天 300 万 - 每天 50 亿

配额与费用的关系

Cloud Trace 费用取决于 Trace Span 提取量和扫描量。提取量反映了 Trace 接收的 Span 数量。扫描量反映了从存储空间检索的 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 提取量,请参阅创建超出配额的提醒