OTLP 端點 - Amazon CloudWatch

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

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。您可以使用上述端點將日誌轉送至現有的 LogGroupLogStream。如需設定 LogGroup以擷取日誌資料的詳細資訊,請參閱 Amazon CloudWatch Logs 概念。您必須分別將 LogGroupx-aws-log-group x-aws-log-stream HTTP 標頭設定為 和 LogStream名稱,以在叫用 CloudWatch Logs OpenTelemetry 端點LogStream時設定 LogGroup和 。如需詳細資訊,請參閱開始使用

端點限制

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

限制 端點 其他資訊

必要的收集器延伸

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 個位元組。

每秒請求數

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 端點共用。