EventBridge Schedulerが失敗したとき、どのエラーなら再試行されるのか?Lambda例外・権限なし・スロットリングで確かめてみた

EventBridge Schedulerが失敗したとき、どのエラーなら再試行されるのか?Lambda例外・権限なし・スロットリングで確かめてみた

EventBridge Schedulerが失敗したとき、本当に再試行されるのか。Lambda例外・権限エラー・スロットリング・フレキシブルタイムウィンドウなど、複数のケースを実際に試して、再試行とDLQの動きを確かめてみました。
2026.11.16

はじめに

おはようございます〜
クラウド事業統括本部/プロフェッショナルサービス事業本部/運用イノベーション部の三ツ口寛太です(╹◡╹)

今回は、EventBridge Schedulerが失敗したとき、再試行とDLQがどう動くのかを、実際にわざと失敗させて確かめてみます🧑‍💻

EventBridge Schedulerには、呼び出しに失敗したときの再試行ポリシーと、再試行を使い切ったイベントの送り先であるDLQがあります。

ただ、どんな失敗なら再試行されるのかは、ドキュメントを読んだだけでは分かりにくいです。Lambdaが例外を投げたとき、権限がないとき、宛先がないとき、Lambdaが処理を受け付けられないとき。それぞれ、Schedulerの再試行は動くのでしょうか?

そこで、いくつかの失敗をわざと起こして確かめてみました!試したのは、Lambdaの例外、権限なし、存在しない宛先、同時実行数0の4種類です。ターゲット側の5xxや429のような一時的なエラーは、試せていません。

この記事で分かること

  • Lambdaが例外を投げたとき、Schedulerの再試行は動くのか
  • 権限なし・存在しないLambda・同時実行数0で、再試行とDLQの動きがどう違うのか
  • 5分のフレキシブルタイムウィンドウで、起動時刻がどれだけばらつくのか

こだわりポイント

  • 全スケジュールを同じ実行時刻に揃えて、並行で比較する
  • 入力JSONにSchedulerのコンテキスト属性を埋め込んで、Lambdaのログから何回目の試行かを見分ける
  • フレキシブルタイムウィンドウは5本を同時に実行して、ばらつきを見る
  • 環境はCloudFormation1枚で構築し、スケジュールはCloudShellのAWS CLIで作る

先に結論

今回の4種類では、Schedulerの再試行は一度も発生しませんでした。

  • A(Lambda例外):Schedulerの再試行は動かなかった。Lambdaは3回呼ばれたが、attempt は3回とも 1。増やしたのはLambda側の再試行だった
  • B1(権限なし):再試行されず、約46秒でDLQへ。RETRY_ATTEMPTS は 0
  • B2(存在しないLambda):再試行されず、約41秒でDLQへ。RETRY_ATTEMPTS は 0
  • B3(同時実行数0):DLQには来なかった。Schedulerから見ると成功で、Lambdaが受け取った直後に破棄していた。Schedulerのスロットリングではなく、Lambda側の挙動
  • D(フレキシブル5分):起動時刻は、予定から約39〜139秒の範囲に散らばった

前提知識:再試行ポリシーとDLQ

公式ドキュメントで確認できた内容を整理します。

項目 内容
最大再試行回数 0〜185回
イベントの最大経過時間 60秒〜24時間
DLQ 標準のSQSキュー。再試行を使い切ったイベントが届く
DLQメッセージの属性 EXHAUSTED_RETRY_CONDITION に MaximumRetryAttempts か MaximumEventAgeInSeconds が入る。再試行できるエラーのときだけ付く
フレキシブルタイムウィンドウ OFF、または最大1440分
  • 既定値は、公式のAPIリファレンスにもDLQのページにも載っていませんでした。
  • どのエラーが再試行できるかの一覧も、公式には見当たりませんでした。
  • 呼び出しは60秒精度です。窓なしで1:00に設定すると、1:00:00〜1:00:59のどこかで動きます。
  • SchedulerはLambdaを非同期で呼びます。

今回の構成


今回の構成と、ケースごとの結果

  • Schedulerは at() の1回限りスケジュールでLambdaを呼ぶ。Lambdaは入力をログに出し、mode=fail のときだけ例外を投げる
  • 失敗したイベントの送り先は、標準SQSのDLQ
  • 実行ロールは2種類。Lambdaを呼べる正常用と、呼べない権限なし用
  • 同時実行数の予約を0にしたLambdaを、もう1つ用意

構築されるリソースと主な設定値

