OTLP 端點

OpenTelemetry Protocol (OTLP) 是專為 OpenTelemetry 設計的通用遙測資料交付通訊協定。CloudWatch OpenTelemetry 端點是 HTTP 1.1 端點。您需要設定 OpenTelemetry 收集器，才能開始將開放遙測資料傳送至 CloudWatch。如需詳細資訊，請參閱開始使用。端點會使用 Signature 4 身分驗證來驗證發起人。如需詳細資訊，請參閱 AWS API 請求的簽章版本 4。

追蹤端點

追蹤端點遵循模式 https://xray.AWS Region.amazonaws.com/v1/traces。例如，對於美國西部 （奧勒岡） (us-west-2) 區域，端點將為 https://xray.us-west-2.amazonaws.com/v1/traces。

您需要設定 OpenTelemetry 收集器，才能開始將追蹤傳送至 CloudWatch。若要開始使用，請參閱開始使用。

記錄端點

日誌端點遵循模式 https://logs.AWS 區域.amazonaws.com/v1/logs。例如，對於 US West (Oregon) (us-west-2) Region，端點將是 https://logs.us-west-2.amazonaws.com/v1/logs。您可以使用上述端點將日誌轉送至現有的 LogGroup和 LogStream。如需設定 LogGroup以擷取日誌資料的詳細資訊，請參閱 Amazon CloudWatch Logs 概念。

您必須在叫用 CloudWatch Logs OpenTelemetry 端點LogGroupLogStream時，分別將 x-aws-log-group 和 x-aws-log-stream HTTP 標頭設定為 和 LogStream 名稱，以設定 LogGroup和 。如需詳細資訊，請參閱開始使用。

當日誌事件大小超過 1MB 時，CloudWatch Logs 會自動截斷最多 10 個欄位，從最大欄位開始。每個欄位都會視需要截斷，讓總事件大小盡可能接近 1MB。多餘的部分會儲存為大型日誌物件 (LLOs)，並新增 LLO 參考系統欄位。或者，您可以透過設定 x-aws-truncatable-fields HTTP 標頭來指定需要截斷的欄位路徑。您可以使用 GetLogObject API 擷取和串流回 LLOs。如需詳細資訊，請參閱 GetLogObject。美國東部 （維吉尼亞北部） 美國西部 （奧勒岡）、歐洲 （法蘭克福） 和亞太區域 （雪梨） 提供大於 1MB 和 LLO 體驗的日誌事件支援。

端點限制

資料表列出追蹤和日誌的常見端點限制和限制。

限制	端點	其他資訊
必要的收集器延伸	sigv4authextension	若要將追蹤傳送至 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 個位元組。
	20 MB 僅適用於美國東部 （維吉尼亞北部） 美國西部 （奧勒岡）、歐洲 （法蘭克福） 和亞太區域 （雪梨）。	在從 JSON 格式解壓縮和解碼 OTLP 承載之後，請求大小上限為 20MB (20，971，520 位元組）。 對於高達 1MB 的日誌 – 這些日誌具有所有 CloudWatch Logs 功能的完整存取權，包括查詢和即時結尾。 對於大於 1MB 的日誌 – 多餘的部分會處理為大型日誌物件 (LLOs)。
每秒請求數	5000	每個區域每個帳戶每秒 5000 筆交易 您可以使用 Service Quotas 服務請求提高每秒限流配額。
單一資源和範圍大小	16 KB	每個唯一資源和對應的範圍不應超過 16 KB 的大小。超過任何資源的此限制會導致整個 API 呼叫遭到拒絕。
單一 LogEvent 大小	1 MB	LogEvent 大小的計算方式為每個 LogRecord、Scope 和資源的大小總和。此配額無法變更。
日誌建立的時間戳記	未來 2 小時和 14 天	批次中的日誌記錄不必按時間順序排列。不過，批次中的日誌記錄不能超過未來的 2 小時，而且不能超過過去的 14 天。此外，日誌記錄不能早於日誌群組的保留期間。
事件/請求中的時間間隙上限	24 小時
事件/請求上限	10，000 個日誌	批次中的日誌事件數目上限為 10，000。超過此限制會導致 API 呼叫遭拒。
大型日誌物件/請求上限	1 筆日誌記錄 在美國東部 （維吉尼亞北部） 美國西部 （奧勒岡）、歐洲 （法蘭克福） 和亞太區域 （雪梨） 提供。	對於日誌事件中超過 1MB 的內容，多餘的內容會儲存為 LLOs。每個請求僅限 1 個日誌記錄。
大型日誌物件/記錄上限	10 LLOs 在美國東部 （維吉尼亞北部） 美國西部 （奧勒岡）、歐洲 （法蘭克福） 和亞太區域 （雪梨） 提供。	單一日誌記錄最多可包含 10 LLOs。

注意

Logs 的帳戶限制會跨 SDK 和新的 Logs 端點共用。