EventBridge ルールに関する問題をトラブルシューティングする方法を教えてください。
Amazon EventBridge ルールがターゲットに送信されません。
解決策
注: 以下のトラブルシューティング手順は、すべての EventBridge ターゲットタイプに適用されます。AWS コマンドラインインターフェイス (AWS CLI) コマンドの実行中にエラーが発生した場合は、「AWS CLI のエラーのトラブルシューティング」を参照してください。また、AWS CLI の最新バージョンを使用していることを確認してください。
設定を確認する
EventBridge ルールが正しく設定されていることを確認するには、以下の設定を確認してください。
- ルールが [無効にする] ではなく [有効にする] に設定されている。
- イベントパターンに有効な JSON 構文が使用されている。
- ターゲットの EventBridge ロールに、必要な AWS Identity and Access Management (IAM) アクセス許可がある。
- ターゲットが存在し、EventBridge ルールと同じ AWS リージョンにある。
注: クロスリージョンイベントを設定するには、「Sending and receiving events between AWS Regions in Amazon EventBridge」(Amazon EventBridge の AWS リージョン間でのイベントの送受信) を参照してください。 - リソースベースのポリシーが、EventBridge によるターゲットの呼び出しを許可している。
- イベントソースがイベントを正しいリージョンに発行している。
イベントが発生したことを確認する
注: AWS グローバルサービスは us-east-1 リージョンでのみ利用できます。別のリージョンでこれらのサービスのルールを作成した場合、サービスはイベントを EventBridge に転送しません。その結果、EventBridge はルールを実行しません。
CloudWatch メトリクスを確認する
問題の原因を特定するには、Amazon CloudWatch コンソールの AWS/Events 名前空間で、次の EventBridge メトリクスを確認してください。
- TriggeredRules を確認して、EventBridge がルールを実行したかどうかを確認してください。値が 0 の場合は、API コールを確認してイベントが発生したことを確認します。このメトリクスのタイムスタンプを使用して、イベントがいつ発生したかを確認できます。
- Invocations を確認して、EventBridge がターゲットを呼び出したかどうかを確認します。TriggeredRules に値があり、Invocations には値がない場合、ルールはターゲットを呼び出しませんでした。この問題を解決するには、ルールのターゲット設定を確認してください。
- FailedInvocations を確認して、ターゲットの呼び出しが失敗したかどうかを確認します。Invocations と FailedInvocations の両方に値がある場合、問題はターゲットで発生したことになります。
設定の API コールを確認する
AWS CloudTrail イベント履歴を確認して、イベントの API コールが予定された時間に発生したことを確認します。また、イベントがイベントパターンのすべてのフィールドと一致することを確認してください。
イベントがルールのイベントパターンと一致したことを確認する
EventBridge でルールを実行するには、イベントパターンのすべてのフィールドがそのルールのイベントと一致する必要があります。EventBridge Sandbox ツールを使用して、イベントが特定のイベントパターンフィールドと一致するかどうかをテストします。少数のフィールドを使用するイベントパターンでテストを開始するのがベストプラクティスです。
イベントパターンの例:
{ "source": ["aws.s3"]}
そのイベントパターンにうまく一致したら、イベントパターンの複雑さを増やします。新しいフィールドが増えるたびに、イベントパターンテストの対象が絞り込まれます。
イベントスキームがわからない場合は、Amazon CloudWatch Logs グループのターゲットまたは Amazon Simple Notification Service (Amazon SNS) トピックを一時的にアタッチしてください。EventBridge が CloudWatch Logs グループのターゲットまたは Amazon SNS トピックに配信するイベント構造を確認します。次に、イベントに一致するようにパターンを書き直します。
イベントパターンの例:
{ "source": [ "aws.s3" ], "detail-type": [ "AWS API Call via CloudTrail" ], "detail": { "eventName": [ "PutObject", "DeleteObject", "DeleteObjects" ], "requestParameters": { "bucketName": [ "123456789012-prod-app1" ], "key": [ { "prefix": "feature1/" }, { "prefix": "feature2/" } ] } } }
注: 前述のパターンは、Amazon Simple Storage Service (Amazon S3) の API コールの一覧です。これは、特定の Amazon S3 バケットに対する、feature1 または feature2 で始まるオブジェクトへのAPI コールを照合します。
TestEventPattern API を使用して、イベントがイベントパターンと一致するかどうかを確認することもできます。
イベントが発生している AWS サービスに基づいて、次の一般的なイベントパターンを使用してください。
Amazon Elastic Compute Cloud (Amazon EC2) インスタンスのステータス変更
{ "source": ["aws.ec2"], "detail-type": ["EC2 Instance State-change Notification"], "detail": { "state": ["running", "stopped"] } }
Amazon Relational Database Service (Amazon RDS) のフェイルオーバーまたは障害
{ "source": ["aws.rds"], "detail-type": ["RDS DB Instance Event"], "detail": { "EventCategories": ["failover", "failure"] } }
失敗、タイムアウト、またはキャンセルされた AWS Step Functions の実行
{ "source": ["aws.states"], "detail-type": ["Step Functions Execution Status Change"], "detail": { "status": ["FAILED", "TIMED_OUT", "ABORTED"], "stateMachineArn": ["arn:aws:states:us-east-1:123456789012:stateMachine:MyStateMachine"] } }
イベントパターンの構文を確認する
イベントパターンが次の構文に従っていることを確認してください。
- すべてのフィールド名または値を引用符で囲みます。
- 等号ではなく配列表記を使用してください。例えば、"state": "running" ではなく "state": ["running"] を使用します。
- detail オブジェクトのネストレベルが設定に対して正しいことを確認します。
- すべてのフィールドが一致することを確認します。イベントパターンでは OR ではなく AND ロジックを使用します。
- イベントスキーマに基づいたワイルドカードを正しく使用してください。
ターゲットがイベントを正常に処理したことを確認する
失敗した呼び出しのトラブルシューティング
CloudWatch コンソールの FailedInvocations にデータポイントがある場合は、ターゲットの設定とアクセス許可に問題がないか確認してください。
EventBridge にはターゲットを呼び出すためのアクセス許可が必要です。EventBridge を使用してルールを作成する場合、コンソールは必要なアクセス許可を関連リソースに自動的に追加します。ただし、AWS SDK、AWS CLI、または AWS CloudFormation を使用してルールをデプロイする場合は、アクセス許可を設定する必要があります。必要な EventBridge ポリシーがアタッチされた IAM ロールまたはリソースベースのポリシーを使用できます。
デッドレターキューを設定する
呼び出しが失敗した場合、EventBridge はエクスポネンシャルバックオフを使用して自動的に呼び出しを再試行します。
FailedInvocations の原因を特定するには、次のステップを実行して Amazon Simple Queue Service (Amazon SQS) のデッドレターキューをターゲットに関連付けます。
- EventBridge コンソールを開きます。
- [ルール] を選択し、実際のルールを選択します。
- [ターゲット] でターゲットを選択した後、[編集] を選択します。
- [追加設定] を展開し、[イベントの最大有効期間] と [再試行回数] の値を設定します。
注: EventBridge は、イベントが最大有効期間および再試行回数を超えた後にのみ、デッドレターキューにイベントを送信します。デフォルトでは、これらの値はそれぞれ最大 24 時間、185 回の再試行に設定されています。 - デッドレターキューで、同じまたは別の AWS アカウントの Amazon SQS キューを選択します。次に、EventBridge がイベントの再試行を完了した後に、失敗したイベントをキャプチャするために使用する SQS キューを選択します。
注: 既存のキューがない場合は、SQS キューを作成します。 - [次へ] または [ルールの更新] を選択して変更を保存します。
注: FailedInvocations データポイントがない場合、EventBridge はイベントをターゲットに正常に配信しており、問題はターゲットにあります。例えば、AWS Lambda ターゲットでは、実行時またはスロットリング時にエラーが発生する可能性があります。これらの問題をトラブルシューティングするには、ターゲットの CloudWatch メトリクスとログを確認してください。
デッドレターキューを使用して、失敗した呼び出しをトラブルシューティングする
ルールの呼び出しが失敗した場合は、デッドレターキューにエラーメッセージが記録されます。
このエラーを確認するには、次の手順を実行します。
- Amazon SQS コンソールを開きます。
- [キュー] を選択した後、実際のデッドレターキューを選択します。
- [メッセージの送受信] を選択します。
- [メッセージをポーリング] を選択します。
- リストからエラーメッセージを選択します。
- [属性] でエラーの詳細を確認します。
次のメッセージの例は、EventBridge に Lambda ターゲットを呼び出すために必要なアクセス許可がないことを示しています。"MessageAttributes": { "ERROR_CODE": { "StringValue": "NO_PERMISSIONS", "DataType": "String" }, "ERROR_MESSAGE": { "StringValue": "User: events.amazonaws.com is not authorized to perform: lambda:InvokeFunction on resource: arn:aws:lambda:us-east-1:123456789012:function:Hello_World because no resource-based policy allows the lambda:InvokeFunction action (Service: AWSLambdaInternal; Status Code: 403; Error Code: AccessDeniedException; Request ID: 6635c4c4-9c54-416e-bc40-ef25bad0aca5; Proxy: null)", "DataType": "String" },
関連情報
Troubleshooting Amazon EventBridge (Amazon EventBridge のトラブルシューティング)
Lambda 関数が EventBridge ルールによってトリガーされなかった理由を知りたいです
EventBridge Scheduler のエラーをトラブルシューティングする方法を教えてください
Using dead-letter queues to process undelivered events in EventBridge (EventBridge でデッドレターキューを使用して未配信イベントを処理する)
- 言語
- 日本語
