配额和限制

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

Trace 配额

下表汇总了可用于读取和写入操作的配额单元，以及提取 span 的每日配额。例如，GetTrace、ListTraces 和 ListSpan 这三个 API 命令总共为每 60 秒 300 次。以下两个不同示例说明了您可以如何使用全部可用配额单元。

  • 每 60 秒进行 12 次 ListTraces API 调用。
  • 每 60 秒进行 10 次 ListTraces API 调用和 50 次 GetTrace API 调用。
类别 总配额单元数
读取操作次数1 每 60 秒 300 个
写入操作次数2 每 60 秒 4800 个
注入的 span3 每天 300 万 - 每天 50 亿

1 读取操作包括 GetTrace、ListTraces 和 ListSpan。调用 ListTraces 会消耗 25 个配额单元。调用 GetTrace 将消耗 ListSpan 个配额单元。
2 写入操作包括 PatchTraces、BatchWrite 和 CreateSpan。每次写入操作消耗 1 个配额单元。
3 您的每日跟踪记录 Span 提取量配额取决于您的结算帐号历史记录和您提出的增加配额的请求。

Trace 限制

本部分列出了使用 Cloud Trace API 时适用的限制。

API 方法的限制

API 方法的限制 价值
每次 GetTrace 调用的 Span 数上限 1000
每次 PatchTraces 调用的 Span 数上限 25000
每次 ListTraces 调用的跟踪记录数上限 在 ROOTSPAN 和 MINIMAL 视图中为 1,000
在 COMPLETE 视图中为 100

span 限制

span 限制 价值
span 名称的长度上限 128 字节
每个 span 的标签或属性数量上限 32
标签或属性的键的大小上限 128 字节
标签或属性的值大小上限 256 字节
每个 span 的事件数上限 128
要提取的 span 的过去时间戳上限 14 天
要提取的 span 的未来时间戳上限 3 天
事件的过往时间戳（相对于跨度时间戳） 365 天

使用 Cloud Trace API v2 batchWrite 时，您可以通过以下方式为 span 添加注解：创建 attributes 对象并将其附加到 Span 对象。同样，在使用 Cloud Trace API v1 patchTraces 方法时，您可以通过以下方式为 span 添加注解：创建 labels 对象并将其附加到 TraceSpan 对象。

跟踪记录的限制

跟踪记录的限制 价值
每个跟踪记录的 Span 数上限 1,000
跟踪记录大小上限 50 MB

跟踪记录保留期限

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

管理您的配额

本部分介绍如何申请更改配额以及如何监控配额用量。

请求更改 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. 点击提交请求。

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

监控配额用量

为避免配额用尽，导致无法了解应用性能，请务必批量更新并监控配额用量。例如，您可以创建一项提醒政策，以便在用量超过阈值时通知您。如需详细了解如何监控 API 请求并了解其响应，请参阅监控 API 用量。

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

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

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

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