テーマ別の解説テーマ:LambdaとAPI Gateway:入力・テスト・失敗調査
AWS Lambdaのタイムアウトを調べる:実行時間・外部待ち・再試行の切り分け
Lambdaのタイムアウトは、設定された実行期限までに関数が終わらなかった状態です。原因が分かったという意味ではありません。 まず呼出し方法と期限の切れた場所を確かめ、入力の量、外部サービスの待ち、関数内の処理を調べます。期限の延長や再実行を選ぶ前に、結果と副作用を確認しましょう。
症状から次に調べる条件を選び、呼出し側の期限・関数の期限・再試行を区別して、根拠のない再実行や設定変更を避けられる。
Lambdaのイベント・ハンドラー・戻り値とログの違い。このページはEvent Functionsの通常の実行環境を中心に扱います。AWSアカウントは不要で、実ログの貼付・関数の作成・設定変更は行いません。
最初に、どこの期限が切れたかを確かめる
| 観測したこと | まだ言えないこと | 次に確かめること |
|---|---|---|
| 呼出し側の接続が時間切れ | 関数が停止した、変更がなかった | 同じ要求の処理結果と、呼出し側/関数の各期限 |
| 関数が期限切れになった記録 | 原因がネットワークだけだった | 入力条件と、処理/外部待ちの区間 |
| 同期Invokeは200だが関数エラー | 目的の処理に成功した | FunctionErrorと関数の戻り値/エラー |
| 非同期Invokeは202 | 関数の完了結果 | 受付後の実行結果、再試行/失敗記録 |
実行期限と処理時間を分けて読む
実行期限は関数を動かせる時間の設定、処理時間は実際にその処理へ要した時間です。ここで扱う通常の関数では期限は1〜900秒、既定は3秒です。入力や依存先の応答が変われば処理時間も変わるので、平均時間だけに近い設定では余裕が足りないことがあります。
- 固定例の条件 → 実行期限:5秒許される時間
- 固定例の条件 → 架空の処理:8秒処理に必要とする仮定
- 固定例の条件
- 同期で実行できたと仮定。二つの時間を比べる。
- 実行期限:5秒
- 許される時間。固定モデルでは完了前に期限切れ。
- 架空の処理:8秒
- 処理に必要とした仮定値。完了を観測した値ではない。
| 架空の処理時間 | 実行期限 | 固定モデル内の結果 |
|---|---|---|
| 8秒 | 3秒 | 期限切れ:処理時間が期限より長い |
| 8秒 | 5秒 | 期限切れ:処理時間が期限より長い |
| 8秒 | 10秒 | 完了:処理時間が期限より短い |
入力・待ち時間・処理を、観測から切り分ける
- 対象の関数・バージョン/エイリアス・時刻と、同期/非同期/イベントソースマッピングのどれかを記録する。
- 同じ要求に対応する戻り値/エラーとログを確認する。呼出APIの200や202だけで成功としない。
- 直前の変更、入力の件数/大きさ、依存先の応答区間を比較する。小さいテスト入力で成功しても、大きい入力へ一般化しない。
- 観測に合う候補を一つ選ぶ。検証用の同条件で変更前後を比べ、目的の出力と重複した副作用の有無を確認する。
| 手掛かり | 確認する条件 | 早まらない判断 |
|---|---|---|
| 入力が大きい時だけ遅い | 件数・サイズ・値と処理量の関係 | 小さい1例だけで正常とする |
| 外部呼出しを始めた後に待つ | 依存先の応答、接続先、待ちの期限 | タイムアウトなら全てSGの問題とする |
| 計算/メモリ負荷が疑われる | 処理区間・使用量と設定の比較 | メモリ倍増で時間半減と予測する |
| ログが見当たらない | 対象時刻/関数/ログ先、権限、反映の遅れ | 未実行だったと断定する |
メモリ設定は割り当てCPUにも関係しますが、効果は処理によって変わります。VPC接続の調査では経路・通信制御・名前解決などを確かめます。どちらも、設定を変える前に症状と照合し、権限の全開放や無条件のNAT追加で試さないようにします。
具体例:外部サービスの応答を待って期限切れ
mode = synchronous
function_deadline = 5 seconds
input = fixed sample
last_observed_stage = downstream request started
function_result = timeout
root_cause = not establishedこのメモから言えるのは「関数が期限までに完了せず、最後に確認した区間は外部呼出し」ということです。依存先が遅いのか、接続できないのか、後続処理が残ったのかはまだ不明です。次はその呼出しの宛先・応答/エラー・所要区間を確かめ、前の正常例と比較します。
期限の延長は、必要な処理時間と待ちの上限を確認した後の選択肢です。変更後は「時間切れが消えた」だけでなく、目的の結果、処理時間の変動、依存先への負荷、費用への影響も確認します。このページは実変更の指示ではなく、調査の選び方を説明しています。
再試行する前に、誰が再試行するかを確かめる
| 方式 | 今回区別すること | 確認する結果 |
|---|---|---|
| 直接の同期呼出し | Lambdaは関数エラーを自動再試行しない。呼出し側/SDKの再送は別 | 関数結果、呼出し側の設定と再送履歴 |
| 非同期呼出し | 関数エラーの既定追加2回、設定0〜2。スロットリング等は別条件 | 実行結果、イベント期限、失敗先と重複 |
| SQS/ストリーム等のマッピング | キューやストリームごとの規則。上の0〜2を流用しない | ソースの設定、バッチ/個別レコードの扱い |
冪等性は、同じイベントを繰り返し受けても注文の二重登録などを起こさないための処理設計です。例えば同じ注文IDが来たら、既に完了した処理を再登録しない方針を考えます。実装では同時実行、途中失敗、記録の保持期間も設計が必要で、単にメモリへIDを保存すればよいという話ではありません。
症状から、次の確認を選んでみる
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 呼出し方法と、どこの期限が切れたかを確認する。
- 入力・外部待ち・処理の観測を整理する。
- 固定演習で期限を変え、実際には何が未確認かを説明する。
理解を確かめる: 期限を延ばす前に、何を確かめますか?
呼出し方式と期限の場所、入力条件、処理/外部待ちの観測、既に生じた結果と再実行の副作用を確認する。
期限切れは症状であり原因の確定ではありません。応答がないことも、変更がなかった証拠ではありません。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件同期の戻り値・関数エラー・ログと、呼出し側の接続期限を区別する。合成ログは実ログの取得や完全なログ形式の再現ではない。
確認した内容・条件RequestResponseの200とEventの202を区別。状態コードは関数エラーの有無を代替しない。演習は許可/受付を仮定し実APIを呼ばない。
参照した本文最初に、どこの期限が切れたかを確かめる
確認した内容・条件通常の関数の期限は1〜900秒。Managed Instances等の例外は未対応。durationは与えた架空値でメモリ等から推定しない。期限一致の比較は教材内規則。
参照した本文実行期限と処理時間を分けて読む 入力・待ち時間・処理を、観測から切り分ける 具体例:外部サービスの応答を待って期限切れ
確認した内容・条件起動方式とエラー種別で再試行の主体・条件が変わる。同期の関数エラーをLambdaが自動再試行するとは扱わず、キュー/ストリーム型を同一規則にしない。
参照した本文最初に、どこの期限が切れたかを確かめる 入力・待ち時間・処理を、観測から切り分ける 再試行する前に、誰が再試行するかを確かめる 症状から、次の確認を選んでみる
確認した内容・条件関数エラーの既定追加2回と、スロットリング/システムエラーの別条件を区別。成功時も重複配送の可能性があり、実行回数は1+nで保証できない。
参照した本文最初に、どこの期限が切れたかを確かめる 再試行する前に、誰が再試行するかを確かめる 症状から、次の確認を選んでみる
確認した内容・条件MaximumRetryAttemptsの0〜2は関数エラーへの再試行設定。イベント期限/破棄/失敗先は別条件。設定の有効性と実行成功を分ける。実設定は変更しない。
確認した内容・条件実ログの送信には実行ロールの権限等が必要で表示に遅れもある。戻り値とログは別。本演習のログ例は固定合成であり実際の到着を証明しない。
参照した本文入力・待ち時間・処理を、観測から切り分ける
確認した内容・条件初期化・ハンドラー・応答の段階と、入力形式/外部待ち等の調査を区別。JSON構文が正しくても関数独自の値検証は別。本文の観測メモは架空で実ログではない。
参照した本文入力・待ち時間・処理を、観測から切り分ける
確認した内容・条件メモリ設定は割り当てCPUにも関係する。増量の効果は処理/待ち/入力で異なり、設定値だけから実行時間を予測しない。実変更や負荷試験は未実施。
参照した本文入力・待ち時間・処理を、観測から切り分ける
確認した内容・条件VPC接続時の到達性は経路・制御・名前解決等を調査。タイムアウトだけでネットワーク障害と断定せず、全開放や無条件のNAT追加を提案しない。
参照した本文入力・待ち時間・処理を、観測から切り分ける
確認した内容・条件同一イベントの重複処理に備える冪等性と、入力/依存条件を含む性能検証を参照。注文例は概念説明で、永続化・競合・保持期間の実装やexactly-once保証を提供しない。