既存のLambda関数を最小限の労力で新しい統合監視エクスペリエンスにアップグレードできます。 この移行によりNew Relicの強化されたオブザーバビリティ機能を使用してLambda関数を監視できるようになります。 既存のLambda関数を一括でアップグレードすることも、一度に 1 つずつアップグレードすることもできます。 アップグレード プロセスは非侵入的であり、既存の機能のコード変更は必要ありません。
前提条件
- あなたのLambda関数はすでにNew Relicでインストゥルメントされています。
- Lambda関数は、
python、nodejs、ruby、go、または.NETランタイムで実行されています。 これらのランタイムのサポートされているバージョンの一覧を表示するには、 互換性と要件のドキュメントを参照してください。
インストゥルメンテーション方法
次のいずれかの方法を使用して、既存のLambda関数をアップグレードできます。
ヒント
New Relic 、 AWSインテグレーションを使用してAWSアカウントをNew Relicに統合し、 Lambda関数を自動的に検出して監視することをお勧めします。 これにより、サーバーレス機能に New Relic APM の全機能を活用できるようになります。
New Relic UI
New Relic UIを使用して既存のLambda関数をアップグレードできます。
既存のLambda関数をNew Relicプラットフォームからアップグレードするには、次の手順に従います。
- one.newrelic.com > All capabilities > Serverless Functionsに移動し、 Lambda関数 エンティティを選択します。
- Summary [概要]ページで、 Instrument for APM [APMの計装]をクリックします。
- APM用のLambda関数] ページで、 APIキーを入力し、 Continue [続行]をクリックします。
- デフォルトでは、現在の Lambda エンティティがアップグレード対象として選択されます。他のLambda関数を選択してアップグレードすることもできます。 Generate New Relic CLI command [New Relic CLI コマンドの生成を]クリックします。
- コマンドをコピーして、ターミナルまたは AWS ターミナルで実行します。このコマンドは、選択した関数に New Relic Lambda レイヤーをインストールします。
- Continue [続行]をクリックしてインストレーションをテストします。 このテストでは、New Relic Lambda レイヤーが正しくインストールされているかどうか、および関数が New Relic にデータを送信しているかどうかを確認します。
- テストが成功すると、成功メッセージが表示されます。New Relic APMインターフェースでLambda関数を表示するには、 See your data in APM [APMでデータを表示]をクリックします。
CLIを使用して更新する
既存のLambdaアラートとダッシュボードを更新する
既存のLambda関数をAPM + Serverless Convergenceにアップグレードした後、アラート条件とダッシュボード ウィジェットでNRQL付与を更新することが重要です。 この新しいアップグレードにより、 Lambdaデータのメトリクス パスが変更されます。 アラートとダッシュボードがこれらの新しいパスを使用し、正確な監視と通知を継続的に提供できるようにするには、クエリを変更する必要があります。これは、 APM + Serverless Convergenceに移行した既存のLambda関数に必要です。
アラートについては、既存の Lambda アラート条件を確認してください。レイヤーから取得したメトリクスを使用するNRQL書き込みを新しいメトリクスで更新します。 アラート条件の更新方法の詳細については、 「集計の更新」を参照してください。
ダッシュボードについては、既存のLambdaダッシュボード ウィジェットを確認してください。 レイヤーから取得したメトリクスを使用するNRQL書き込みを新しいメトリクスで更新します。 ダッシュボード ウィジェットを更新する方法の詳細については、 「ダッシュボードの管理」を参照してください。
データを見つけて使用する
AWS Lambda 関数をセットアップしたら、 New Relic APMインターフェースでデータを検索して使用できるようになります。 データはいくつかの主要な領域に編成されており、それぞれがLambda関数のパフォーマンスと状態に異なるインサイトを提供します。
APMインターフェイスでは、ディストリビューティッド（分散）トレーシング、サービス マップ、トランザクション、エラー分析など、 Lambda関数のさまざまな側面を探索できます。 これらの各エリアでは、 Lambda関数のパフォーマンス、レイテンシ、エラー率に関する詳細なインサイトが提供され、問題を迅速に特定して解決できるようになります。
ヒント
呼び出しエクスペリエンスは、 APM対話トレースと統合されました。 これにより、特定のAWS RequestIdを使用してAPMマッカーサー トレースにドリルダウンし、特定のLambda実行に関する詳細情報を得ることができます。
New Relic APMインターフェースでLambda関数を表示するには:
- https://one.newrelic.com > APM & Servicesに移動します。
- 検索条件を
isLambdaFunction = trueに設定します。 - 表示されたリストから、 Lambda関数を選択してデータを表示します。
ヒント
New Relic APM UIは、 APM + Serverless Convergenceアップグレード前にインストルメントされたLambda関数の履歴データが表示されません。 履歴データを表示するには、 APM Summaryページでsee serverless functions [サーバーレス機能を参照]オプションをクリックします。
ロールバック
Lambda関数を以前のサーバーレス監視エクスペリエンスに戻す必要がある場合は、 NEW_RELIC_APM_LAMBDA_MODE環境変数をfalseに設定することで実行できます。