Cloud Trace 实行两种不同类型的配额：API 请求的速率配额，以及发送给 Trace 的 Span 的提取量配额。
Trace 配额
下表汇总了可用于读取和写入操作的配额单位，以及提取跨度的每日配额。例如，GetTrace、ListTraces 和 ListSpan 这三个 API 命令每 60 秒共可使用 300 个配额单元。以下两个不同示例说明了您可以如何使用全部可用配额单元。
- 每 60 秒进行 12 次
ListTracesAPI 调用。 - 每 60 秒进行 10 次
ListTracesAPI 调用和 50 次GetTraceAPI 调用。
| 类别 | 总配额单元数 |
|---|---|
| 读取操作次数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 提取量配额取决于结算账号历史记录和您申请增加的配额。
轨迹限制
本部分列出了使用 Cloud Trace API 时适用的限制。
API 方法的限制
| API 方法的限制 | 值 |
|---|---|
每次 GetTrace 调用的 Span 数上限 |
1000 |
每次 PatchTraces 调用的 Span 数上限 |
25000 |
每次 ListTraces 调用的跟踪记录数上限 |
ROOTSPAN 和 MINIMAL 视图中为 1,000COMPLETE 视图中为 100 |
span 限制
| span 限制 | 值 |
|---|---|
| span 名称的长度上限 | 128 字节 |
| 每个 span 的标签或属性数量上限 | 32 |
| 标签或属性键的大小上限 | 128 字节 |
| 标签或属性的值大小上限 | 256 字节 |
| 每个 span 的事件数上限 | 128 |
| 要提取的跨度的最大过去时间戳 | 14 天 |
| 要提取的跨度的最远未来时间戳 | 3 天 |
| 事件的过去最长时间戳（相对于跨度时间戳） | 365 天 |
您可以在使用 Cloud Trace API v2 batchWrite 时为 span 添加注释，方法是创建一个 attributes 对象并将其附加到 Span 对象。同样，您可以为 span 添加
方法是创建一个 labels 对象，并将其附加到
TraceSpan 对象（使用
Cloud Trace API v1 patchTraces 方法。
轨迹限制
| 跟踪记录的限制 | 值 |
|---|---|
| 每个跟踪记录的 Span 数上限 | 1,000 |
| 轨迹大小上限 | 50 MB |
Trace 保留期限
| 类别 | 保留期限 |
|---|---|
| Cloud Trace 存储的 Span 数据 | 30 天 |
| 分析报告 | 30 天 |
管理您的配额
本部分介绍如何申请更改配额，以及如何监控 您的配额用量。
请求更改 Cloud Trace API 配额
您可以使用 Google Cloud 控制台请求增加或减少 Cloud Trace API 限额。如需了解详情，请参阅查看和管理配额。
如果出现错误 Edit is not allowed for this quota，您可以与支持团队联系，请求更改配额。另请注意，必须在 Google Cloud 项目中启用结算功能才能点击这些复选框。
监控配额使用情况
请务必批量更新并监控配额用量，以免配额用尽，导致无法了解应用性能。例如，您可以创建一项提醒政策，以便在用量超过阈值时收到通知。如需详细了解如何监控 API 请求并了解其响应，请参阅监控 API 用量。
查看您的 Cloud Trace API 和每日 span 注入配额，请参阅查看和管理配额。
如需了解如何减少您使用的 API 配额单元数和每日 Span 提取量配额单元数，请参阅限制用量。
如需申请增加您的 API 配额单元或每日 Span 提取量配额，请参阅申请更多配额。
如需详细了解如何创建提醒政策来监控 Trace API 配额以及速率跟踪记录 Span 提取量，请参阅创建超出配额的提醒。