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

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

LEARNINGEN

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

Lambdaのテストイベント入門:JSON入力・戻り値・ログの確認手順

テストイベントは、Lambdaの関数へ渡すJSON形式の入力です。 まず入力と期待する戻り値を決め、次に実際の戻り値・関数エラー・ログを別々に読みます。ここでは6×7を計算する架空の関数で、その確認手順を学びます。

この教材で学ぶこと

一つの入力から期待結果を定め、JSONの構文、関数独自の入力条件、戻り値、ログ、未確認の連携を分けたテスト記録を作れる。

先に知っておくこと

Lambdaのイベントとハンドラー(コードの入口)を知っている人向け。読むだけならAWSアカウントは不要です。このページは実関数を作成・実行せず、コードや実データを収集しません。

実行前に「何を確かめるか」を決める

この教材は通常のLambda Event Functionsの同期テストを扱います。イベント、ハンドラー、戻り値は別の役割です。コンソールのTestは、入力を保存するだけの操作ではなく、対象の関数を同期で呼び出します。

入力から処理へ進み、戻り値とログを別々に読む
入力から処理へ進み、戻り値とログを別々に読む1: テストイベント — 入力を渡す — ハンドラー. 2: ハンドラー — 処理の結果 — 戻り値/エラー. 3: ハンドラー — 別の出力 — ログ123テストイベントハンドラー戻り値/エラーログ入力から処理へ進み、戻り値とログを別々に読む1: テストイベント — 入力を渡す — ハンドラー. 2: ハンドラー — 処理の結果 — 戻り値/エラー. 3: ハンドラー — 別の出力 — ログ123テストイベントハンドラー戻り値/エラーログ
  1. テストイベント → ハンドラー入力を渡す
  2. ハンドラー → 戻り値/エラー処理の結果
  3. ハンドラー → ログ別の出力
テストイベント
JSONで渡す入力。今回はlength=6、width=7。
ハンドラー
決めた入力条件を確かめ、6×7を計算する。
戻り値/エラー
呼出し側が、期待したarea=42と照合する。
ログ
処理の記録。戻り値そのものとは別。

JSONと、関数が要求する入力を分ける

この例の仕様は、lengthとwidthが両方とも0〜100の数値なら、その積をareaとして返すことです。lengthは長さ、widthは幅、areaは面積を表す、この例で決めた項目名です。関数ごとに必要な項目や意味は違います。

固定area関数へ渡す入力JSON
{
  "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ステータスと混同しません。

学習用の記録例:AWSのログ形式ではない
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から取得していません。

一つだけ条件を変えて、違いを説明する

  1. まずlength=6、width=7の固定例で、期待値42と戻り値を比べる。
  2. 次にwidthだけを欠かした例へ変え、JSONの構文は正しいまま、関数の入力チェックで失敗する理由を説明する。
  3. 最後に構文が壊れたJSONの例と比べ、関数の処理結果とは別の段階で止まることを確認する。

実際のコンソールで確認する場合の境界

ここまでの読解とサイト内の固定演習には、AWSアカウントは不要です。実コンソールのTestは実関数を実行します。 後で試すなら、学習用の対象、アカウントとリージョン、関数の版やエイリアス、権限、外部資源への更新や費用の影響を先に確認します。

  1. 許可された学習用の関数を選び、どの関数・版へどの入力を渡すかを確認する。
  2. Testタブで対象のイベントを選ぶか作り、架空データだけでJSONと期待結果を照合する。必要ならPrivateを選び、共有イベントへ実データを保存しない。
  3. 実行する場合はTestを選び、Execution resultのDetailsで戻り値やエラーを読む。ログは別に確認し、保存したイベントと実行結果を混同しない。

テスト後も、未確認の範囲を残す

この固定例で分かるのは、示した入力と決めた処理の関係です。実際のトリガーが呼び出すこと、AWSの権限、ネットワーク、外部サービス、実行時間や重複時の扱いを確認したことにはできません。実コンソールで一つのイベントが成功しても、連携全体の検査は別に必要です。

記録は「テスト成功」で終えず、何を渡し、何を期待し、何を見て、何をまだ見ていないかまで書きます。例:固定JSONでは42。width不足は関数エラー。AWSログ到着とS3通知からの呼出しは未確認。

結果の読み方を確かめる

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

コンソールのTestで関数へ渡すテストイベントは、どのように呼び出されますか?
答えと理由を読む

正解:同期で呼び出す · 入力・実行・観測を分けて確認します。

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

{"length":6}を固定area関数へ渡すと、width不足になりました。何を直しますか?
答えと理由を読む

正解:関数が求める入力項目 · 入力・実行・観測を分けて確認します。

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

同期Invokeが200でFunctionErrorもあります。目的の処理は成功したと判断できますか?
答えと理由を読む

正解:エラーの内容と戻り値を確認する · 入力・実行・観測を分けて確認します。

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

サイトの合成ログ例が表示されました。何を確認したことになりますか?
答えと理由を読む

正解:固定例の記録の読み方 · 入力・実行・観測を分けて確認します。

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

コンソールで架空の一件が成功しました。S3通知との連携も検収済みにできますか?
答えと理由を読む

正解:連携の動作は別に確認する · 入力・実行・観測を分けて確認します。

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

  1. 入力と関数の仕様から、期待する戻り値を決める。
  2. 呼出APIの応答、戻り値、ログを別々に読む。
  3. 一つの条件を変え、観測と未確認を記録する。
理解を確かめる: 固定areaの入力を{"length":6}に変えるとエラーになりました。何を確認し、何をまだ確認していませんか?

JSONの構文は正しいが、この関数が要求するwidthが不足しています。実AWSでの実行やログ到着、トリガー連携は未確認です。

構文、関数の入力契約、観測した結果、外部連携の検査範囲を分けて記録します。

出典と確認した条件

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