リソース 設定値 設定の意図
Lambda(通常) Python 3.13、タイムアウト10秒、インラインコード 入力と起動時刻をログ出力し、mode=fail で例外を投げる
Lambda(同時実行数0) 同時実行数の予約 0 イベントを受けても処理できない状態にする
SQS(DLQ) 標準キュー、保持1日 再試行を使い切ったイベントの受け皿
IAMロール(正常) lambda:InvokeFunction は関数名の前方一致、DLQへの sqs:SendMessage 存在しない関数でも、権限エラーにならないようにする
IAMロール(権限なし) DLQへの sqs:SendMessage のみ Lambdaを呼べない状況を再現する
CloudWatch Logs Lambda用(保持7日) 起動回数・時刻の確認に使う

スケジュールの設定

ケース ロール ターゲット mode 最大再試行回数 最大経過時間 ウィンドウ
A(Lambda例外) 正常 通常Lambda fail 2 3600秒 OFF
B1(権限なし) 権限なし 通常Lambda ok 5 600秒 OFF
B2(存在しないLambda) 正常 存在しないARN ok 5 600秒 OFF
B3(同時実行数0) 正常 同時実行数0のLambda ok 5 600秒 OFF
D1〜D5(フレキシブル) 正常 通常Lambda ok 0 3600秒 5分

再試行ポリシーの既定値は公式で確認できなかったので、全スケジュールで回数と経過時間を明示して設定しています。

Cは、最大経過時間を試すケースでした。ただ、どのエラーも再試行されなかったので、行っていません。

CloudFormationテンプレート
eventbridge-scheduler-retry.yaml
AWSTemplateFormatVersion: "2010-09-09"
Description: EventBridge Schedulerの失敗時挙動(Lambda例外・エラー種別ごとの再試行とDLQ・フレキシブルタイムウィンドウ)検証用

Resources:
  # 再試行を使い切ったイベントの送り先(標準SQSキュー)
  DeadLetterQueue:
    Type: AWS::SQS::Queue
    Properties:
      QueueName: scheduler-retry-test-dlq
      MessageRetentionPeriod: 86400

  FunctionLogGroup:
    Type: AWS::Logs::LogGroup
    Properties:
      LogGroupName: /aws/lambda/scheduler-retry-test-fn
      RetentionInDays: 7

  FunctionRole:
    Type: AWS::IAM::Role
    Properties:
      AssumeRolePolicyDocument:
        Version: "2012-10-17"
        Statement:
          - Effect: Allow
            Principal: { Service: lambda.amazonaws.com }
            Action: sts:AssumeRole
      ManagedPolicyArns:
        - arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole

  # Schedulerから届いた入力をそのままログに出す。mode=fail のときは例外を投げる
  TestFunction:
    Type: AWS::Lambda::Function
    DependsOn: FunctionLogGroup
    Properties:
      FunctionName: scheduler-retry-test-fn
      Runtime: python3.13
      Handler: index.handler
      Timeout: 10
      Role: !GetAtt FunctionRole.Arn
      Code:
        ZipFile: |
          import json
          from datetime import datetime, timezone

          def handler(event, context):
              now = datetime.now(timezone.utc).isoformat()
              print(json.dumps({"invokedAt": now, "event": event}, ensure_ascii=False))
              if event.get("mode") == "fail":
                  raise Exception("intentional failure")
              return {"ok": True}

  # 同時実行数0用:同時実行数の予約を0にして、受けたイベントを処理できない状態にする
  ThrottledFunction:
    Type: AWS::Lambda::Function
    Properties:
      FunctionName: scheduler-retry-test-throttled-fn
      Runtime: python3.13
      Handler: index.handler
      Timeout: 10
      Role: !GetAtt FunctionRole.Arn
      ReservedConcurrentExecutions: 0
      Code:
        ZipFile: |
          def handler(event, context):
              return {"ok": True}

  # 正常系:Lambdaを呼べて、DLQにも送れるロール
  GoodSchedulerRole:
    Type: AWS::IAM::Role
    Properties:
      RoleName: scheduler-retry-test-good-role
      AssumeRolePolicyDocument:
        Version: "2012-10-17"
        Statement:
          - Effect: Allow
            Principal: { Service: scheduler.amazonaws.com }
            Action: sts:AssumeRole
      Policies:
        - PolicyName: invoke-and-dlq
          PolicyDocument:
            Version: "2012-10-17"
            Statement:
              - Effect: Allow
                Action: lambda:InvokeFunction
                # 存在しない関数(-missing)でも IAM の権限エラーにならないよう、名前の前方一致で許可する
                Resource: !Sub arn:${AWS::Partition}:lambda:${AWS::Region}:${AWS::AccountId}:function:scheduler-retry-test-*
              - Effect: Allow
                Action: sqs:SendMessage
                Resource: !GetAtt DeadLetterQueue.Arn

  # 異常系:Lambdaを呼ぶ権限がない(DLQへ送る権限だけ持つ)ロール
  BadSchedulerRole:
    Type: AWS::IAM::Role
    Properties:
      RoleName: scheduler-retry-test-bad-role
      AssumeRolePolicyDocument:
        Version: "2012-10-17"
        Statement:
          - Effect: Allow
            Principal: { Service: scheduler.amazonaws.com }
            Action: sts:AssumeRole
      Policies:
        - PolicyName: dlq-only
          PolicyDocument:
            Version: "2012-10-17"
            Statement:
              - Effect: Allow
                Action: sqs:SendMessage
                Resource: !GetAtt DeadLetterQueue.Arn

