本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
OTLP 端點
OpenTelemetry Protocol (OTLP) 是專為 OpenTelemetry 設計的通用遙測資料交付通訊協定。CloudWatch OpenTelemetry 端點是 HTTP 1.1 端點。您需要設定 OpenTelemetry 收集器,才能開始將開放遙測資料傳送至 CloudWatch。如需詳細資訊,請參閱開始使用。端點會使用 Signature 4 身分驗證來驗證發起人。如需詳細資訊,請參閱 AWS API 請求的簽章版本 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 概念。您必須分別將 LogGroup
和 x-aws-log-group
x-aws-log-stream
HTTP 標頭設定為 和 LogStream
名稱,以在叫用 CloudWatch Logs OpenTelemetry 端點LogStream
時設定 LogGroup
和 。如需詳細資訊,請參閱開始使用。
端點限制
資料表列出追蹤和日誌的常見端點限制和限制。
限制 | 端點 | 其他資訊 |
---|---|---|
必要的收集器延伸 |
若要將追蹤傳送至 OTLP 端點,您必須使用 sigv4authextension |
|
支援的通訊協定 |
HTTP |
端點僅支援 HTTP 且不支援 gRPC |
支援的 OTLP 版本 |
OTLP 1.x |
|
承載格式 |
二進位、json |
端點接受使用二進位和 json 格式的請求 |
壓縮方法 |
gzip,無 |
端點僅支援 gzip 和無壓縮方法 |
資料表列出追蹤的端點限制和限制。
限制 | 追蹤端點 | 其他資訊 |
---|---|---|
未壓縮位元組上限/請求 |
5 MB |
卸載承載時,OTLP 端點會拒絕大於 5MB 的請求。 |
事件/請求上限 |
10,000 個範圍 |
一個請求中允許的最大範圍數量為 10,000。超過此限制會導致 API 呼叫遭拒。 |
單一資源和範圍大小 |
16 KB |
每個唯一資源和對應的範圍不應超過 16 KB 的大小。超過任何資源的此限制會導致整個 API 呼叫遭拒。 |
單一跨度大小上限 |
200 KB |
端點將拒絕超過 200KB 的跨度。 |
跨度建立的時間戳記 |
未來 2 小時和過去 14 天 |
批次中沒有任何範圍可以超過未來兩個小時或超過過去 14 天。 |
事件/請求中的時間差距上限 |
24 小時 |
資料表列出日誌的端點限制和限制。
限制 | 日誌端點 | 其他資訊 |
---|---|---|
未壓縮位元組上限/請求 |
1 MB |
卸載承載時,OTLP 端點會拒絕大於 1MB 的請求。 在解壓縮和還原序列化依通訊協定緩衝區序列化的二進位資料之後,請求大小上限為 1,048,576 個位元組。此大小的計算方式為 UTF-8 中所有事件訊息的總和,加上每個日誌記錄的 26 個位元組。 |
每秒請求數 |
5000 |
每個區域每個帳戶每秒 5000 筆交易 您可以使用 Service Quotas 服務請求提高每秒限流配額。 |
事件/請求上限 |
10,000 個日誌 |
一個請求中允許的最大範圍數量為 10,000。超過此限制會導致 API 呼叫遭拒。 |
單一資源和範圍大小 |
16 KB |
每個唯一資源和對應的範圍不應超過 16 KB 的大小。超過任何資源的此限制會導致整個 API 呼叫遭拒。 |
單一 LogEvent 大小 |
1 MB |
LogEvent 大小的計算方式為每個 LogRecord、範圍和資源的大小總和。此配額無法變更。 |
日誌建立的時間戳記 |
未來 2 小時和 14 天 |
批次中的日誌記錄不必依時間順序排列。不過,批次中的日誌記錄不能超過未來 2 小時,而且不能超過過去 14 天。此外,日誌記錄不能早於日誌群組的保留期間。 |
事件/請求中的時間差距上限 |
24 小時 |
注意
Logs 的帳戶限制會跨 SDK 和新的 Logs 端點共用。