OTLP 端点 - Amazon CloudWatch
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

OTLP 端点

OpenTelemetry 协议(OTLP)是一种专为 OpenTelemetry 设计的通用遥测数据传输协议。CloudWatch OpenTelemetry 端点是 HTTP 1.1 端点。您需要配置 OpenTelemetry 收集器才能开始向 CloudWatch 发送开放的遥测数据。有关更多信息,请参阅 入门。端点使用签名 4 身份验证对调用者进行身份验证。有关更多信息,请参阅适用于 API 请求的 Amazon 签名版本 4

跟踪端点

跟踪端点遵循模式 https://xray.Amazon Region.amazonaws.com/v1/traces。例如,对于美国西部(俄勒冈州)(us-west-2)区域,端点为 https://xray.us-west-2.amazonaws.com/v1/traces

您需要配置 OpenTelemetry 收集器才能开始向 CloudWatch 发送跟踪。要开始使用,请参阅 入门

日志端点

日志端点遵循模式 https://logs.Amazon Web Services 区域.amazonaws.com/v1/logs。例如,对于 US West (Oregon) (us-west-2) Region,端点为 https://logs.us-west-2.amazonaws.com/v1/logs。您可以使用上述端点将日志转发到现有 LogGroupLogStream。有关设置 LogGroup 摄取日志数据的更多信息,请参阅 Amazon CloudWatch Logs concepts。在调用 CloudWatch Logs OpenTelemetry 端点时,必须通过将 x-aws-log-groupx-aws-log-stream HTTP 标头分别设置为 LogGroupLogStream 名称来配置 LogGroupLogStream。有关更多信息,请参阅 入门

端点限额和限制

该表列出了跟踪和日志的常见端点限额和限制。

限制 终端节点 其他信息

所需的收集器扩展

sigv4authextension

要向 OTLP 端点发送跟踪,必须使用 sigv4authextension

支持的协议

HTTP

该端点仅支持 HTTP 而不支持 gRPC

支持的 OTLP 版本

OTLP 1.x

有效负载格式

二进制,json

该端点接受使用二进制和 json 格式的请求

压缩方法

gzip,none

该端点仅支持 gzip 和 none 压缩方法

该表列出了跟踪的端点限额和限制。

限制 跟踪端点 其他信息

最大未压缩字节数/请求

5MB

未压缩有效载荷时,OTLP 端点将拒绝大于 5 MB 的请求。

最大事件数/请求

1 万个跨度

单个请求中的最大允许跨度数为 1 万个。超过此限制将导致 API 调用被拒绝。

单一资源和范围大小

16 KB

每个唯一资源和相应范围的大小不应超过 16 KB。超过 16 KB 的记录将被拒绝。

单一跨度的最大尺寸

200 KB

超过 200 KB 的跨度将被端点拒绝。

跨度创建的时间戳

未来 2 小时和过去 14 天

批次中的跨度都不能超过未来两个小时,也不能超过过去 14 天。

事件中的最大时间间隔/请求

24 小时

该表列出了日志的端点限额和限制。

限制 日志端点 其他信息

最大未压缩字节数/请求

1 MB

未压缩有效载荷时,OTLP 端点将拒绝大于 1 MB 的请求。

协议缓冲区序列化的二进制数据解压缩和反序列化后,最大请求大小为 1,048,576 字节。此大小的计算方式是 UTF-8 格式的所有事件消息之和加上代表每个日志记录的 26 字节。

每秒请求数

5000

每区域每账户每秒 5000 个事务 您可以使用服务配额服务请求增加每秒节流配额。

最大事件数/请求

1 万个日志

单个请求中的最大允许跨度数为 1 万个。超过此限制将导致 API 调用被拒绝。

单一资源和范围大小

16 KB

每个唯一资源和相应范围的大小不应超过 16 KB。超过 16 KB 的记录将被拒绝。

单一 LogEvent 大小

256 KB

LogEvent 大小是根据每个 LogRecord、范围和资源的大小总和计算得出的。无法更改此配额。

日志创建的时间戳

未来 2 小时,过去 14 天

批次中的日志记录不必按时间顺序排列。但是,批次中的日志记录不能超过未来 2 小时,也不能超过过去 14 天。此外,任何日志记录都不能早于日志组的保留期。

事件中的最大时间间隔/请求

24 小时

注意

日志的账户限制在 SDK 和新的日志端点之间共享。