Outputs:
  FunctionArn:
    Value: !GetAtt TestFunction.Arn
  ThrottledFunctionArn:
    Value: !GetAtt ThrottledFunction.Arn
  GoodRoleArn:
    Value: !GetAtt GoodSchedulerRole.Arn
  BadRoleArn:
    Value: !GetAtt BadSchedulerRole.Arn
  DlqArn:
    Value: !GetAtt DeadLetterQueue.Arn
  DlqUrl:
    Value: !Ref DeadLetterQueue

やってみた

1. 環境をデプロイする

CloudShellにテンプレートをアップロードして、スタックをデプロイします。

aws cloudformation deploy \
  --template-file eventbridge-scheduler-retry.yaml \
  --stack-name scheduler-retry-test \
  --capabilities CAPABILITY_NAMED_IAM

デプロイ完了するまでは夕飯何にするか考えましょう。🍚


デプロイと出力値


スタックが CREATE_COMPLETE になった

2. スケジュールを作る

実行時刻は5分後に揃えて、入力JSONに次のコンテキスト属性を埋め込みます。

属性 用途
<aws.scheduler.scheduled-time> 予定時刻。起動時刻との差を見る
<aws.scheduler.execution-id> 同じ実行かの判別
<aws.scheduler.attempt-number> Schedulerの試行回数
mk A-lambda-error   $GOOD_ROLE $FN_ARN fail 2 3600 0
mk B1-no-permission $BAD_ROLE  $FN_ARN ok   5 600  0
mk B2-not-found     $GOOD_ROLE ${FN_ARN}-missing ok 5 600 0
mk B3-throttled     $GOOD_ROLE $THROTTLED_ARN    ok 5 600 0
for i in 1 2 3 4 5; do mk D$i-flexible $GOOD_ROLE $FN_ARN ok 0 3600 5; done

実行予定は、UTCの 2026-11-16T08:09:18 にしました。日本時間だと17:09:18です。


スケジュールの作成結果

スケジュールは、次の関数 mk でまとめて作りました。

mk関数
# $1=名前 $2=ロールARN $3=ターゲットのLambda ARN $4=mode(ok/fail)
# $5=最大再試行回数 $6=最大経過秒 $7=フレキシブル分(0ならOFF)
mk() {
  cat > /tmp/target-$1.json <<JSON
{
  "Arn": "$3",
  "RoleArn": "$2",
  "Input": "{\"case\":\"$1\",\"mode\":\"$4\",\"scheduledTime\":\"<aws.scheduler.scheduled-time>\",\"executionId\":\"<aws.scheduler.execution-id>\",\"attempt\":\"<aws.scheduler.attempt-number>\"}",
  "RetryPolicy": {"MaximumRetryAttempts": $5, "MaximumEventAgeInSeconds": $6},
  "DeadLetterConfig": {"Arn": "${DLQ_ARN}"}
}
JSON
  if [ "$7" = "0" ]; then FW='Mode=OFF'; else FW="Mode=FLEXIBLE,MaximumWindowInMinutes=$7"; fi
  aws scheduler create-schedule --name sch-$1 \
    --schedule-expression "at(${RUN_AT})" --schedule-expression-timezone UTC \
    --flexible-time-window "$FW" \
    --target file:///tmp/target-$1.json --region $AWS_REGION
}


スケジュール一覧。1回限りのスケジュールは、実行後も「有効」のままです

3. ケースA:Lambdaが例外を投げたとき

aws logs tail /aws/lambda/scheduler-retry-test-fn --since 30m

