トラブルシューティング - Amazon CloudWatch

トラブルシューティング

OTLP エンドポイントの一般的なトラブルシューティングシナリオとソリューションを次に示します。

問題 説明 ソリューション

OCB コレクターの起動時に AWS 認証情報が存在しない

コレクターは起動時に次のエラーをスローします。

エラー: 無効な設定: extensions::sigv4auth: 認証情報プロバイダーを取得できませんでした: キャッシュされた認証情報の更新に失敗しました。EC2 IMDS ロールが見つかりません。オペレーションエラー ec2imds: GetMetadata、リクエストがキャンセルされました。コンテキストの期限を超えました。

正しい認証情報を入力します。

AWS 認証情報が無効

コレクターは OTLP エンドポイントを介してリクエストを送信する場合、HTTP ステータスコード 403、「メッセージ = リクエストに含まれるセキュリティトークンが無効です、詳細 = []」をスローします。

 コレクターサーバーの AWS 認証情報を更新します。

トランザクションの検索が無効

コレクターは「メッセージ = OTLP API はトレースセグメントの送信先として CloudWatch Logs をサポートします」をスローします。

 トレースに OTLP エンドポイントを使用する前に、CloudWatch でトランザクション検索が有効になっていることを確認します。詳細については、「Transaction Search」を参照してください。
バッチ処理とタイムアウトの問題

コレクターは、次のいずれかの問題をスローします。

  • 有効期限が切れた最大経過時間が HTTP リクエストの実行に失敗しました

  • io.opentelemetry.exporter.internal.http.HttpExporter - スパンのエクスポートに失敗しました。リクエストを実行できませんでした。完全なエラーメッセージ: タイムアウト

  • io.opentelemetry.exporter.internal.grpc.GrpcExporter - スパンのエクスポートに失敗しました。サーバーが gRPC ステータスコード 2 で応答しました。エラーメッセージ: timeout

  • RPC エラー: code = DeadlineExceeded desc = context deadline exceeded

  • RPC エラー: code = ResourceExhausted desc = Too many requests", "dropped_items": 1024

 batchprocessor を使用してバッチ処理ポリシーとタイムアウトポリシーを調整します。
再試行に関する問題

コレクターと OTLP エンドポイント間の一時的なネットワークの問題。

  • RPC エラー: code = Unavailable desc = error reading from server: read tcp

  • RPC エラー: code = Unavailable desc = unexpected HTTP status code received from server: 502 (不正なゲートウェイ);

  • RPC エラー: code = Unavailable desc = unexpected HTTP status code received from server: 503 (Service Unavailable)

 エクスポーターを使用して再試行ポリシーを調整します。
ペイロードが拒否されました 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 でサポートされているライブラリを参照してください。