Lambda マネージドインスタンスのトラブルシューティング

スロットリングとスケーリングの問題

スケールアップ中のエラー率が高い

問題: トラフィックが急速に増加すると、スロットリングエラー (HTTP 429) が発生する。

原因: Lambda マネージドインスタンスは、CPU リソース使用率と同時実行数の飽和度に基づいて非同期的にスケーリングされます。トラフィックが 5 分以内に 2 倍を超えると、Lambda が需要に合わせてインスタンスと実行環境をスケールアップするため、スロットリングが表示されることがあります。

解決策:

スケールダウンが遅い

問題: トラフィックが減少した後、インスタンスのスケールダウンに時間がかかる。

原因: Lambda マネージドインスタンスは、可用性を維持し、パフォーマンスに影響を与える可能性のある急速な容量変更を回避するために、徐々にスケールダウンします。

解決策:

これは想定される動作です。Lambda は、安定性を確保するためにインスタンスを控えめにスケールダウンします。CloudWatch メトリクスをモニタリングして、実行中のインスタンスの数を追跡します。

同時実行の問題

同時実行が低い実行環境でスロットリングが発生する

問題: 使用可能な容量があるにもかかわらず、関数にスロットリングが発生する。

原因: 最大同時実行数が非常に低い実行環境では、効果的なスケーリングが困難な場合があります。Lambda マネージドインスタンスは、複数同時実行アプリケーション用に設計されています。

解決策:

スレッドの安全性の問題 (Java ランタイム)

問題: 負荷がかかると、Java 関数が誤った結果を生成したり、競合状態が発生したりする。

原因: 複数のスレッドがハンドラーメソッドを同時に実行し、共有状態はスレッドセーフではありません。

解決策:

詳細なガイダンスについては、「Lambda マネージドインスタンスの Java ランタイム」ドキュメントを参照してください。

状態分離の問題 (Node.js ランタイム)

問題: Node.js 関数がさまざまなリクエストからのデータを返すか、データ破損が発生する。

原因: グローバル変数が、同じワーカースレッド上の同時呼び出し間で共有されています。非同期オペレーションが制御する場合、他の呼び出しは共有状態を変更できます。

解決策:

詳細なガイダンスについては、「Lambda マネージドインスタンスの Node.js ランタイム」ドキュメントを参照してください。

ファイル競合 (Python ランタイム)

問題: Python 関数が /tmp のファイルから誤ったデータを読み取る。

原因: 複数のプロセスが /tmp ディレクトリを共有しています。同じファイルに同時に書き込むと、データが破損する可能性があります。

解決策:

詳細なガイダンスについては、「Lambda マネージドインスタンスの Python ランタイム」ドキュメントを参照してください。

パフォーマンスの問題

メモリ使用率が高い

問題: 関数でメモリ使用率が高いかメモリー不足のエラーが発生する。

原因: Python の同時リクエストは、それぞれ独自のメモリ容量を持つ個別のプロセスで実行されています。合計メモリ使用量は、プロセスあたりのメモリに同時処理を乗じたものと等しくなります。

解決策:

パフォーマンスの不整合

問題: 関数のパフォーマンスが呼び出し間で大きく異なる。

原因: Lambda が可用性に基づいて異なるインスタンスタイプを選択しているか、リソースの可用性が異なるインスタンスで関数が実行されている可能性があります。

解決策:

キャパシティープロバイダーの問題

関数バージョンが ACTIVE にならない

問題: 関数のバージョンが公開後も保留状態のままです。

原因: Lambda がマネージドインスタンスを起動し、実行環境を開始しています。このプロセスは時間がかかります。特に新しいキャパシティープロバイダーの最初の関数バージョンの場合はなおさらです。

解決策:

Lambda が初期化プロセスを完了するまで待ちます。Lambda は、AZ の回復性のためにデフォルトで 3 つのインスタンスを起動し、実行環境を 3 つ開始すると、関数バージョンが ACTIVE にマークされます。これには通常数分かかります。

キャパシティープロバイダーを削除できない

問題: キャパシティープロバイダーを削除しようとするとエラーが発生する。

原因: 関数バージョンがアタッチされているキャパシティープロバイダーは削除できません。

解決策:

関数の公開中の一般的なエラーメッセージ

問題: 関数の公開時に「公開中に内部エラーが発生しました」などの一般的なエラーメッセージが表示される。

解決策:

モニタリングとオブザーバビリティの問題

CloudWatch メトリクスがない

問題: キャパシティープロバイダーまたは関数について、予想されるメトリクスが CloudWatch に表示されない。

原因: メトリクスは 5 分間隔で発行されます。新しいキャパシティープロバイダーまたは関数では、メトリクスがすぐに利用できない場合があります。

解決策:

メトリクスが CloudWatch に表示されるまで、関数バージョンを公開してから少なくとも 5～10 分待ちます。正しい名前空間 (AWS/Lambda) とディメンション (CapacityProviderName、FunctionName、または InstanceType) を表示していることを確認します。

CloudWatch ログが見つからない

問題: 関数は正常に実行されますが、CloudWatch Logs でログを見つけることができない。

原因: Lambda マネージドインスタンスは VPC で実行され、CloudWatch Logs にログを送信するためにネットワーク接続が必要です。適切な VPC 接続設定がないと、関数は CloudWatch Logs サービスエンドポイントに到達できません。

解決策:

関数が CloudWatch Logs にログを送信できるように VPC 接続を設定します。次の 3 つの選択肢があります。

オプション 1: CloudWatch Logs の VPC エンドポイント (本番環境に推奨)

オプション 2: インターネットゲートウェイを備えたパブリックサブネット

キャパシティープロバイダーがパブリックサブネットを使用している場合は、以下を確認してください。

オプション 3: NAT ゲートウェイを使用するプライベートサブネット

キャパシティープロバイダーがプライベートサブネットを使用している場合は、以下を確認してください。

VPC 接続オプションの詳細については、「VPC connectivity for Lambda Managed Instances」を参照してください。

同時リクエストからのログの相関付けが困難

問題: さまざまなリクエストからのログがインターリーブされるため、個々のリクエストを追跡するのが困難である。

原因: ログインターリーブは、複数同時実行システムで想定される標準的な動作です。

解決策:

詳細なガイダンスについては、ランタイム固有のドキュメントページを参照してください。

追加のヘルプの取得

これらのソリューションを試した後も問題が続く場合:

次のステップ