翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

スケジュールされたクエリのトラブルシューティング

これらのトラブルシューティングトピックを使用して、スケジュールされたクエリに関する一般的な問題を解決します。

クエリの実行がアクセス許可エラーで失敗する

スケジュールされたクエリの実行または送信先への結果の配信を妨げるアクセス許可エラーを解決します。

アクセス許可エラーは、実行ロールにロググループからの読み取りまたは送信先リソースへの書き込みに必要なアクセス許可がない場合に発生します。

一般的な原因には、IAM アクセス許可の欠落、ポリシー内のリソース ARNs の誤り、信頼ポリシーの設定の問題などがあります。

アクセス許可エラーを防ぐには、スケジュールされたクエリを本番環境にデプロイする前に、実行ロールとテストアクセス許可を作成するときに最小特権の原則を使用します。

クエリのタイムアウト

スケジュールされたクエリが最大実行時間制限を超えたときに発生するタイムアウトエラーを解決します。

クエリのタイムアウトは、クエリが指定されたデータ範囲の処理に 60 分以上かかる場合に発生します。多くの場合、大規模なデータセットや複雑なクエリロジックが原因です。

一般的な原因には、大規模な時間範囲のクエリ、大量のロググループの処理、適切なフィルタリングなしでの複雑な集計の使用などがあります。

タイムアウトを防ぐには、CloudWatch Logs Insights で予想されるデータボリュームを使用してクエリを手動でテストし、スケジューリング前にパフォーマンスを最適化します。

送信先処理が失敗する

スケジュールされたクエリ結果を設定された送信先に配信できない場合に発生する障害を解決します。

送信先処理の失敗は、ターゲット Amazon S3 バケットまたは EventBridge イベントバスにアクセスできないか、正しく設定されていない場合に発生します。

一般的な原因には、宛先リソースの削除または名前の変更、宛先 URIs誤り、ネットワーク接続の問題などがあります。

送信先の障害を防ぐには、送信先設定を定期的に検証し、送信先リソースの可用性をモニタリングします。

無効なクエリエラー

スケジュールされたクエリ文字列の構文エラーとロジックエラーを解決して、正常に実行できないようにします。

無効なクエリエラーは、クエリ文字列に構文エラーが含まれている場合、存在しないフィールドを参照する場合、またはサポートされていないクエリ言語機能を使用する場合に発生します。

一般的な原因には、フィールド名のタイプミス、誤ったクエリ構文、スケジュールされた実行環境でサポートされていないクエリ機能の使用などがあります。

無効なクエリエラーを防ぐには、スケジュールする前にクエリをインタラクティブにテストし、フィールド検出機能を使用してフィールド名を検証します。

クエリ同時実行エラー

スケジュールされたクエリが Cloudwatch Logs インサイトクエリと同じクォータを使用していると同時実行エラーが見られる場合、以下に留意すべき重要な点がいくつかあります。同時実行数の制限に達しないように、スケジュールを分散することをお勧めします。