配额和限制

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 1 个配额单元。
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 天
相对于 span 时间戳的事件过去时间戳上限 365 天

使用 Cloud Trace API v2 batchWrite 时，您可以创建一个 attributes 对象并将其附加到 Span 对象，为 span 添加注释。同样，使用 Cloud Trace API v1 patchTraces 方法时，您可以创建一个 labels 对象并将其附加到 TraceSpan 对象，为 span 添加注释。

跟踪记录限制

跟踪记录限制 值
每个跟踪记录的 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 提取量，请参阅创建超出配额的提醒。