Cloud Trace 实行两种不同类型的配额：API 请求的速率配额，以及发送给 Trace 的 Span 的提取量配额。
Trace 配额
下表汇总了可供读取和写入的配额单位数
操作数以及提取 span 的每日配额。例如：
这三个 API 在每 60 秒内达到 300 次
命令 GetTrace、ListTraces 和 ListSpan。以下两个不同示例说明了您可以如何使用全部可用配额单元。
- 每 60 秒进行 12 次
ListTracesAPI 调用。 - 每 60 秒进行 10 次
ListTracesAPI 调用和 50 次GetTraceAPI 调用。
| 类别 | 总配额单元数 |
|---|---|
| 读取操作次数1 | 每 60 秒 300 个 |
| 写入操作次数2 | 每 60 秒 4800 个 |
| 注入的 span3 | 每天 300 万 - 每天 50 亿 |
<ph type="x-smartling-placeholder"></ph>
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 天 |
| 事件的过往时间戳（相对于跨度时间戳） | 365 天 |
您可以通过创建 attributes 对象来为 span 添加注解
并在调用时将其附加到 Span 对象，
您可以使用 Cloud Trace API v2 batchWrite。同样，您可以为 span 添加
方法是创建一个 labels 对象，并将其附加到
TraceSpan 对象（使用
Cloud Trace API v1 patchTraces 方法。
跟踪记录的限制
| 跟踪记录的限制 | 值 |
|---|---|
| 每个跟踪记录的 Span 数上限 | 1,000 |
| 跟踪记录大小上限 | 50 MB |
Trace 保留期限
| 类别 | 保留期限 |
|---|---|
| Cloud Trace 存储的 Span 数据 | 30 天 |
| 分析报告 | 30 天 |
管理您的配额
本部分介绍如何申请更改配额，以及如何监控 您的配额用量。
请求更改 Cloud Trace API 配额
您可以使用 Google Cloud 控制台。 如需了解详情，请参阅查看和管理配额。
如果出现错误 Edit is not allowed for this quota，您可以与支持团队联系，请求更改配额。另请注意，必须在
Google Cloud 项目中，点击相应复选框。
监控配额用量
为了确保配额不会用尽，导致无法观测 应用的因此请确保批量更新并监控 配额用量。例如，您可以创建一项提醒政策， 并在您的用量超过阈值时通知您。 如需详细了解如何监控 API 请求并了解其响应，请参阅监控 API 用量。
查看您的 Cloud Trace API 和每日 span 注入配额，请参阅查看和管理配额。
了解如何减少 API 配额单元数和每日 span 请参阅限制用量。
申请增加 API 配额 单元数或每日 Span 注入配额，请参阅 申请更多配额。
如需详细了解如何创建提醒政策来监控 Trace API 配额以及速率跟踪记录 Span 提取量，请参阅创建超出配额的提醒。