本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# OTLP 端點
OpenTelemetry Protocol (OTLP) 是專為 OpenTelemetry 設計的通用遙測資料傳輸通訊協定。CloudWatch OpenTelemetry 端點是 HTTP 1.1 端點。必須設定 OpenTelemetry 收集器，才能開始將開放遙測資料傳送至 CloudWatch。如需詳細資訊，請參閱[開始使用](CloudWatch-OTLPGettingStarted.md)。
## 日誌端點
日誌端點遵循模式 `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 概念](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogsConcepts.html)。
必須在調用 CloudWatch Logs OpenTelemetry 端點時，分別將 `x-aws-log-group` 和 `x-aws-log-stream` HTTP 標頭設定為 `LogGroup` 和 `LogStream` 名稱，以設定 `LogGroup` 和 `LogStream`。如需詳細資訊，請參閱[開始使用](CloudWatch-OTLPGettingStarted.md)。端點會使用 Signature 4 身分驗證來驗證呼叫者。如需詳細資訊，請參閱[適用於 API 請求的AWS 簽名版本 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)。
當日誌事件大小超過 1MB 時，CloudWatch Logs 會自動截斷最多 10 個欄位，從最大的欄位開始。每個欄位都會視需要截斷，讓總事件大小盡可能接近 1MB。多餘的部分會儲存為大型日誌物件 (LLO)，並新增 LLO 參考系統欄位。亦可透過設定 `x-aws-truncatable-fields `HTTP 標頭來指定需要截斷的欄位路徑。可以使用 `GetLogObject` API 擷取和串流回 LLO。如需詳細資訊，請參閱 [GetLogObject](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogObject.html)。美國東部 （維吉尼亞北部） 美國西部 （奧勒岡）、歐洲 （法蘭克福）、亞太區域 （雪梨）、亞太區域 （孟買）、美國東部 （俄亥俄）、歐洲 （愛爾蘭）、亞太區域 （東京） 和亞太區域 （新加坡） 提供大於 1MB 和 LLO 體驗的日誌事件支援。
## 指標端點
指標端點遵循模式 `https://monitoring.{{AWS Region}}.amazonaws.com/v1/metrics`。例如，對於美國西部 (奧勒岡) (us-west-2) 區域，端點將為 `https://monitoring.us-west-2.amazonaws.com/v1/metrics`。
您需要設定 OpenTelemetry 收集器，才能開始將指標傳送至 CloudWatch。端點會使用 Signature 4 身分驗證來驗證呼叫者。如需詳細資訊，請參閱[適用於 API 請求的AWS 簽名版本 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)。
## 追蹤端點
追蹤端點遵循模式 `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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)。
## 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 應用程式監視器](CloudWatch-RUM-get-started-create-app-monitor.md)，並使用產生的程式碼片段來檢測您的應用程式。程式碼片段會提取使用此端點設定的 RUM Mobile SDKs。您可以進一步設定適用於 RUM SDKs，以相應地收集遙測。
端點支援已驗證和未驗證的請求。您可以將 AWS Signature 第 4 版 (SigV4) 用於已驗證的請求，或以資源為基礎的政策，以允許來自行動應用程式的未驗證存取。
若要進一步了解其 SDKs 中定義的身分驗證模型，請參閱以下內容：
+ iOS 應用程式 - [AWS Distro for OpenTelemetry (ADOT) iOS SDK](https://github.com/aws-observability/aws-otel-swift)。
+ Android 應用程式 - [AWS Distro for OpenTelemetry (ADOT) Android SDK](https://github.com/aws-observability/aws-otel-android)。
## 端點限制和規定
資料表列出指標、追蹤和日誌的常見端點限制和限制。
| 限制 | Endpoint | 其他資訊 |
| --- | --- | --- |
| 必要的收集器延伸 | [sigv4authextension](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/extension/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 小時 | |
資料表列出指標的端點限制和限制。
| 限制 | 指標端點 | 其他資訊 | 錯誤碼 |
| --- | --- | --- | --- |
| 最大 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 - 請求中的指標部分無效 |
資料表所列為日誌的端點限制和規定。
- ** 解壓縮位元組/請求上限**
- **日誌端點:** 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 與新的日誌端點之間共用。