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

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

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

最初にアプリをデプロイする際、設定ファイルを編集して、デフォルトの名前を意味のある名前に変更する必要があります。また、複数の名前を使ってメトリクスを集計することもできます。

.NET agent APIの利用

実行中、アプリケーション名を設定するのに『SetApplicationName()』エージェントAPIを使用することができます。この名前は、他の全てのアプリケーション名のソースに優先されます。

『SetApplicationName』を呼び出すとそのたびに前の呼び出しが上書きされます。.NET agent API を介して設定されたAPIは、アプリケーションを再起動すると維持されません。

IIS でホストされているアプリ名

web.config または newrelic.configを介してIIS でホストされるアプリケーションに名前を付けることができます。web.configファイルを介して名前を付けると、アプリケーションごとに意味のある名前がつけられ、メトリクスデータが複数のアプリケーションから不適切に収集されません。web.configを変更したくない場合は、≪アプリのローカルのnewrelic.configを介して名前をつける≫ことができます。

web.config を介した名前づけ

web.configを介してアプリに名前をつけると、一意のアプリケーションごとに確実に一意の名前がつけられます。web.config設定はnewrelic.configの設定を上書きします。

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

    《複数名》(最大3つ)をアプリに設定するには、カンマで区切ります。最初に割り当てられる名前は、プライマリーネームでなくてはなりません。
  2. IISをリセットします。

アプリがトラフィックを受信している限り、数分以内にデータはユーザーインターフェースに表示されます。数分経っても表示されない場合はデータが表示されないをご覧ください。

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>』≫ の要素からお使いのアプリケーションの新しい名前を以下のように指定します。

    複数の名前(最大3つ)をアプリに設定するには、各『name』に<名前>を指定します。アプリケーションに最初に割り当てられた名前がプライマリーネームになります。
  3. IISをリセットします。

アプリがトラフィックを受信している限り、数分以内にデータはユーザーインターフェースに表示されます。数分経っても表示されない場合は、データが表示されないをご覧ください。

アプリをプール後の名前づけ

親アプリプールに応じてアプリに名前を付けるには、newrelic.configweb.configから全ての明示的な名を削除します。SNCI名前づけの手順の手順に従って各アプリに一意の名前がつけられていることを確認してください。

newrelic.configの中で、<application></application> 親要素を残し、子<name> </name>だけを削除します。

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

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

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

    複数の名前(最大3つ)をアプリに設定するには、名前をカンマで区切ります。
  2. アプリケーションを再起動します。

アプリがトラフィックを受信している限り、数分以内にデータはユーザーインターフェースに表示されます。数分経っても表示されない場合は、データが表示されないをご覧ください。

外部ファイルを介した名前づけ

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

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

    複数の名前(最大3つ)をアプリに設定するには、名前をカンマで区切ります。最初の名前には、プライマリーネームをつける必要があります。
  3. IISをリセットします。

アプリがトラフィックを受信している限り、数分以内にデータはユーザーインターフェースに表示されます。数分経っても表示されない場合は、データが表示されないをご覧ください。

共有ネットワーク・コンテンツ・インフラストラクチャー

共有ネットワーク・コンテンツ・インフラストラクチャーを使っている場合、デフォルトではそれぞれのアプリは、単一の名前にレポートを送ります。これは、SNCIが単一のweb.configファイルを使用しているためです。各アプリが一意の名前を持ってることを保証する方法は以下のとおりです。

  1. 独自のアプリケーションプールに各アプリケーションを分割し、各アプリケーションプールに固有の名前を割り当てます。
  2. 『appSettings』から全ての『NewRelic.AppName』キーを削除することで、(該当する場合は)web.configから全ての名前を削除します。
  3. 『<application>』要素から『<name>』要素を削除することで、(該当する場合は)newrelic.configから、すべての名前を削除します。囲っている『<application></application>』タグは削除しないようにしてください。

すると各アプリは、アプリケーションプール名に応じてレポートします。

SNCI 環境では、アプリケーションプールをプリロードすると、New Relicのアプリケーション名をキャプチャする機能が制限されます。SNCI を使用している場合は、必ずアプリプールをプリロードする機能を無効にしてください。

関連情報

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

  • アプリケーションの名前づけ (New Relicの名前づけの概要)
  • .NET agentの構成 (.NET agentのすべての構成オプション)
  • データが表示されない (.NET) (データが表示されない場合のアプリケーションのトラブルシューティング)

New Relic オンライン テクニカル コミュニティの .NET監視に関するディスカッションにぜひご参加ください! テクニカルコミュニティは、 New Relicツールセットについて議論し、トラブルシューティングを行うための公開プラットフォームです。

PROプランのすべての機能を
14日間無料でお試し

新規無料登録いただくとPROプランのすべての機能を
14日間無料でお試しいただけます。
クレジットカードなど決済情報の登録は不要です。

各プランの詳細はこちらからご確認ください。