New Relic の .NETエージェント は、APMで報告および表示されるアプリケーション名を変更する方法をいくつか提供します。このドキュメントでは、これらの命名オプションの概要について説明します。
(.NETに固有ではない)APM アプリの命名の一般的な概要については、アプリケーションに名前を付ける を参照してください。データの連続性を損なうことなくアプリケーションの名前を変更するには、UI エイリアス変更オプション を使用します。
アプリ名を設定する(推奨方法) 最初にアプリをデプロイする際には、デフォルトの名前を分かりやすい名前に変更します。New Relic は、これらの名前を使用してメトリックスを集計します。これにより、同じアプリケーションを複数のホストで実行して、すべてのインスタンスからのメトリックスを取得することができます。
通常、アプリローカルのnewrelic.config
ファイルを設定するのが最も便利な命名方法です。
命名方法
説明
推奨 :
アプリローカルnewrelic.config
ファイルの設定
このメソッドを使用すると、特定の構成設定でアプリに一意の名前を付けることができます。また、IIS と IIS 以外でホストされるアプリの両方で機能します。
必要に応じて、エージェントのホームディレクトリからアプリケーションのルートフォルダーにnewrelic.config
ファイルをコピーします。
デフォルト: %ALLUSERSPROFILE%\New Relic\.NET Agent
コピーを開き、次のようにアプリ名を設定します。
アプリケーションを再起動します。
アプリケーションがアクティブであれば、数分以内にデータが表示されます。表示されない場合は、トラブルシューティングの手順 に従ってください。
その他のメソッド 特定の用途または目的を念頭に置いている場合は、別の命名方法を使用することをお勧めします。代替メソッドの完全なリストは次のとおりです。
重要 一部のメソッドは他のメソッドよりも優先 されます。命名方法を選択する前に、設定がどのように影響を受けるかを理解してください。
命名方法
説明
web.config
ファイルの設定
IISでホストされるアプリがあり、ローカルのnewrelic.config
ファイルを使用したくない場合は、web.config
ファイルで命名方法を設定できます。
手順 .NETフレームワークアプリの場合:
ファイルのappSettings
セクションに次のエントリを追加して、アプリケーションを再起動します。
< add key = " NewRelic.AppName " value = " App Name " />
.NET Coreアプリの場合:
次のようにNEW_RELIC_APP_NAME
環境変数をファイルに追加してから、アプリケーションを再起動します。
< aspNetCore processPath = " dotnet " arguments = " .\MyApp.dll " stdoutLogEnabled = " false " stdoutLogFile = " .\logs\stdout " hostingModel = " InProcess " >
< environmentVariable name = " NEW_RELIC_APP_NAME " value = " App Name " />
環境変数を使用してアプリ名を設定する
コンテナのディプロイ中にアプリ名を簡単に設定したい場合は、アプリケーションの環境で環境変数を設定します。
手順 アプリケーションの環境で環境変数NEW_RELIC_APP_NAME
を設定します。
NEW_RELIC_APP_NAME = " App name "
アプリケーションプールに基づいて名前を付ける
IIS アプリケーション プールに既に一意の名前を付けている場合、またはSNCI (Shared Network Content Infrastructure) を使用している場合は、割り当てられたアプリ プールにちなんでアプリに名前を付けることができます。
手順 web.config.
の<appSettings>
セクションからNewRelic.AppName
キーをすべて削除します。周囲の<appSettings>
タグを削除しないように注意してください。
newrelic.config
の<application>
親要素から、あらゆる<name>
子要素を削除します。周囲の <application>
タグは削除しないでください。
その後は、各アプリケーションはそれぞれのアプリケーションプール名に従ってレポートします。
app.config
ファイルの設定
IISでホストされるアプリケーションがあり、ローカルのnewrelic.config
ファイルを使用したくない場合は、app.config
ファイルで命名方法を設定できます。
手順 app.config
ファイル(例:applicationname.exe.config
)に次のエントリを追加して、アプリケーションを再起動します。
< add key = " NewRelic.AppName " value = " App Name " />
.NETエージェントAPIの使用
プログラムでアプリの名前を変更する場合は、SetApplicationName()
エージェントAPI呼び出し を使用して、ランタイムにアプリ名を設定できます。この名前は、他のすべてのアプリケーションの命名ソースより優先されます。
アプリケーションがアクティブであれば、数分以内にデータが表示されます。そうでない場合は、.NETアプリケーションの設定ファイル (newrelic.config
またはapp.config
)を変更した場合は、常に管理コマンドプロンプトからIISRESET
を実行してください。それ以外の場合は、トラブルシューティング手順 に従ってください。
複数のアプリ名を使用する 複数のアプリ名を使用して、アプリケーションからデータを集計できます。この操作をデータの「ロールアップ」と呼ぶことがあります。
.NETエージェントの場合、最大3つのアプリケーション名を設定できます。最初の名前はプライマリアプリケーション名であり、2番目と3番目の名前は、より一般的なデータ集計カテゴリに使用されます。複数のアプリ名の仕組みの詳細については、「複数のアプリ名を使用する 」をご覧ください。
newrelic.config
ファイルアプリローカルnewrelic.config
ファイルに複数の名前を設定する例を次に示します。
< name > Primary App Name </ name >
< name > Second App Name </ name >
< name > Third App Name </ name >
web.config
ファイルweb.config
ファイルに複数の名前を設定する例を次に示します。
< add key = " NewRelic.AppName " value = " App Name, App Name 2, App Name 3 " />
app.config
ファイルapp.config
ファイルに複数の名前を設定する例を次に示します。
< add key = " NewRelic.AppName " value = " App Name, App Name 2, App Name 3 " />
NEW_RELIC_APP_NAME
環境変数NEW_RELIC_APP_NAME
環境変数に複数の名前を設定する例を次に示します。
NEW_RELIC_APP_NAME="App Name, App Name 2, App Name 3"