.NET OpenTracing から AWS Lambda レイヤーへの移行ガイド

このガイドでは、 NewRelic.OpenTracing.AmazonLambda.Tracerと .NET エージェント Lambda レイヤー間の主な変更点について説明します。 また、アップグレード時に使用できるさまざまなオプションと、.NET エージェント Lambda レイヤーを使用して正常に移行する方法についても詳しく説明します。

この移行による主な変更点は次のとおりです。

• NewRelic.OpenTracing.AmazonLambda.Tracerパッケージはエージェントインストゥルメンテーションと競合しているため、削除する必要があります。
• OpenTracing のAWS Lambda 関数に加えられたコード変更はすべて元に戻す必要があります。
• New Relic .NET エージェントはAWS Lambda 関数を実装するために使用されます。
• AWS Lambda レイヤーは、.NET エージェントと必要な New Relic Lambda 拡張機能をバンドルすると利用できます。
• ほとんどの場合、 AWS Lambda 関数のインストゥルメンテーションは自動で行われます。
• .NET エージェントは、New Relic LambdaAWS 関数でデータを送信するために Lambda 拡張機能に依存します。
• レイヤーは、 New Relic Lambda CLI ツール、サーバーレス フレームワーク プラグイン、または手動で構成できます。
• 関数の実行方法が根本的に変更されたため、メトリクスの名前とタイミングが異なります。
• 古いメトリックに基づくダッシュボード、アラート、クエリは、移行後に更新する必要があります。

NewRelic.OpenTracing.AmazonLambda.トレーサーとOpenTracingの削除

.NET エージェントを使用する前に NewRelic.OpenTracing.AmazonLambda.Tracer パッケージを削除し、それをサポートするためにAWS Lambda 関数に加えた変更をすべて元に戻す必要があります。

1. NewRelic.OpenTracing.AmazonLambda.Tracerパッケージを設定するには、元のFunctionHandlerを呼び出す新しいFunctionHandlerを作成し、それをラップしてインストゥルメンテーションを有効にする必要があります。 NewRelic.OpenTracing.AmazonLambda.Tracerを削除する前に、クリーンアップをよりスムーズに行うためにその呼び出しを元に戻す必要があります。
2. .NET エージェントは、OpenTracing API を使用してカスタム データを渡すことをサポートしていません。 OpenTracing APIに直接依存するコードへの変更、または NewRelic.OpenTracing.AmazonLambda.Tracer パッケージ経由の変更は、.NET エージェント API を使用するために削除または移行する必要があります。
3. プロジェクトからNewRelic.OpenTracing.AmazonLambda.Tracerパッケージを削除します。 削除に関連して残っている問題をクリーンアップします。

レイヤー配置方法の選択

NewRelic.OpenTracing.AmazonLambda.Tracerパッケージを削除した後、次の手順では、.NET AWS Lambda レイヤーをインストールして構成するために使用する方法を選択します。 上で述べたように、主に 3 つのオプションがあります。

• New Relic Lambda CLI
• New Relic Serverless フレームワーク プラグイン
• 完全に手動でインストール

設定の大部分を自動化するため、Lambda CLI または Serverless Framework プラグインのいずれかを選択することをお勧めします。 それぞれに考慮すべき依存関係と要件があり、そのいくつかは次のセクションで概説します。 これらのアプローチのいずれかをすでに使用している場合は、すべてのAWS Lambda 関数に同じアプローチを使用して、シンプルさを保つことをお勧めします。

AWS Lambda監視の詳細な開始手順については、 有効化ガイドをご覧ください。

New Relic Lambda CLI

Lambda CLI クイックスタートには、 .NET エージェント レイヤーを使用するようにAWS Lambda 関数を更新するコマンドの例があります。 これにより、関数の実行時間が自動的に検出され、適切なレイヤーが選択されます。 追加のセットアップ オプションについては、Lambda CLI リポジトリを参照してください。

New Relic Serverless フレームワーク プラグイン

Serverless Framework プラグイン クイックスタートには、プラグインをインストールし、Serverless Framework 設定を更新するために必要な手順が記載されています。 追加のセットアップオプションについては、 Serverless framework プラグイン リポジトリ をご覧ください。

完全に手動でインストール

AWS Lambda 関数を手動でインストゥルメントすることはお勧めしませんが、そのために必要な手順についてはここに情報があります。

• .NETエージェントは、手動でインストールした場合、ほとんどの場合、 AWS Lambda関数を自動的に計算します。
• データの送信にはNew Relic Lambda Extensionが依然として必要