本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 疑難排解 以下是 OTLP 端點的常見疑難排解情境與解決方案。 | 問題 | 說明 | 解決方案 | | --- | --- | --- | | 啟動 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 登入資料 | 收集器擲回 HTTP 狀態碼 403，Message=請求中包含的安全字符無效。透過 OTLP 端點傳送請求時，Detail=【】"。 | 重新整理收集器伺服器上的 AWS 登入資料。 | | Transactions Search 已停用 | 收集器擲回訊息 = OTLP API 支援將 CloudWatch Logs 作為追蹤區段目的地。 | 在使用 OTLP 端點進行追蹤之前，確定已在 CloudWatch 中啟用 Transaction Search。如需詳細資訊，請參閱 [Transaction Search](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html)。 | | 批次處理和逾時問題 | 收集器擲回下列其中一個問題：+ 耗時上限已過，未能建立 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](https://github.com/open-telemetry/opentelemetry-collector/tree/main/processor/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](https://github.com/open-telemetry/opentelemetry-collector/blob/main/exporter/exporterhelper/README.md) 調校重試政策。 | | 承載遭拒 | NA | 確定傳送至追蹤端點的承載符合相關限制與規範。如需詳細資訊，請參閱[端點限制和規定](CloudWatch-OTLPEndpoint.md#CloudWatch-LimitsandRestrictions)。 | | 未將驗證標頭插入 ADOT 中的傳出匯出請求 | 一般 403 錯誤，「缺少身分驗證權杖」：
範例：
`ERROR:opentelemetry.exporter.otlp.proto.http.trace_exporter:Failed to export batch code: 403, reason: Missing Authentication Token` | + 確認您使用的 ADOT 版本正確且受支援。
+ 遵循[標準 AWS SDK 登入資料提供者鏈，確保您的登入資料](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html)設定正確 | | CloudWatch 日誌群組中未顯示日誌或範圍 | 預期的 CloudWatch 日誌群組中未顯示日誌或範圍 (對於範圍，為 aws/spans；對於日誌，為指定的自訂日誌群組)。 | 確定自動檢測功能支援要檢測的程式庫。請參閱 [Java](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md)、[Python](http://github.com/open-telemetry/opentelemetry-python-contrib/blob/main/instrumentation/README.md)、[JavaScript](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/packages/auto-instrumentations-node#supported-instrumentations) 和 [.NET](https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/docs/internal/instrumentation-libraries.md) 的受支援程式庫。 |