故障診斷 - Amazon CloudWatch

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

故障診斷

以下是 OTLP 端點的常見故障診斷案例和解決方案。

問題 描述 解決方案

啟動 OCB 收集器時不存在的 AWS 登入資料

收集器會在啟動時擲出下列錯誤。

錯誤：無效的組態： extensions：：sigv4auth： 無法擷取登入資料提供者： 無法重新整理快取的登入資料、找不到 EC2 IMDS 角色、操作錯誤 ec2imds： GetMetadata、請求已取消、超過內容截止日期。

輸入正確的登入資料。

無效的 AWS 登入資料

收集器擲出 HTTP 狀態碼 403，Message=請求中包含的安全字符無效。透過 OTLP 端點傳送請求時，Detail=【】“。

 重新整理收集器伺服器上的 AWS 登入資料。

交易搜尋已停用

收集器擲回訊息 = CloudWatch Logs 支援 OTLP API 做為追蹤區段目的地。

 在使用 OTLP 端點進行追蹤之前，請確定已在 CloudWatch 中啟用交易搜尋。如需詳細資訊，請參閱交易搜尋。
批次處理和逾時問題

收集器擲回下列其中一個問題：

  • 過期的經過時間上限無法提出 HTTP 請求

  • io.opentelemetry.exporter.internal.http.HttpExporter - 匯出範圍失敗。無法執行請求。完整錯誤訊息：逾時

  • io.opentelemetry.exporter.internal.grpc.GrpcExporter - 匯出範圍失敗。伺服器以 gRPC 狀態碼 2 回應。錯誤訊息：逾時

  • rpc 錯誤：程式碼 = DeadlineExceeded desc = 超過內容截止日期

  • rpc 錯誤：code = ResourceExhausted desc = 太多請求"， "dropped_items"： 1024

 使用批次處理器調校批次處理和逾時政策。
重試問題

收集器和 OTLP 端點之間的暫時性網路問題。

  • rpc 錯誤：程式碼 = 無法使用描述 = 從伺服器讀取錯誤：讀取 tcp

  • rpc 錯誤：程式碼 = 無法使用描述 = 從伺服器收到的非預期 HTTP 狀態碼：502 （無效的閘道）；

  • rpc 錯誤：程式碼 = 無法使用描述 = 從伺服器收到的非預期 HTTP 狀態碼：503 （服務無法使用）

 使用匯出工具調校重試政策。
承載遭拒 NA 確定傳送至追蹤端點的承載在限制範圍內。如需詳細資訊，請參閱端點限制。
沒有將驗證標頭插入 ADOT 中的傳出匯出請求

一般 403 錯誤，「缺少身分驗證字符」：

範例：

ERROR:opentelemetry.exporter.otlp.proto.http.trace_exporter:Failed to export batch code: 403, reason: Missing Authentication Token
CloudWatch 日誌群組中未顯示的日誌或範圍 預期的 CloudWatch 日誌群組中不會顯示日誌或跨度 (aws/spans 代表跨度， 代表指定的自訂日誌群組）。 確定自動檢測支援要檢測的程式庫。請參閱 Java、Python、JavaScript 和 .NET 支援的程式庫。