本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
OTLP 端點
OpenTelemetry Protocol (OTLP) 是專為 OpenTelemetry 設計的通用遙測資料傳輸通訊協定。CloudWatch OpenTelemetry 端點是 HTTP 1.1 端點。必須設定 OpenTelemetry 收集器，才能開始將開放遙測資料傳送至 CloudWatch。如需詳細資訊，請參閱開始使用。
追蹤端點
追蹤端點遵循模式 https://xray.。例如，對於美國西部 (奧勒岡) (us-west-2) 區域，端點將為 AWS
Region.amazonaws.com/v1/traceshttps://xray.us-west-2.amazonaws.com/v1/traces。
必須設定 OpenTelemetry 收集器，才能開始將遙測資料傳送至 CloudWatch。端點會使用 Signature 4 身分驗證來驗證呼叫者。如需詳細資訊，請參閱適用於 API 請求的AWS 簽名版本 4。
日誌端點
日誌端點遵循模式 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 概念。
必須在調用 CloudWatch Logs OpenTelemetry 端點時，分別將 x-aws-log-group 和 x-aws-log-stream HTTP 標頭設定為 LogGroup 和 LogStream 名稱，以設定 LogGroup 和 LogStream。如需詳細資訊，請參閱開始使用。端點會使用 Signature 4 身分驗證來驗證呼叫者。如需詳細資訊，請參閱適用於 API 請求的AWS 簽名版本 4。
當日誌事件大小超過 1MB 時，CloudWatch Logs 會自動截斷最多 10 個欄位，從最大的欄位開始。每個欄位都會視需要截斷，讓總事件大小盡可能接近 1MB。多餘的部分會儲存為大型日誌物件 (LLO)，並新增 LLO 參考系統欄位。亦可透過設定 x-aws-truncatable-fields HTTP 標頭來指定需要截斷的欄位路徑。可以使用 GetLogObject API 擷取和串流回 LLO。如需詳細資訊，請參閱 GetLogObject。美國東部 （維吉尼亞北部） 美國西部 （奧勒岡）、歐洲 （法蘭克福）、亞太區域 （雪梨）、亞太區域 （孟買）、美國東部 （俄亥俄）、歐洲 （愛爾蘭）、亞太區域 （東京） 和亞太區域 （新加坡） 提供大於 1MB 和 LLO 體驗的日誌事件支援。
RUM 端點
RUM 端點遵循模式 https://dataplane.rum.{AWS Region}.amazonaws.com/v1/rum。例如，對於美國西部 （奧勒岡） 區域，端點為 https://dataplane.rum.us-west-2.amazonaws.com/v1/rum。此端點會處理 CloudWatch RUM 應用程式的用戶端遙測資料 （僅限使用 的追蹤和日誌記錄eventName)。
若要使用此端點，您必須使用 Mobile 平台 (Android/iOS) 建立 RUM 應用程式監視器，並使用產生的程式碼片段來檢測您的應用程式。程式碼片段會提取使用此端點設定的 RUM Mobile SDKs。您可以進一步為 RUM 設定SDKs，以相應地收集遙測。
端點支援已驗證和未驗證的請求。您可以將 AWS Signature 第 4 版 (SigV4) 用於已驗證的請求，或以資源為基礎的政策，以允許來自行動應用程式的未驗證存取。
若要進一步了解其 SDKs 中定義的身分驗證模型，請參閱以下內容：
-
iOS 應用程式 - AWS Distro for OpenTelemetry (ADOT) iOS SDK
。 -
Android 應用程式 - AWS Distro for OpenTelemetry (ADOT) Android SDK
。
端點限制和規定
資料表所列為追蹤與日誌的常見端點限制和規定。
| 限制 | Endpoint | 其他資訊 |
|---|---|---|
|
必要的收集器延伸 |
若要將追蹤傳送至 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 的日誌 – 多餘的部分以大型日誌物件 (LLO) 的形式處理。 |
|
每秒請求數 |
5000 |
每個區域每個帳戶每秒 5000 筆交易 可以使用 Service Quotas 服務請求提高每秒限流配額。 |
|
單一資源和範圍大小 |
16 KB |
每個唯一資源和對應範圍的大小不應超過 16 KB。任何資源超出此限制會導致整個 API 呼叫遭拒。 |
|
單一日誌事件 (LogEvent) 大小 |
1 MB |
日誌事件大小等於每個日誌記錄、範圍和資源的大小總和。此配額無法變更。 |
日誌建立的時間戳記 |
未來 2 小時和過去 14 天 |
批次中的日誌記錄不必按時間順序排列。不過，批次中的日誌記錄不能超過未來 2 小時，不能超過過去 14 天。此外，所有日誌記錄的日期均不得早於日誌群組的保留期限。 |
|
事件/請求中的時間間隔上限 |
24 小時 |
|
|
事件/請求上限 |
10,000 個日誌 |
批次中的日誌事件數量上限為 10,000。超出此限制會導致 API 呼叫遭拒。 |
|
大型日誌物件/請求上限 |
1 筆日誌記錄 在美國東部 （維吉尼亞北部）、美國西部 （奧勒岡）、歐洲 （法蘭克福）、亞太區域 （雪梨）、亞太區域 （孟買）、美國東部 （俄亥俄）、歐洲 （愛爾蘭）、亞太區域 （東京） 和亞太區域 （新加坡） 提供。 |
對於日誌事件中超過 1MB 的內容，超出的內容將儲存為 LLO。每個請求僅限 1 筆日誌記錄。 |
|
大型日誌物件/記錄上限 |
10 個 LLO 在美國東部 （維吉尼亞北部）、美國西部 （奧勒岡）、歐洲 （法蘭克福）、亞太區域 （雪梨）、亞太區域 （孟買）、美國東部 （俄亥俄）、歐洲 （愛爾蘭）、亞太區域 （東京） 和亞太區域 （新加坡） 提供。 |
單筆日誌記錄最多可包含 10 個 LLO。 |
注意
日誌的帳戶限制在 SDK 與新的日誌端點之間共用。
