INFRASTRUCTURE LEARNINGインフラ学習
インフラ大全インフラ大全IT INFRASTRUCTURE / LEARNING
インフラ学習ガイド
教材・演習を探す/

Escで閉じる · 検索語は送信しません

LEARNINGEN

テーマ別の解説テーマ:LambdaとAPI Gateway:入力・テスト・失敗調査

AWS Lambdaのタイムアウトを調べる:実行時間・外部待ち・再試行の切り分け

Lambdaのタイムアウトは、設定された実行期限までに関数が終わらなかった状態です。原因が分かったという意味ではありません。 まず呼出し方法と期限の切れた場所を確かめ、入力の量、外部サービスの待ち、関数内の処理を調べます。期限の延長や再実行を選ぶ前に、結果と副作用を確認しましょう。

この教材で学ぶこと

症状から次に調べる条件を選び、呼出し側の期限・関数の期限・再試行を区別して、根拠のない再実行や設定変更を避けられる。

先に知っておくこと

Lambdaのイベント・ハンドラー・戻り値とログの違い。このページはEvent Functionsの通常の実行環境を中心に扱います。AWSアカウントは不要で、実ログの貼付・関数の作成・設定変更は行いません。

最初に、どこの期限が切れたかを確かめる

似た症状でも、次に見るものが違う
観測したことまだ言えないこと次に確かめること
呼出し側の接続が時間切れ関数が停止した、変更がなかった同じ要求の処理結果と、呼出し側/関数の各期限
関数が期限切れになった記録原因がネットワークだけだった入力条件と、処理/外部待ちの区間
同期Invokeは200だが関数エラー目的の処理に成功したFunctionErrorと関数の戻り値/エラー
非同期Invokeは202関数の完了結果受付後の実行結果、再試行/失敗記録

実行期限と処理時間を分けて読む

実行期限は関数を動かせる時間の設定、処理時間は実際にその処理へ要した時間です。ここで扱う通常の関数では期限は1〜900秒、既定は3秒です。入力や依存先の応答が変われば処理時間も変わるので、平均時間だけに近い設定では余裕が足りないことがあります。

固定例の条件:期限5秒と架空の処理8秒を比べる。位置や線は実時間の縮尺ではない
固定例の条件:期限5秒と架空の処理8秒を比べる。位置や線は実時間の縮尺ではない1: 固定例の条件 — 許される時間 — 実行期限:5秒. 2: 固定例の条件 — 処理に必要とする仮定 — 架空の処理:8秒12固定例の条件実行期限:5秒架空の処理:8秒固定例の条件:期限5秒と架空の処理8秒を比べる。位置や線は実時間の縮尺ではない1: 固定例の条件 — 許される時間 — 実行期限:5秒. 2: 固定例の条件 — 処理に必要とする仮定 — 架空の処理:8秒12固定例の条件実行期限:5秒架空の処理:8秒
  1. 固定例の条件 → 実行期限:5秒許される時間
  2. 固定例の条件 → 架空の処理:8秒処理に必要とする仮定
固定例の条件
同期で実行できたと仮定。二つの時間を比べる。
実行期限:5秒
許される時間。固定モデルでは完了前に期限切れ。
架空の処理:8秒
処理に必要とした仮定値。完了を観測した値ではない。
架空の処理8秒を固定し、期限だけを変える。実AWSの測定結果ではない
架空の処理時間実行期限固定モデル内の結果
8秒3秒期限切れ:処理時間が期限より長い
8秒5秒期限切れ:処理時間が期限より長い
8秒10秒完了:処理時間が期限より短い

入力・待ち時間・処理を、観測から切り分ける

  1. 対象の関数・バージョン/エイリアス・時刻と、同期/非同期/イベントソースマッピングのどれかを記録する。
  2. 同じ要求に対応する戻り値/エラーとログを確認する。呼出APIの200や202だけで成功としない。
  3. 直前の変更、入力の件数/大きさ、依存先の応答区間を比較する。小さいテスト入力で成功しても、大きい入力へ一般化しない。
  4. 観測に合う候補を一つ選ぶ。検証用の同条件で変更前後を比べ、目的の出力と重複した副作用の有無を確認する。
原因を断定せず、候補を絞る
手掛かり確認する条件早まらない判断
入力が大きい時だけ遅い件数・サイズ・値と処理量の関係小さい1例だけで正常とする
外部呼出しを始めた後に待つ依存先の応答、接続先、待ちの期限タイムアウトなら全てSGの問題とする
計算/メモリ負荷が疑われる処理区間・使用量と設定の比較メモリ倍増で時間半減と予測する
ログが見当たらない対象時刻/関数/ログ先、権限、反映の遅れ未実行だったと断定する

メモリ設定は割り当てCPUにも関係しますが、効果は処理によって変わります。VPC接続の調査では経路・通信制御・名前解決などを確かめます。どちらも、設定を変える前に症状と照合し、権限の全開放や無条件のNAT追加で試さないようにします。

具体例:外部サービスの応答を待って期限切れ

架空の観測メモ。CloudWatchの実ログではない
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を保存すればよいという話ではありません。

症状から、次の確認を選んでみる

選択すると、正誤と理由が表示されます。

同期Invokeの200を見て、タイムアウト調査を終えてよいですか?
答えと理由を読む

正解:関数の戻り値とFunctionErrorも見る · 観測したことと、まだ確かめていないことを分けます。

選択すると、正誤と理由が表示されます。

呼出し側が時間切れになり、注文処理の結果が不明です。次は?
答えと理由を読む

正解:同じ要求の結果と重複防止を確認 · 観測したことと、まだ確かめていないことを分けます。

選択すると、正誤と理由が表示されます。

固定モデルで、通常関数の期限5秒・架空の処理8秒です。どうなる?
答えと理由を読む

正解:モデル内では期限切れ · 観測したことと、まだ確かめていないことを分けます。

選択すると、正誤と理由が表示されます。

最後のメモは「外部呼出し開始」で、その後に期限切れでした。分かった原因は?
答えと理由を読む

正解:原因は未確定。応答や待ち区間を調べる · 観測したことと、まだ確かめていないことを分けます。

選択すると、正誤と理由が表示されます。

非同期の関数エラー再試行を0回にすれば、二重処理を防げますか?
答えと理由を読む

正解:保証できない。重複への処理設計が要る · 観測したことと、まだ確かめていないことを分けます。

選択すると、正誤と理由が表示されます。

SQSのイベントソースマッピングへ、非同期の0〜2回設定をそのまま当てはめる?
答えと理由を読む

正解:ソースの再試行/再配送条件を確認する · 観測したことと、まだ確かめていないことを分けます。

確認して、自分の言葉で説明する

  1. 呼出し方法と、どこの期限が切れたかを確認する。
  2. 入力・外部待ち・処理の観測を整理する。
  3. 固定演習で期限を変え、実際には何が未確認かを説明する。
理解を確かめる: 期限を延ばす前に、何を確かめますか?

呼出し方式と期限の場所、入力条件、処理/外部待ちの観測、既に生じた結果と再実行の副作用を確認する。

期限切れは症状であり原因の確定ではありません。応答がないことも、変更がなかった証拠ではありません。

出典と確認した条件

説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。