OTLP 端点
OpenTelemetry 协议（OTLP）是一种专为 OpenTelemetry 设计的通用遥测数据传输协议。CloudWatch OpenTelemetry 端点是 HTTP 1.1 端点。您需要配置 OpenTelemetry 收集器才能开始向 CloudWatch 发送开放的遥测数据。有关更多信息，请参阅 入门。端点使用签名 4 身份验证对调用者进行身份验证。有关更多信息，请参阅适用于 API 请求的 AWS 签名版本 4。
跟踪端点
跟踪端点遵循模式 https://xray.。例如，对于美国西部（俄勒冈州）（us-west-2）区域，端点为 AWS Region.amazonaws.com/v1/traceshttps://xray.us-west-2.amazonaws.com/v1/traces。
您需要配置 OpenTelemetry 收集器才能开始向 CloudWatch 发送跟踪。要开始使用，请参阅 入门。
日志端点
日志端点遵循模式 https://logs.。例如，对于 AWS 区域.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。有关更多信息，请参阅 入门。
当日志事件大小超过 1 MB 时，CloudWatch Logs 会自动从最大字段开始截断，最多可截断 10 个字段。每个字段会根据需要被截断，使事件总大小尽可能接近 1 MB。超出的部分将存储为大型日志对象（LLO），同时会添加 LLO 引用系统字段。您也可以通过设置 x-aws-truncatable-fields HTTP 标头，自行指定需要截断的字段路径。使用 GetLogObject API 可以检索 LLO 并将其流式返回。有关更多信息，请参阅 GetLogObject。美国东部（弗吉尼亚州北部）、美国西部（俄勒冈州）、欧洲地区（法兰克福）和亚太地区（悉尼）支持超过 1 MB 的日志事件和 LLO 功能。
端点限额和限制
该表列出了跟踪和日志的常见端点限额和限制。
| 限制 | 终端节点 | 其他信息 |
|---|---|---|
|
所需的收集器扩展 |
要向 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。任何资源若超过此限制，将导致整个 API 调用被拒绝。 |
|
单一跨度的最大尺寸 |
200 KB |
超过 200 KB 的跨度将被端点拒绝。 |
|
跨度创建的时间戳 |
未来 2 小时和过去 14 天 |
批次中的跨度都不能超过未来两个小时，也不能超过过去 14 天。 |
|
事件中的最大时间间隔/请求 |
24 小时 |
该表列出了日志的端点限额和限制。
| 限制 | 日志端点 | 其他信息 |
|---|---|---|
|
最大未压缩字节数/请求 |
1 MB |
未压缩有效载荷时，OTLP 端点将拒绝大于 1 MB 的请求。 协议缓冲区序列化的二进制数据解压缩和反序列化后，最大请求大小为 1,048,576 字节。此大小的计算方式是 UTF-8 格式的所有事件消息之和加上代表每个日志记录的 26 字节。 |
|
20 MB 仅适用以下区域：美国东部（弗吉尼亚州北部）、美国西部（俄勒冈州）、欧洲地区（法兰克福）和亚太地区（悉尼）。 |
OTLP 有效载荷经 JSON 格式解压解码后，最大请求大小为 20 MB（20,971,520 字节）。 对于不超过 1 MB 的日志：这些日志拥有对 CloudWatch Logs 所有功能（包括查询和实时跟踪）的完全访问权限。 对于超过 1 MB 的日志：超出的部分将作为大型日志对象（LLO）进行处理。 |
|
每秒请求数 |
5000 |
每区域每账户每秒 5000 个事务 您可以使用服务配额服务请求增加每秒节流配额。 |
|
单一资源和范围大小 |
16 KB |
每个唯一资源和相应范围的大小不应超过 16 KB。任何资源若超过此限制，将导致整个 API 调用被拒绝。 |
|
单一 LogEvent 大小 |
1 MB |
LogEvent 大小是根据每个 LogRecord、范围和资源的大小总和计算得出的。无法更改此配额。 |
日志创建的时间戳 |
未来 2 小时，过去 14 天 |
批次中的日志记录不必按时间顺序排列。但是，批次中的日志记录不能超过未来 2 小时，也不能超过过去 14 天。此外，任何日志记录都不能早于日志组的保留期。 |
|
事件中的最大时间间隔/请求 |
24 小时 |
|
|
最大事件数/请求 |
1 万个日志 |
单个批次最多可包含 1 万条日志事件。超过此限制将导致 API 调用被拒绝。 |
|
大型日志对象数/请求数量上限 |
1 条日志记录 适用区域：美国东部（弗吉尼亚州北部）、美国西部（俄勒冈州）、欧洲地区（法兰克福）和亚太地区（悉尼）。 |
当日志事件内容超过 1 MB 时，超出部分将存储为 LLO。单次请求仅限处理 1 条日志记录。 |
|
大型日志对象数/记录数量上限 |
10 个 LLO 适用区域：美国东部（弗吉尼亚州北部）、美国西部（俄勒冈州）、欧洲地区（法兰克福）和亚太地区（悉尼）。 |
一条日志记录最多可以包含 10 个 LLO。 |
注意
日志的账户限制在 SDK 和新的日志端点之间共享。
