サーバーレスパッケージが大きすぎるエラーのトラブルシューティング

このガイドは、“Code uncompressed size is greater than max allowed size of 272629760 “というエラーのトラブルシューティングを支援します。このエラーは、Datadog サーバーレスプラグインを使用して Node.js サーバーレスアプリケーションをインスツルメントするときに最も一般的に表示されます。また、他の言語やデプロイメント方法でこのエラーが発生した場合にも、このトラブルシューティングの方法が適用される場合があります。

このエラーは、関数の_圧縮されていない_コードサイズが 250MB の制限を超えていることを示しています。関数パッケージ (関数のコードと依存関係を含む .zip アーティファクト) と関数に設定された Lambda レイヤーの両方が、この制限にカウントされます。両方を調べて、根本的な原因を探ってください。

レイヤー

通常、Datadog はインスツルメンテーションのために 2 つの Lambda レイヤーを追加します。

  • 関数コードをインスツルメントする言語固有のライブラリと
  • 観測データを集計し、バッファリングし、Datadog のバックエンドに転送する拡張機能。

AWS CLI コマンド aws lambda get-layer-version を使用して Datadog Lambda レイヤーの内容とサイズを確認します。例えば、以下のコマンドを実行すると、_Datadog-Node20-x バージョン 113 と _Datadog-Extension バージョン 62 の Lambda レイヤーをダウンロードするリンクが得られ、圧縮されていないサイズ (合わせて約 30MB) を確認することができます。解凍サイズはレイヤーやバージョンによって異なります。以下の例のレイヤー名とバージョン番号は、アプリケーションで使用されているものに置き換えてください。

aws lambda get-layer-version \
  --layer-name arn:aws:lambda:us-east-1:464622532012:layer:Datadog-Node20-x \
  --version-number 113

aws lambda get-layer-version \
  --layer-name arn:aws:lambda:us-east-1:464622532012:layer:Datadog-Extension \
  --version-number 62

Datadog の Lambda レイヤー以外にも、関数に追加された (または追加される) Lambda レイヤーも検査します。Serverless Framework を利用している場合、CloudFormation のテンプレートは deploy または package コマンドを実行した後の隠しフォルダ .serverless から、Lambda レイヤー一覧は Layers セクションから確認することが可能です。

パッケージ

関数デプロイメントパッケージには、不要な大きなファイルやコードが含まれていることがあります。Serverless Framework を使用している場合、deploy または package コマンドを実行した後に、隠しフォルダである .serverless に生成されたデプロイメントパッケージ (.zip ファイル) を見つけることができます。

デプロイメントパッケージとレイヤーのサイズの合計が制限を超えていない場合は、AWS サポートに連絡して調査を依頼してください。合計サイズが制限を超える場合は、デプロイメントパッケージを検査し、実行時に不要な大きなファイルをパッケージオプションを使用して除外してください。

依存関係

Datadog Lambda レイヤーはインスツルメンテーションライブラリをパッケージ化し、Lambda 実行環境で使用できるようにするので、 datadog-lambda-js と dd-trace を package.json で依存関係に指定する必要は ありません。もし、ローカルのビルドやテストに Datadog のライブラリが必要な場合は、devDependencies として指定し、デプロイメントパッケージから除外するようにします。同様に、serverless-plugin-datadog は開発時にのみ必要であり、 devDependencies の下に指定するべきです。

また、デプロイメントパッケージに含まれる他の依存関係 (node_modules フォルダ) を検査し、必要なものだけを dependencies に保存してください。

バンドラー

Webpack や esbuild のようなバンドラーを使用すると、使われているコードのみを含めることができ、デプロイメントパッケージのサイズを劇的に削減することができます。必要な Webpack の構成は Node.js の Lambda Tracing とバンドラーの互換性を参照してください。

Datadog-ci

ユースケースによっては、パッケージサイズの問題を回避するために datadog-ci lambda instrument コマンドを使用する方が簡単だと感じるかもしれません。datadog-ci lambda instrument コマンドは、serverless-plugin-datadog と同じインスツルメンテーションを構成します。詳しくは、datadog-ci リポジトリを参照してください。

サポート

Datadog のサポートチームによる調査が必要な場合は、チケットに以下の情報を含めてください。

  1. この関数の構成された Lambda レイヤー (名前とバージョン、または ARN)。
  2. AWS にアップロードする関数のデプロイメントパッケージ (または解凍したパッケージの内容とサイズがわかるスクリーンショット)。
  3. プロジェクトのコンフィギュレーションファイル (編集されたシークレットを含む): serverless.yaml、package.json、package-lock.json、yarn.lock、 tsconfig.json および webpack.config.json。

その他の参考資料

お役に立つドキュメント、リンクや記事:

Node.js アプリケーションのインスツルメンテーションドキュメント more more