.NET アプリケーションの名前付け

New Relic はライセンスキーを基と、固有のアプリケーションIDまたは名前の組み合わせで情報を収集します。
アプリ名ごとにメトリクスを集計するため、複数のサーバーで同じアプリケーションを実行することが可能になり、すべてのインスタンスからのメトリックを統合できるようになっています。このドキュメントでは、.NET アプリケーション名前付けの方法について説明します。

: 最初にアプリをデプロイする際に、設定ファイルを編集して、デフォルトの名前を意味のある名前に変更する必要があります。メトリック集計用に、さらに2つの名前を指定することができます。

エージェント API

実行時にアプリケーション名を設定するには、エージェント APIを使用することができます。この名前は、他のすべてのアプリケーション名のソースよりも優先されます。 SetApplicationName を呼び出すと、その都度、前の呼び出しを上書きします。

エージェント API を利用して設定されたアプリケーション名は、アプリケーションの再起動すると維持されません。

IIS でホストされているアプリケーション

web.config または newrelic.configを利用して、IIS でホストされるアプリケーションに名前を付けることができます。web.configファイルを利用して名前を付けると、アプリケーション毎に一意の名前を持っている保証します。メトリックデータが不適切に複数のアプリから集計されないことを保証します。 web.config ファイルを変更したくない場合は、アプリのローカルにある newrelic.config を利用て名前を付けることができます。

web.config を利用して名前付けする

web.configを利用して名前を設定すると、アプリ毎にが一意の名前を持つことを保証します。web.config は、newrelic.config の設定を上書きします。

  1. web.config ファイルに以下のコードを追加します。

    <appSettings>
        <add key = "NewRelic.AppName" value="Unique Name" />
    </appSettings>

    複数名 (最大3つ)をアプリに設定するには、カンマ区切りで名前を記述します。最初の名前は、必ずユニークな名前でなくてはいけません。

    <appSettings>
        <add key="NewRelic.AppName" value="My First Application, My Second Application, My Third Application"/>
    </appSettings>
  2. IIS をリセットします。

アプリがトラフィックを受信すると、数分以内にデータは UI に表示されます。数分経っても表示されない場合は、データが表示されない場合のトラブルシューティングをご覧ください。

newrelic.config を利用した名前付け

web.config を編集したくない場合は、newrelic.config をアプリのローカルフォルダにコピーし、名前を変更します。コピーした newrelic.config は、グローバルファイルを上書きします。

  1. エージェントのホームディレクトから、newrelic.config をアプリのローカルフォルダにコピーします。エージェントのホームフォルダの場所は以下のように異なります。

    • デフォルト: %ALLUSERSPROFILE%\New Relic\.NET Agent
    • Windows 2003: %ALLUSERSPROFILE%\Application Data\New Relic\.NET Agent
  2. newrelic.config のコピーを開き、<name> 要素を探します。その <name> 要素に新しいアプリケーション名を指定します。

    <application>
       <name> Unique Name </name>
    </application>

    複数名 (最大3つ)をアプリに設定するには、<name> 要素にそれぞれの名前を指定します。最初の名前は、必ずユニークな名前でなくてはいけません。

    <application>
        <name>My Application</name>
        <name>Second App Name</name>
        <name>Third App Name</name>
    </application>
  3. Reset IIS.

アプリがトラフィックを受信すると、数分以内にデータは UI に表示されます。数分経っても表示されない場合は、データが表示されない場合のトラブルシューティングをご覧ください。

アプリをプールした後に名前を付ける

親のアプリケーションプールに応じてアプリに名前を付けるには、newrelic.configweb.config ファイルからの指定している名前をすべて削除します。SNCI 命名指示の手順に従って、各アプリが固有の名前を持つようにしてください。

IIS 以外のアプリの名前付け

IIS でホストされていないアプリケーションに名前を付ける方法は以下のとおりです。

  1. アプリの設定ファイルに以下のコードを追加します。(例:applicationname.exe.config)

    <appsettings>
        <add key = "NewRelic.AppName" value="Unique Name" />
    </appsettings>

    複数名 (最大3つ)をアプリに設定するには、カンマ区切りで名前を記述します。

    <appSettings>
        <add key="NewRelic.AppName" value="My First Application, My Second Application, My Third Application"/>
    </appSettings>
  2. Restart your application.

アプリがトラフィックを受信すると、数分以内にデータは UI に表示されます。数分経っても表示されない場合は、データが表示されない場合のトラブルシューティングをご覧ください。

外部ファイルを利用して名前を付ける

通常、外部ファイルでアプリの設定を行う場合、アプリ名を設定するには、以下のようにその外部ファイルを呼び出します。

  1. web.config または app.config が、外部ファイルを呼び出していることを確認する。
  2. appSettings ファイルに以下のコードを追加する。

    <appSettings>
    <add key = "NewRelic.AppName" value="Unique Name" />
    </appSettings>

    複数名 (最大3つ)をアプリに設定するには、カンマ区切りで名前を記述します。最初の名前は、必ずユニークな名前でなくてはいけません。

    <appSettings>
        <add key="NewRelic.AppName" value="My First Application, My Second Application, My Third Application"/>
    </appSettings>
  3. IIS をリセットします。

アプリがトラフィックを受信すると、数分以内にデータは UI に表示されます。数分経っても表示されない場合は、データが表示されない場合のトラブルシューティングをご覧ください。

Shared Network Content Infrastructure

Shared Network Content Infrastructure を使っている場合は、それぞれのアプリは、デフォルトで、ひとつの名前にレポートが送られます。それは、SNCI が、ただひとつの web.config ファイルを使用しているためです。各アプリがユニークな名前を持ってることを保証する方法は以下のとおりです。

  1. 独自のアプリケーションプールに各アプリケーションを分割し、各アプリケーションプールに固有の名前を割り当てます。
  2. appSettings から、NewRelic.AppName キーを全て削除します。そうすることで、(存在する場合は) web.config から、すべての名前を削除します。

    <appSettings>
    </appSettings>
  3. <application> 要素から、<name> 要素を全て削除します。そうすることで、(存在する場合は) newrelic.config から、すべての名前を削除します。囲っている <application></application> は削除しないでください。

    <application>
    </application>

各アプリは、属するアプリケーションプール名に応じて報告します。

注: SNCI 環境を利用する場合、アプリケーションプールをプリロードすると、上記のようにアプリケーション名をキャプチャする機能に制限が付きます。SNCI を使用している場合は、アプリプールをプリロードする機能を無効にしてください。

さらに詳しい情報

追加のドキュメントリソースは次のとおりです。