テーマ別の解説テーマ:LambdaとAPI Gateway:入力・テスト・失敗調査
Lambdaのテストイベント入門:JSON入力・戻り値・ログの確認手順
テストイベントは、Lambdaの関数へ渡すJSON形式の入力です。 まず入力と期待する戻り値を決め、次に実際の戻り値・関数エラー・ログを別々に読みます。ここでは6×7を計算する架空の関数で、その確認手順を学びます。
一つの入力から期待結果を定め、JSONの構文、関数独自の入力条件、戻り値、ログ、未確認の連携を分けたテスト記録を作れる。
Lambdaのイベントとハンドラー(コードの入口)を知っている人向け。読むだけならAWSアカウントは不要です。このページは実関数を作成・実行せず、コードや実データを収集しません。
実行前に「何を確かめるか」を決める
この教材は通常のLambda Event Functionsの同期テストを扱います。イベント、ハンドラー、戻り値は別の役割です。コンソールのTestは、入力を保存するだけの操作ではなく、対象の関数を同期で呼び出します。
- テストイベント → ハンドラー入力を渡す
- ハンドラー → 戻り値/エラー処理の結果
- ハンドラー → ログ別の出力
- テストイベント
- JSONで渡す入力。今回はlength=6、width=7。
- ハンドラー
- 決めた入力条件を確かめ、6×7を計算する。
- 戻り値/エラー
- 呼出し側が、期待したarea=42と照合する。
- ログ
- 処理の記録。戻り値そのものとは別。
JSONと、関数が要求する入力を分ける
この例の仕様は、lengthとwidthが両方とも0〜100の数値なら、その積をareaとして返すことです。lengthは長さ、widthは幅、areaは面積を表す、この例で決めた項目名です。関数ごとに必要な項目や意味は違います。
{
"length": 6,
"width": 7
}{
"area": 42
}| 入力 | JSONの構文 | この固定関数での結果 |
|---|---|---|
| {"length":6,"width":7} | 正しい | area=42を返す |
| {"length":6} | 正しい | width不足として関数の入力チェックでエラー |
| {"length": | 不正 | この演習では呼出し前の構文チェックで止める |
結果は「呼出し・戻り値・ログ」の順に照合する
| 確認するもの | この例で見ること | これだけでは分からないこと |
|---|---|---|
| 呼出APIの応答 | 同期Invokeの200とFunctionErrorの有無 | 200だけで目的の計算が成功したとは言えない |
| 関数の戻り値 | area=42か、エラーの内容は何か | 戻り値だけでは外部連携やログ到着を証明しない |
| ログ | 対象の実行に対応する記録か | ログがすぐ見えないことだけで未実行とは断定しない |
同期Invokeでは、APIの応答が200でも関数エラーがあり得ます。FunctionErrorがある場合は、返されたエラーの内容も確認します。関数の戻り値にstatusCodeという項目があっても、それをInvoke APIのHTTPステータスと混同しません。
Input: {"length":6,"width":7}
Expected return: {"area":42}
API status (assumed): 200
Function result (modeled): completed
Observed return (modeled): {"area":42}
Log example (synthetic): MODEL_FIXED_HANDLER_RETURN
AWS log delivery: not observed実際のCloudWatch Logsへの送信には、実行ロールの必要な権限などの条件があります。表示が遅れる場合もあるため、関数の戻り値とログの到着を別々に確認します。このサイトの合成ログはCloudWatchから取得していません。
一つだけ条件を変えて、違いを説明する
- まずlength=6、width=7の固定例で、期待値42と戻り値を比べる。
- 次にwidthだけを欠かした例へ変え、JSONの構文は正しいまま、関数の入力チェックで失敗する理由を説明する。
- 最後に構文が壊れたJSONの例と比べ、関数の処理結果とは別の段階で止まることを確認する。
実際のコンソールで確認する場合の境界
ここまでの読解とサイト内の固定演習には、AWSアカウントは不要です。実コンソールのTestは実関数を実行します。 後で試すなら、学習用の対象、アカウントとリージョン、関数の版やエイリアス、権限、外部資源への更新や費用の影響を先に確認します。
- 許可された学習用の関数を選び、どの関数・版へどの入力を渡すかを確認する。
- Testタブで対象のイベントを選ぶか作り、架空データだけでJSONと期待結果を照合する。必要ならPrivateを選び、共有イベントへ実データを保存しない。
- 実行する場合はTestを選び、Execution resultのDetailsで戻り値やエラーを読む。ログは別に確認し、保存したイベントと実行結果を混同しない。
テスト後も、未確認の範囲を残す
この固定例で分かるのは、示した入力と決めた処理の関係です。実際のトリガーが呼び出すこと、AWSの権限、ネットワーク、外部サービス、実行時間や重複時の扱いを確認したことにはできません。実コンソールで一つのイベントが成功しても、連携全体の検査は別に必要です。
記録は「テスト成功」で終えず、何を渡し、何を期待し、何を見て、何をまだ見ていないかまで書きます。例:固定JSONでは42。width不足は関数エラー。AWSログ到着とS3通知からの呼出しは未確認。
結果の読み方を確かめる
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 入力と関数の仕様から、期待する戻り値を決める。
- 呼出APIの応答、戻り値、ログを別々に読む。
- 一つの条件を変え、観測と未確認を記録する。
理解を確かめる: 固定areaの入力を{"length":6}に変えるとエラーになりました。何を確認し、何をまだ確認していませんか?
JSONの構文は正しいが、この関数が要求するwidthが不足しています。実AWSでの実行やログ到着、トリガー連携は未確認です。
構文、関数の入力契約、観測した結果、外部連携の検査範囲を分けて記録します。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件コンソールのJSONテストイベントは同期起動。area/hello/slow/failは当サイトの固定関数で、AWS組込み処理ではない。
確認した内容・条件RequestResponseの200とEventの202を区別。状態コードは関数エラーの有無を代替しない。演習は許可/受付を仮定し実APIを呼ばない。
確認した内容・条件同期の戻り値・関数エラー・ログと、呼出し側の接続期限を区別する。合成ログは実ログの取得や完全なログ形式の再現ではない。
確認した内容・条件実ログの送信には実行ロールの権限等が必要で表示に遅れもある。戻り値とログは別。本演習のログ例は固定合成であり実際の到着を証明しない。
確認した内容・条件起動方式とエラー種別で再試行の主体・条件が変わる。同期の関数エラーをLambdaが自動再試行するとは扱わず、キュー/ストリーム型を同一規則にしない。
参照した本文実際のコンソールで確認する場合の境界
確認した内容・条件関数の入力・処理のテストと、実サービスのイベント通知・設定・権限を含む連携検査は別。固定例や一件のコンソールテストを連携全体の検収と扱わない。実コンソールの試験は実資源・費用・副作用を伴い得る。
参照した本文JSONと、関数が要求する入力を分ける 実際のコンソールで確認する場合の境界 テスト後も、未確認の範囲を残す 結果の読み方を確かめる