配额和限制

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

Trace API 用量限额

API 方法 总配额单元数
GetTrace1
ListTraces2
ListSpan1		 每 60 秒 300 个
PatchTraces1
BatchWriteSpans1
CreateSpan1		 每 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 限额：

  1. 在 Google Cloud 控制台的“配额”页面中，使用复选框选择 Cloud Trace API，然后点击修改配额。

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

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

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

  4. 点击提交请求。

如需了解详情，请参阅查看和管理配额。

Trace 每日 Span 提取量限额

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

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

配额与费用的关系

Cloud Trace 价格取决于 Trace Span 提取量和扫描量。系统会将延迟数据打包到由 span 组成的跟踪记录中trace。这些 span 由 Cloud Trace 后端提取，然后由 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 保留期限

类别 保留期限
Cloud Trace 存储的 Span 数据 30 天
分析报告 30 天

管理您的配额

为了避免配额用尽，导致无法观测应用性能，请定期查看配额用量或创建提醒政策。如需详细了解如何监控 API 请求并了解其响应，请参阅监控 API 用量。

  • 如需查看您的 Cloud Trace API 配额和每日 Span 提取量配额，请参阅查看和管理配额。

  • 如需了解如何减少 API 配额单元和每日 Span 提取量配额单元，请参阅限制用量。

  • 如需申请增加您的 API 配额或每日 Span 提取量配额，请参阅申请更多配额

  • 如需详细了解如何创建提醒政策来监控 Trace API 配额以及速率跟踪记录 Span 提取量，请参阅创建超出配额的提醒。