
EventBridge Schedulerが失敗したとき、どのエラーなら再試行されるのか?Lambda例外・権限なし・スロットリングで確かめてみた
はじめに
おはようございます〜
クラウド事業統括本部/プロフェッショナルサービス事業本部/運用イノベーション部の三ツ口寛太です(╹◡╹)
今回は、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テンプレート
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側のメトリクスやエラーの見張りも用意しておくのが良さそうです。
最後に
本日の写真はこちら!(ででん)

長野県 美ヶ原高原に行った時の写真です。標高が高めなのですが、ちょうど雲がかかって雲の中に入りました☁️
とっても幻想的で綺麗でした〜〜!
最後までご覧いただきありがとうございます!
参考
- Configuring a schedule's dead-letter queue(EventBridge Scheduler)
- Getting started with EventBridge Scheduler
- Monitoring Amazon EventBridge Scheduler with Amazon CloudWatch
- Schedule types in EventBridge Scheduler
- RetryPolicy(EventBridge Scheduler API Reference)
- Invoke a Lambda Event Function on a schedule(AWS Lambda)