Lambdaのログには、A-lambda-error が3回出ていました。

回 起動時刻(UTC) 予定時刻からの差 前回との間隔 attempt executionId
1回目 08:10:05 約47秒 — 1 936afaba-…
2回目 08:11:10 約112秒 約65秒 1 936afaba-…
3回目 08:13:01 約224秒 約111秒 1 936afaba-…
  • attempt は3回とも 1、executionId も同じです。Schedulerから見ると、呼び出しは1回で成功しています。
  • 2回目と3回目は、Lambdaの非同期呼び出しの再試行です。間隔は約1分、約2分でした。
  • SchedulerのDLQには、何も届きませんでした。
  • B1のDLQメッセージの本文に "InvocationType":"Event" とあり、SchedulerがLambdaを非同期で呼んでいることが分かります。

ログはCloudWatch Logs Insightsで表にして見ます。

fields @timestamp, @message
| filter @message like /invokedAt/
| parse @message '"case": "*"' as case
| parse @message '"attempt": "*"' as attempt
| parse @message '"scheduledTime": "*"' as scheduledTime
| sort @timestamp asc
| display @timestamp, case, attempt, scheduledTime


赤枠が A-lambda-error の3回分

4. ケースB:エラーの種類を変えてみる

aws sqs receive-message --queue-url $DLQ_URL \
  --attribute-names All --message-attribute-names All

SQSコンソールでキューをポーリングすると、メッセージは2件だけでした。B1とB2の分です。


DLQのメッセージ一覧

B1:権限なし

B1-no-permission のメッセージが届いたのは、予定時刻の約46秒後でした。

メッセージ属性 値
ERROR_CODE AccessDeniedException
ERROR_MESSAGE lambda:InvokeFunction を実行する権限がない、という内容
RETRY_ATTEMPTS 0
EXECUTION_ID / SCHEDULED_TIME 実行IDと予定時刻
  • 再試行回数を5回にしていましたが、再試行は行われず、すぐDLQへ送られました。
  • EXHAUSTED_RETRY_CONDITION の属性はありませんでした。公式によると、この属性は再試行できるエラーのときだけ付きます。権限なしは、再試行できないエラーとして扱われたようです。
  • 本文には "InvocationType":"Event" と入力JSONが入っていました。


B1のDLQメッセージの属性

B2:存在しないLambda

B2-not-found のメッセージは、予定時刻の約41秒後に届いていました。

メッセージ属性 値
ERROR_CODE ResourceNotFoundException
ERROR_MESSAGE Function not found と関数のARN
RETRY_ATTEMPTS 0
  • B1と同じく、再試行されずすぐDLQへ送られました。
  • EXHAUSTED_RETRY_CONDITION もありません。存在しない関数も、再試行できないエラーとして扱われたようです。


B2のDLQメッセージの属性

B3:同時実行数の予約0

DLQには何も届きませんでした。Lambdaの Throttles メトリクスにも、記録はありません。

そこで、同時実行数0のLambdaのメトリクスを見ると、AsyncEventsReceived と AsyncEventsDropped が同じ1分間に1件ずつありました。

メトリクス(同時実行数0のLambda) 08:09
AsyncEventsReceived 1
AsyncEventsDropped 1
  • SchedulerはLambdaを非同期で呼ぶので、受け付けられた時点で成功です。
  • そのあと、同時実行数の予約が0のLambdaが、イベントを受け取った直後に破棄していました。
  • 破棄はLambda側で起きるので、SchedulerのDLQにも再試行にも現れません。気づくには、Lambdaの AsyncEventsDropped を見る必要があります。

5. ケースD:フレキシブルタイムウィンドウ5分

5本を同じ予定時刻で作り、実際の起動時刻を比べます。

スケジュール 予定時刻(UTC) 起動時刻(UTC) 差
D1 08:09:18 08:10:15 約57秒
D2 08:09:18 08:11:37 約139秒
D3 08:09:18 08:09:57 約39秒
D4 08:09:18 08:09:58 約40秒
D5 08:09:18 08:11:26 約128秒
  • 窓は5分でしたが、5本とも2分20秒以内に起動しました。起動時刻は5本とも別々でした。
  • 窓なしのA・B1・B2も、予定時刻の約41〜47秒後に動いていました。公式には、すべてのスケジュールは60秒精度で呼び出される、とあります。窓なしなら、1:00の設定は1:00:00〜1:00:59のどこかです。この範囲に収まっています。
  • D2とD5は、60秒を超えて約139秒、約128秒後に動きました。窓の効果だと思います。ただ、サンプルは5本だけなので、幅は目安です。


