演習テーマ:LambdaとAPI Gateway:入力・テスト・失敗調査
Lambdaテストイベント演習:入力・戻り値・ログとタイムアウトを読み分ける
呼出しを受け付けたことと、関数が目的の処理を終えたことは別です。 この演習では固定条件を変え、同期200+関数エラー、タイムアウト、非同期202+結果未確認を見比べます。実AWSや利用者のコードを実行しません。
入力JSON、呼出し側への応答、関数の戻り値とログを分け、設定変更後の結果と未確認を自分の言葉で説明できる。
Lambdaのイベントとハンドラーの役割。AWSアカウントや実ログは不要です。関数の作成・呼出し・設定変更は行いません。
この演習で変える条件と、変えない仮定
最初の例は、同期で呼び出せたが、固定関数がエラーを返した場面です。「呼出APIの応答」と「関数の結果」を隣で見比べます。どちらも実通信の記録ではなく、用意した条件に対する演習内の例です。
条件を変えて、結果の段階を読み分ける
すべて固定の学習用データです。実AWSの実行・実ログの取得・入力の保存や送信はありません。処理時間は架空の値です。
2. 結果の段階を確認する
条件が変わりました。下は変更前の結果です。もう一度確かめてください。
条件1 / 判定1固定関数でエラーになります
呼出APIの応答例
200:同期の呼出しを仮定
関数の結果
固定関数のエラー
固定fail関数がエラーを返す条件です。呼出APIの200とは別に読んでください。
戻り値・エラーの例
{
"errorType": "SyntheticExampleError"
}ログ例(合成)
MODEL_FIXED_HANDLER_THROW · 1s
非同期の再試行計画
この条件では非同期の再試行計画を表示しません。
再試行0回も、一度だけの処理を保証しません。
判定の範囲と根拠を確認
- モデル
- lambda-fixed-1
- 理由コード
- L22_FUNCTION_ERROR
- 確認していないこと
- 実際の許可・実行時間・呼出回数・ログの到着・ネットワーク・メモリ性能
入力・戻り値・ログを分ける
- テストイベント → 固定ハンドラーJSON入力
- 固定ハンドラー → 関数の戻り値戻り値/エラー
- 固定ハンドラー → ログ例合成ログ
- テストイベント
- 固定の入力JSONを選ぶ。
- 固定ハンドラー
- 定めた処理だけをモデル化する。
- 関数の戻り値
- 呼出し側への結果またはエラー。
- ログ例
- 戻り値とは別の合成記録。
{
"length": 6,
"width": 7
}areaでは、この二つが0〜100の数値なら6×7を計算し、戻り値は{"area": 42}です。ログ例のMODEL_FIXED_HANDLER_RETURNは、この教材が別枠で示す合成記録です。実AWSから取得したログや、AWS共通の組込み関数ではありません。
同じ条件を、段階ごとの結果で比べる
| 条件 | 呼出APIの応答例 | 関数の結果 |
|---|---|---|
| 同期・fail・期限3秒/処理1秒 | 200 | 固定関数のエラー |
| 同期・slow・期限3秒/処理8秒 | 200 | 期限切れ |
| 同期・slow・期限10秒/処理8秒 | 200 | この固定処理は完了 |
| 同期・slow・処理時間が不明 | 200を仮定 | 期限との比較は未確認 |
| 非同期・再試行0〜2回を設定 | 202を仮定 | 受付後の実行結果は未確認 |
非同期の再試行と、未確認を残す理由
再試行0〜2回は、非同期の関数エラーへの設定です。最初の実行に加えて最大何回を計画するかを示します。スロットリング/システムエラーや、SQSなどのイベントソースマッピングの規則とは同じではありません。
Managed Instancesやイベントソースマッピングを選ぶと、この演習は未対応と表示します。通常の関数の900秒上限を、別の実行方式へ勝手に適用しません。処理時間が不明な場合も、速かった/遅かったという結果を作り足しません。
結果の意味を確かめる
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 初期例の200と関数エラーを別々に読む。
- slowの期限3秒を10秒に変え、再評価する。
- 非同期と再試行0/2を比べ、未確認を説明する。
理解を確かめる: 非同期で202が返り、再試行は0回です。関数の成功と一度だけの処理を保証できますか?
保証できない。受付、関数の実行結果、重複の可能性を分けて確認する。
202は完了の証拠ではなく、再試行設定だけで重複配送を排除できるわけでもありません。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件コンソールのJSONテストイベントは同期起動。area/hello/slow/failは当サイトの固定関数で、AWS組込み処理ではない。
参照した本文入力・戻り値・ログを分ける
確認した内容・条件RequestResponseの200とEventの202を区別。状態コードは関数エラーの有無を代替しない。演習は許可/受付を仮定し実APIを呼ばない。
確認した内容・条件同期の戻り値・関数エラー・ログと、呼出し側の接続期限を区別する。合成ログは実ログの取得や完全なログ形式の再現ではない。
確認した内容・条件通常の関数の期限は1〜900秒。Managed Instances等の例外は未対応。durationは与えた架空値でメモリ等から推定しない。期限一致の比較は教材内規則。
確認した内容・条件起動方式とエラー種別で再試行の主体・条件が変わる。同期の関数エラーをLambdaが自動再試行するとは扱わず、キュー/ストリーム型を同一規則にしない。
参照した本文非同期の再試行と、未確認を残す理由
確認した内容・条件関数エラーの既定追加2回と、スロットリング/システムエラーの別条件を区別。成功時も重複配送の可能性があり、実行回数は1+nで保証できない。
参照した本文非同期の再試行と、未確認を残す理由
確認した内容・条件MaximumRetryAttemptsの0〜2は関数エラーへの再試行設定。イベント期限/破棄/失敗先は別条件。設定の有効性と実行成功を分ける。実設定は変更しない。
確認した内容・条件実ログの送信には実行ロールの権限等が必要で表示に遅れもある。戻り値とログは別。本演習のログ例は固定合成であり実際の到着を証明しない。
参照した本文入力・戻り値・ログを分ける