View a markdown version of this page

OTLP 端點 - Amazon CloudWatch
日誌端點指標端點追蹤端點RUM 端點端點限制和規定

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

OTLP 端點

OpenTelemetry Protocol (OTLP) 是專為 OpenTelemetry 設計的通用遙測資料傳輸通訊協定。CloudWatch OpenTelemetry 端點是 HTTP 1.1 端點。必須設定 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 端點時，分別將 x-aws-log-group 和 x-aws-log-stream HTTP 標頭設定為 LogGroup 和 LogStream 名稱，以設定 LogGroup 和 LogStream。如需詳細資訊，請參閱開始使用。

端點支援下列身分驗證方法：

  • AWS Signature 第 4 版 (SigV4) – 建議用於執行 的工作負載 AWS。透過 IAM 角色使用短期憑證。如需詳細資訊，請參閱適用於 API 請求的AWS 簽名版本 4。

  • 承載字符 (API 金鑰） – 適用於在 AWS 或不支援 AWS SDK 的環境外執行的工作負載。需要在目標日誌群組上啟用承載字符身分驗證。如需詳細資訊，請參閱設定 Logs 的承載字符身分驗證。

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

指標端點

指標端點遵循模式 https://monitoring.AWS Region.amazonaws.com/v1/metrics。例如，對於美國西部 (奧勒岡) (us-west-2) 區域，端點將為 https://monitoring.us-west-2.amazonaws.com/v1/metrics。

您需要設定 OpenTelemetry 收集器，才能開始將指標傳送至 CloudWatch。端點支援兩種身分驗證方法：

  • AWS Signature 第 4 版 (SigV4) – 使用短期憑證的建議身分驗證方法。如需詳細資訊，請參閱適用於 API 請求的AWS 簽名版本 4。

  • 承載字符 (API 金鑰） – 適用於在 AWS 或不支援 AWS SDK 的環境外執行的工作負載。使用在 Authorization標頭中傳遞的長期 API 金鑰。如需詳細資訊，請參閱設定指標的承載字符身分驗證。

追蹤端點

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

必須設定 OpenTelemetry 收集器，才能開始將遙測資料傳送至 CloudWatch。端點會使用 Signature 4 身分驗證來驗證呼叫者。如需詳細資訊，請參閱適用於 API 請求的AWS 簽名版本 4。

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 中定義的身分驗證模型，請參閱以下內容：

端點限制和規定

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

限制 Endpoint 其他資訊

必要的收集器延伸

sigv4authextension

若要將指標、日誌或追蹤傳送至 OTLP 端點，您必須使用 sigv4authextension。對於指標和日誌端點，您也可以使用承載字符延伸來驗證承載字符。請參閱 設定指標的承載字符身分驗證或設定 Logs 的承載字符身分驗證。

支援的通訊協定

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 小時

資料表列出指標的端點限制和限制。

限制 指標端點 其他資訊 錯誤碼

最大 TPS

500

每個帳戶每秒允許的請求數上限。

429

新序列建立速率上限

1,000,000

可在 10 分鐘時段內建立的新系列數目上限。此限制僅適用於建立新的指標名稱，不適用於擷取現有指標的資料點。

429 - 請求中的所有指標都會受到限流；200 - 請求中的指標會受到部分限流

請求大小上限

1 MB

請求的未壓縮大小上限。

400

資料點計數上限

1,000

在單一請求中傳送的資料點數目上限。此數字是 ResourceMetrics、ScopeMetrics 和 Metrics 的總和。

400

中繼資料大小上限

40 KB

每個資料點序列接受的所有標籤和標籤值的合併大小上限。

400 - 請求中的所有指標都無效；200 - 請求中的指標部分無效

標籤計數上限

150

每個資料點的 Resource/Scope/Datapoint 屬性標籤數量上限。

400 - 請求中的所有指標都無效；200 - 請求中的指標部分無效

指標建立的時間戳記

未來 10 分鐘和過去 14 天

指標的建立時間戳記最多為未來 10 分鐘，最多為過去 14 天。

400

資料表所列為日誌的端點限制和規定。

限制 日誌端點 其他資訊

解壓縮位元組/請求上限

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 與新的日誌端點之間共用。