OTLP 端点
OpenTelemetry 协议(OTLP)是一种专为 OpenTelemetry 设计的通用遥测数据传输协议。CloudWatch OpenTelemetry 端点是 HTTP 1.1 端点。您需要配置 OpenTelemetry 收集器才能开始向 CloudWatch 发送开放的遥测数据。有关更多信息,请参阅 入门。端点使用签名 4 身份验证对调用者进行身份验证。有关更多信息,请参阅适用于 API 请求的 Amazon 签名版本 4。
跟踪端点
跟踪端点遵循模式 https://xray.
。例如,对于美国西部(俄勒冈州)(us-west-2)区域,端点为 Amazon Region
.amazonaws.com/v1/traceshttps://xray.us-west-2.amazonaws.com/v1/traces
。
您需要配置 OpenTelemetry 收集器才能开始向 CloudWatch 发送跟踪。要开始使用,请参阅 入门。
日志端点
日志端点遵循模式 https://logs.
。例如,对于 Amazon Web Services 区域
.amazonaws.com/v1/logsUS West (Oregon) (us-west-2) Region
,端点为 https://logs.us-west-2.amazonaws.com/v1/logs
。您可以使用上述端点将日志转发到现有 LogGroup
和 LogStream
。有关设置 LogGroup
摄取日志数据的更多信息,请参阅 Amazon CloudWatch Logs concepts。在调用 CloudWatch Logs OpenTelemetry 端点时,必须通过将 x-aws-log-group
和 x-aws-log-stream
HTTP 标头分别设置为 LogGroup
和 LogStream
名称来配置 LogGroup
和 LogStream
。有关更多信息,请参阅 入门。
端点限额和限制
该表列出了跟踪和日志的常见端点限额和限制。
限制 | 终端节点 | 其他信息 |
---|---|---|
所需的收集器扩展 |
要向 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 和新的日志端点之间共享。