Java エージェントは自動的にhost:port名を JVM に割り当てます。デフォルト名が役に立たない場合は、New Relic UI で JVM を区別するために表示名を設定できます。サポートされているフレームワークの場合、Java エージェントは表示名の代わりにインスタンス名を使用します。
Java エージェントは、使用している環境に関わらず、ホスト、ポート、ディスパッチャ によって、実行中のエージェントを一意に識別します。
表示名 [#display-name]
APM UI のデフォルトのhost:portラベルが役に立たない場合は、New Relic UI でその名前を表示名で装飾できます。 環境変数またはnewrelic.yml構成ファイルのいずれかで構成を介して表示名を設定します。 環境変数は設定ファイルの値よりも優先されます。 JVMが再起動され、Javaagent が再度レポートすると、以下の例に示すように、host:port に加えて表示名がJVMリストに表示されます。
表示名を設定するには
NEW_RELIC_PROCESS_HOST_DISPLAY_NAME環境変数を設定します。
またnewrelic.yml
に
process_host.display_nameを設定します。
JVMを再起動すると、New RelicのUIに変更内容が表示されます。
ヒント
また、 システムプロパティ で表示名を設定することもできます。
インスタンス名
WebSphere および WebLogic ユーザーの場合、Java エージェントはアクティブなアプリケーション サーバー インスタンスごとにインスタンス名も報告します。これはAPM Settings > Environment ページに表示されます。 通常、この名前はアプリ サーバーによって提供されます。 インスタンス名が設定されている場合は、New Relic UI の表示名の代わりにそのインスタンス名が使用されます。
ホスト名のロジックの優先順位
複数のホスト名設定がある場合 (たとえば、WebSphere を使用し、 display_nameプロパティも設定している場合)、エージェントは次の優先順位を使用します。
display_nameデフォルト名、WebSphere および WebLogic インスタンス名をオーバーライドします。- WebSphere と WebLogic のインスタンス名は、デフォルトの名前を上書きします。
- デフォルト (
host:port) の名前の優先順位は最も低くなります。
ホストとエージェント固有の識別子
Javaエージェントは、ホスト、ポート、ディスパッチャを使用して、同じアプリ名でレポートする複数のJVMを一意に識別します。そのため、同じサーバー上で動作する複数のエージェントは、ポートやディスパッチャ名が異なる限り、別々に報告されます。
固有の識別子は、以下の値に基づいています。
Host
: OS から派生したアプリの親サーバーの識別子。 この値は Javaagent では設定できません。
Port
: アプリケーション サーバーに関連付けられたポート。 エージェントがポート番号を判別できない場合、またはアプリがアプリ サーバーで実行されていない場合は、デフォルトで
0
になります。 この値はユーザーが設定可能です。
Dispatcher Name
: アプリ サーバーの名前。 たとえば、Apache Tomcat、Glassfish、WebLogic などです。 アクティブなアプリ サーバーがない場合、デフォルトは
Unknown
になります。