赤枠が D1〜D5 の5本。予定時刻はすべて 08:09:18

6. CloudWatchメトリクスで見る

AWS/Scheduler のメトリクスで、試行回数やエラー、DLQ送信を確認します。

メトリクスは4つで、ScheduleGroup ごとに見られます。スケジュール別には分けられません。1分ごとの合計は次のとおりです。

メトリクス 08:09 08:10 08:11 合計
InvocationAttemptCount 4 3 2 9
TargetErrorCount 1 1 0 2
InvocationsSentToDeadLetterCount 1 1 0 2
InvocationDroppedCount 1 1 0 2
  • 試行は合計9回で、スケジュール数と同じです。再試行は1回もありませんでした。
  • TargetErrorCount は2で、B1とB2の分です。AとB3は、Schedulerから見るとエラーになっていません。
  • InvocationsSentToDeadLetterCount も2で、DLQのメッセージ数と一致しました。
  • InvocationDroppedCount は、公式の定義では、再試行ポリシーを使い切って呼び出しを打ち切ったときに出るメトリクスです。今回の環境では、再試行が0回だったB1・B2と同じ分に、同じ数が出ていました。ここから一般的なことは言えません。DLQへ送ったときにも出るのかは、公式の説明には書かれていません。
  • メトリクスは遅延や欠落がありえる、と公式にあります。


Schedulerのメトリクス。08:10の値を表示


同時実行数0のLambdaの AsyncEventsReceived と AsyncEventsDropped。08:09の値を表示

結果のまとめ

ケース Schedulerの再試行 DLQ RETRY_ATTEMPTS 備考
A(Lambda例外) 動かない 来ない — attempt は常に1。Lambda側が2回再試行
B1(権限なし) 動かない 約46秒で到達 0 AccessDeniedException
B2(存在しないLambda) 動かない 約41秒で到達 0 ResourceNotFoundException
B3(同時実行数0) 動かない 来ない — Lambda側が受信直後に破棄
D(フレキシブル5分) — — — 起動は予定の約39〜139秒後

注意点

  • 今回の4種類では、Schedulerの再試行は発生しませんでした。 Schedulerが再試行する失敗が何なのかは、分かっていません。ターゲット側の5xxや429のように、再試行されそうな失敗は試していません。
  • 各ケースは1回ずつの結果です。41秒と46秒の差や、5本の39〜139秒は、目安として見てください。
  • Lambdaの例外は、SchedulerのDLQも再試行も使われません。 Schedulerが非同期で呼ぶので、受け付けられた時点で成功です。失敗の面倒は、Lambda側の設定で見る必要があります。
  • 今回、SchedulerのDLQに入ったのは、権限なしと存在しない関数でした。Lambda側の失敗時の送信先と組み合わせた確認は、行っていません。
  • DLQへ送るには、Schedulerの実行ロールに sqs:SendMessage が必要です。
  • DLQの receive-message は、1回で全件が取れないことがあります。
  • EXHAUSTED_RETRY_CONDITION は、再試行できるエラーで回数か経過時間を使い切ったときに付く属性です。今回はどのエラーも再試行されず、確認できませんでした。
  • フレキシブルタイムウィンドウは、at() の1回限りでも効いていました。ただ、公式ドキュメントのone-timeの例は窓なしだけで、at() で使えるとの明記は見当たりませんでした。

まとめ

今回分かったことは、次のとおりです。

  • 権限なしと存在しないLambdaは、再試行されずすぐDLQへ。Lambdaの例外と同時実行数0は、Schedulerから見ると成功扱いだった
  • 今回の4種類では、Schedulerの再試行は発生しなかった。再試行される失敗が何かは、分かっていない
  • Lambdaを呼ぶスケジュールの失敗は、SchedulerのDLQだけでは気づけない。Lambda側の設定とメトリクスも見る
  • 5分のフレキシブルタイムウィンドウでは、起動が約39〜139秒の範囲に散らばった

Lambdaを呼ぶスケジュールは、失敗しても気づきにくいと分かりました。DLQを付けて安心せず、Lambda側のメトリクスやエラーの見張りも用意しておくのが良さそうです。

最後に

本日の写真はこちら!(ででん)

長野県 美ヶ原高原に行った時の写真です。標高が高めなのですが、ちょうど雲がかかって雲の中に入りました☁️
とっても幻想的で綺麗でした〜〜!

最後までご覧いただきありがとうございます!

参考

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事