配额和限制

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 控制台请求更高或更低的 Cloud Trace API 限额:

  1. “配额”页面中,使用复选框选择 Cloud Trace API,然后点击修改配额

    如果出现错误 Edit is not allowed for this quota,您可以与支持团队联系,请求更改配额。另请注意,必须在 Google Cloud 项目上启用结算功能才能点击复选框。

  2. 配额更改面板中,选择相应服务以展开视图,然后填写新限额请求说明字段。点击下一步

  3. 详细联系信息面板中填写表单。

  4. 点击提交请求

如需了解详情,请参阅处理配额

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 提取量,请参阅创建超出配额的提醒