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

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

LEARNINGEN

演習テーマ:LambdaとAPI Gateway:入力・テスト・失敗調査

Lambdaテストイベント演習:入力・戻り値・ログとタイムアウトを読み分ける

呼出しを受け付けたことと、関数が目的の処理を終えたことは別です。 この演習では固定条件を変え、同期200+関数エラー、タイムアウト、非同期202+結果未確認を見比べます。実AWSや利用者のコードを実行しません。

この教材で学ぶこと

入力JSON、呼出し側への応答、関数の戻り値とログを分け、設定変更後の結果と未確認を自分の言葉で説明できる。

先に知っておくこと

Lambdaのイベントとハンドラーの役割。AWSアカウントや実ログは不要です。関数の作成・呼出し・設定変更は行いません。

演習を始める →

この演習で変える条件と、変えない仮定

最初の例は、同期で呼び出せたが、固定関数がエラーを返した場面です。「呼出APIの応答」と「関数の結果」を隣で見比べます。どちらも実通信の記録ではなく、用意した条件に対する演習内の例です。

FIXED EVENT / LOCAL MODEL

条件を変えて、結果の段階を読み分ける

すべて固定の学習用データです。実AWSの実行・実ログの取得・入力の保存や送信はありません。処理時間は架空の値です。

1. 条件を選ぶ

入力JSONと、演習が扱う形態を確認する

選択中のJSON入力(固定例)

{}
結果へ ↓

下は初期固定例の結果です。操作にはJavaScriptが必要です。

2. 結果の段階を確認する

条件1 / 判定1

固定関数でエラーになります

呼出APIの応答例

200:同期の呼出しを仮定

関数の結果

固定関数のエラー

固定fail関数がエラーを返す条件です。呼出APIの200とは別に読んでください。

戻り値・エラーの例
{
  "errorType": "SyntheticExampleError"
}
ログ例(合成)
MODEL_FIXED_HANDLER_THROW · 1s
非同期の再試行計画

この条件では非同期の再試行計画を表示しません。

    判定の範囲と根拠を確認
    モデル
    lambda-fixed-1
    理由コード
    L22_FUNCTION_ERROR
    確認していないこと
    実際の許可・実行時間・呼出回数・ログの到着・ネットワーク・メモリ性能

    出典と確認した条件へ →

    入力・戻り値・ログを分ける

    一つのイベントでも、戻り値とログは別の出力
    一つのイベントでも、戻り値とログは別の出力1: テストイベント — JSON入力 — 固定ハンドラー. 2: 固定ハンドラー — 戻り値/エラー — 関数の戻り値. 3: 固定ハンドラー — 合成ログ — ログ例123テストイベント固定ハンドラー関数の戻り値ログ例一つのイベントでも、戻り値とログは別の出力1: テストイベント — JSON入力 — 固定ハンドラー. 2: 固定ハンドラー — 戻り値/エラー — 関数の戻り値. 3: 固定ハンドラー — 合成ログ — ログ例123テストイベント固定ハンドラー関数の戻り値ログ例
    1. テストイベント → 固定ハンドラーJSON入力
    2. 固定ハンドラー → 関数の戻り値戻り値/エラー
    3. 固定ハンドラー → ログ例合成ログ
    テストイベント
    固定の入力JSONを選ぶ。
    固定ハンドラー
    定めた処理だけをモデル化する。
    関数の戻り値
    呼出し側への結果またはエラー。
    ログ例
    戻り値とは別の合成記録。
    固定area関数に渡す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秒上限を、別の実行方式へ勝手に適用しません。処理時間が不明な場合も、速かった/遅かったという結果を作り足しません。

    結果の意味を確かめる

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

    同期の呼出APIが200で、関数の結果がエラーでした。どう読みますか?
    答えと理由を読む

    正解:呼出しと関数の処理結果を分ける · 条件と、どの段階の結果なのかを分けて確認します。

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

    非同期の202を見ただけで、何を言えますか?
    答えと理由を読む

    正解:受付の段階であり、実行結果は別 · 条件と、どの段階の結果なのかを分けて確認します。

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

    非同期の関数エラーへの再試行を0回にすると、重複処理は絶対になくなりますか?
    答えと理由を読む

    正解:保証しない · 条件と、どの段階の結果なのかを分けて確認します。

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

    期限5秒で、処理時間が不明です。何を記録しますか?
    答えと理由を読む

    正解:期限との比較は未確認 · 条件と、どの段階の結果なのかを分けて確認します。

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

    {"length": 6}をarea関数へ渡しました。widthがないことをどう扱いますか?
    答えと理由を読む

    正解:この固定関数の入力チェックでエラー · 条件と、どの段階の結果なのかを分けて確認します。

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

    Managed Instancesの条件を選びました。通常関数の900秒上限で判定してよい?
    答えと理由を読む

    正解:この演習では未対応として残す · 条件と、どの段階の結果なのかを分けて確認します。

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

    1. 初期例の200と関数エラーを別々に読む。
    2. slowの期限3秒を10秒に変え、再評価する。
    3. 非同期と再試行0/2を比べ、未確認を説明する。
    理解を確かめる: 非同期で202が返り、再試行は0回です。関数の成功と一度だけの処理を保証できますか?

    保証できない。受付、関数の実行結果、重複の可能性を分けて確認する。

    202は完了の証拠ではなく、再試行設定だけで重複配送を排除できるわけでもありません。

    出典と確認した条件

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