疑難排解 - Amazon CloudWatch

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

疑難排解

以下是 OTLP 端點的常見疑難排解情境與解決方案。

問題 Description 解決方案

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

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

Error: invalid configuration: extensions::sigv4auth: could not retrieve credential provider: failed to refresh cached credentials, no EC2 IMDS role found, operation error ec2imds: GetMetadata, request canceled, context deadline exceeded。

輸入正確憑證。

無效的 AWS 登入資料

當透過 OTLP 端點傳送請求時，收集器擲出 HTTP 狀態碼 403，訊息為「請求中包含的安全憑證無效」，詳細資訊為「[]」。

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

Transactions Search 已停用

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

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

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

  • 耗時上限已過，未能建立 HTTP 請求

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

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

  • rpc error: code = DeadlineExceeded desc = context deadline exceeded

  • rpc error: code = ResourceExhausted desc = Too many requests", "dropped_items": 1024

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

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

  • rpc error: code = Unavailable desc = error reading from server: read tcp

  • rpc error: code = Unavailable desc = unexpected HTTP status code received from server: 502 (Bad Gateway);

  • rpc error: code = Unavailable desc = unexpected HTTP status code received from server: 503 (Service Unavailable)

 使用 exporter 調校重試政策。
承載遭拒 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 的受支援程式庫。