翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS Lambda での Node.js コードの作成
Lambda アプリケーションのトレース、デバッグ、最適化を行うために、Lambda は AWS X-Ray と統合されています。X-Ray を使用すると、Lambda 関数や他の AWS のサービスが含まれるアプリケーション内で、リソースを横断するリクエストをトレースできます。
トレースされたデータを X-Ray に送信するには、以下の 2 つの SDK ライブラリのいずれかを使用します。
-
AWS Distro for OpenTelemetry (ADOT)
– OpenTelemetry (OTel ) SDK の、安全で本番環境に対応した AWSがサポートするディストリビューション。 -
AWS X-Ray SDK for Node.js - トレースデータを生成して X-Ray に送信するための SDK です。
各 SDK は、テレメトリデータを X-Ray サービスに送信する方法を提供します。続いて、X-Ray を使用してアプリケーションのパフォーマンスメトリクスの表示やフィルタリングを行い、インサイトを取得することで、問題点や最適化の機会を特定できます。
重要
X-Ray および Powertools for AWS Lambda SDK は、AWS が提供する、密接に統合された計測ソリューションの一部です。ADOT Lambda レイヤーは、一般的により多くのデータを収集するトレーシング計測の業界標準の一部ですが、すべてのユースケースに適しているわけではありません。どちらのソリューションを使用しても、X-Ray で end-to-end トレースを実装できます。選択方法の詳細については、「Choosing between the AWS Distro for Open Telemetry and X-Ray SDKs」( Distro for Open Telemetry または X-Ray SDK の選択) を参照してください。
セクション
Node.js 関数の計測での ADOT の使用
ADOT はフルマネージド型の Lambda レイヤーを提供します。これにより、OTel SDK を使用してテレメトリデータを収集するために必要なすべてがパッケージ化されます。このレイヤーを使用すると、関数コードを変更する必要はなしで、Lambda 関数を計測できます。また、このレイヤーは、OTel でのカスタムな初期化を実行するように構成することもできます。詳細については、ADOT のドキュメントにある「Lambda 上での ADOT Collector のカスタム設定
Node.js ランタイムの場合は、ADOT Javascript 向け AWS マネージド Lambda レイヤー を追加して、関数を自動的に計測できます。このレイヤーを追加する方法の詳細については、ADOT ドキュメントの「 用 AWS Distro for OpenTelemetry Lambda Support JavaScript
X-Ray SDK を使用した Node.js 関数の計測
Lambda 関数がアプリケーション内の他のリソースに対して行う呼び出しの詳細を記録するために、AWS X-Ray SDK for Node.js を使用することもできます。SDK を取得するには、アプリケーションの依存関係に aws-xray-sdk-core
パッケージを追加します。
例 blank-nodejs/package.json
{ "name": "blank-nodejs", "version": "1.0.0", "private": true, "devDependencies": { "aws-sdk": "2.631.0", "jest": "25.4.0" }, "dependencies": {
"aws-xray-sdk-core": "1.1.2"
}, "scripts": { "test": "jest" } }
AWS SDK クライアントを実装するには、aws-sdk
メソッドで captureAWS
ライブラリをラップします。
例 blank-nodejs/function/index.js - AWS SDK クライアントのトレース
const AWSXRay = require('aws-xray-sdk-core') const AWS = AWSXRay.captureAWS(require('aws-sdk'))
// Create client outside of handler to reuse const lambda = new AWS.Lambda() // Handler exports.handler = async function(event, context) { event.Records.forEach(record => { ...
Lambda ランタイムは、 X-Ray SDK を設定するための環境変数をいくつか設定します。例えば、Lambda は、X-Ray SDK からランタイムエラーがスローされないように、LOG_ERROR
に AWS_XRAY_CONTEXT_MISSING
をセットします。カスタムのコンテキストミッシング戦略を設定するには、関数設定の環境変数をオーバーライドして値を持たせないようにします。その後、コンテキストミッシング戦略をプログラムで設定できます。
例 初期化コードの例
const AWSXRay = require('aws-xray-sdk-core'); // Configure the context missing strategy to do nothing AWSXRay.setContextMissingStrategy(() => {});
詳細については、「Lambda 環境変数の使用」を参照してください。
正しい依存関係を追加し、必要なコード変更を行った後で、Lambda コンソールまたはAPIを介して、関数の設定でトレースをアクティブにします。
Lambda コンソールを使用してトレースを有効化する
コンソールを使用して、Lambda 関数のアクティブトレースをオンにするには、次のステップに従います。
アクティブトレースをオンにするには
Lambda コンソールの [関数ページ]
を開きます。 -
関数を選択します。
[設定] を選択してから、[モニタリングおよび運用ツール] を選択します。
[編集] を選択します。
-
[X-Ray] で、[アクティブトレース] をオンに切り替えます。
-
[保存] をクリックします。
Lambda API でのトレースのアクティブ化
AWS CLI または AWS SDK で Lambda 関数のトレースを設定するには、次の API オペレーションを使用します。
以下の例の AWS CLI コマンドは、my-function という名前の関数に対するアクティブトレースを有効にします。
aws lambda update-function-configuration --function-name my-function \ --tracing-config Mode=Active
トレースモードは、関数のバージョンを公開するときのバージョン固有の設定の一部です。公開後のバージョンのトレースモードを変更することはできません。
AWS CloudFormation によるトレースのアクティブ化
AWS CloudFormation テンプレート内で AWS::Lambda::Function
リソースに対するアクティブトレースを有効化するには、TracingConfig
プロパティを使用します。
例 function-inline.yml - トレース設定
Resources: function: Type: AWS::Lambda::Function Properties:
TracingConfig: Mode: Active
...
AWS Serverless Application Model (AWS SAM) AWS::Serverless::Function
リソースに、Tracing
プロパティを使用します。
例 template.yml - トレース設定
Resources: function: Type: AWS::Serverless::Function Properties:
Tracing: Active
...
X-Ray トレースの解釈
関数には、トレースデータを X-Ray にアップロードするためのアクセス許可が必要です。Lambda コンソールでトレースを有効にすると、Lambda は必要な権限を関数の [実行ロール] に追加します。それ以外の場合は、AWSXRayDaemonWriteAccess
アクティブトレースの設定後は、アプリケーションを通じて特定のリクエストの観測が行えるようになります。[X-Ray サービスグラフ] には、アプリケーションとそのすべてのコンポーネントに関する情報が表示されます。次のエラープロセッサのサンプルアプリケーション例は、2 つの関数を持つアプリケーションを示しています。プライマリ関数はイベントを処理し、エラーを返す場合があります。上の 2 番目の関数は、最初のロググループに表示されるエラーを処理し、 AWS SDK を使用して X-Ray、Amazon Simple Storage Service (Amazon S3)、および Amazon CloudWatch Logs を呼び出します。
X-Ray は、アプリケーションへのすべてのリクエストをトレースするわけではありません。X-Ray は、サンプリングアルゴリズムを適用することで効率的なトレースを行うと同時に、すべてのリクエストについての代表的なサンプルを示します。サンプルレートは 1 秒あたり 1 回のリクエストで、追加リクエストの 5% です。
注記
関数の X-Ray サンプルレートは設定することはできません。
アクティブトレースを使用する場合、Lambda はトレースごとに 2 つのセグメントを記録します。これにより、サービスグラフに 2 つのノードが作成されます。次のイメージは、エラープロセッサのサンプルアプリケーションからの主要機能のこれら 2 つのノードを示しています。
左に示された 1 つめのノードは、呼び出しリクエストを受信する Lambda サービスを表しています。2 つめのノードは、特定の Lambda 関数を表しています。次の例は、これら 2 つのセグメントを使用したトレースを示しています。いずれも my-function と名付けられていますが、1 つは AWS::Lambda
の起点があり、もう 1 つは AWS::Lambda::Function
の起点があります。
この例では、関数セグメントを展開して、それの 3 つのサブセグメントが表示されています。
-
初期化 - 関数のロードと初期化コードの実行に要した時間を表します。このサブセグメントは、関数の各インスタンスが処理する最初のイベントに対してのみ表示されます。
-
[呼び出し] - ハンドラーコードの実行に要した時間を表します。
-
[オーバーヘッド] - Lambda ランタイムが次のイベントを処理するための準備に要する時間を表します。
HTTP クライアントをインストルメント化し、SQL クエリを記録して、注釈とメタデータからカスタムサブセグメントを作成することもできます。詳細については、「AWS X-Ray デベロッパーガイド」の「AWS X-Ray SDK for Node.js」を参照してください。
料金
X-Ray トレースは、毎月、AWS 無料利用枠で設定された一定限度まで無料で利用できます。X-Ray の利用がこの上限を超えた場合は、トレースによる保存と取得に対する料金が発生します。詳細については、「AWS X-Ray 料金表
ランタイムの依存関係をレイヤー (X-Ray SDK) に保存する
X-Ray SDK を使用して AWS SDK クライアントを関数コードに埋め込むと、デプロイパッケージが巨大になる可能性があります。関数コードを更新するたびにランタイムの依存関係がアップロードされないようにするには、X-Ray SDK を「Lambda レイヤー」にパッケージ化します。
次に、AWS X-Ray SDK for Node.js を保存している AWS::Serverless::LayerVersion
リソースの例を示します。
例 template.yml - 依存関係レイヤー
Resources: function: Type: AWS::Serverless::Function Properties: CodeUri: function/. Tracing: Active
Layers: - !Ref libs
...libs: Type: AWS::Serverless::LayerVersion Properties: LayerName: blank-nodejs-lib Description: Dependencies for the blank sample app. ContentUri: lib/. CompatibleRuntimes: - nodejs16.x
この設定では、ランタイム依存関係を変更した場合にのみ、ライブラリレイヤーの更新が必要です。関数のデプロイパッケージにはユーザーのコードのみが含まれるため、アップロード時間を短縮できます。
依存関係のレイヤーを作成するには、デプロイ前にレイヤーアーカイブを生成するようにビルドを変更する必要があります。実際の例については、blank-nodejs