New Relicは、ライセンスキーとプライマリアプリケーション名を使用して、メトリクスを各アプリケーションに接続します。アプリケーション名は、設定ファイルで変更するか、アプリケーションにエイリアスを割り当てて、New Relic UI に表示する名前を変更できます。
重要
New Relic設定ファイルにアプリケーション名を指定しない場合、ほとんどのNew Relicエージェントはデフォルトで汎用アプリケーション名を使用します。同じアプリケーションに対するすべての集計データが正確にレポートされるようにするには、各アプリケーションに分かりやすい名前を付ける必要があります。
名前対エイリアスの変更
アプリには新しい名前を割り当て、またはエイリアスを変更できます。これには 2 つの効果があります。
用語 | How to change it | Effect |
|---|---|---|
名前 | エージェントの設定ファイル内のアプリケーション名を変更すると、アプリケーションは、New Relicユーザーインタフェースの新しい見出しに完全に不連続なデータをレポートします。 これは、たとえば、最初からやり直して新しいデータをレポートする場合に便利です。他のエージェントが古いアプリケーション名にレポートしていない場合、古いアプリケーション名はグレー表示され、削除できます。 | |
エイリアス | アプリケーション名のaliasを作成すると、New Relic UIでのアプリ名の表示方法のみが変更されます。エイリアスを変更しても、データのレポート方法には影響しません。これは、便利なエイリアスを使用してデータを追跡する上で役立ちます。 |
各アプリケーションに分かりやすい名前を付ける
ほとんどのNew Relicエージェントのデフォルト設定では、アカウントにリンクされている各アプリケーションに対してデフォルトのアプリケーション名（My Application、PHP Applicationなど）を使用します。
重要
アプリのデフォルト名は、デプロイメント前に分かりやすい名前に変更することをお勧めします。名前には最大128文字を使用できます。
それぞれの固有のアプリ名は、ご利用のNew Relic UIで新しいアプリケーションレコードを作成します。これにより、以下が可能となります。
- 複数のホストでアプリケーションを実行し、すべてのデータを同じ名前で集計（収集）させます。
- 単一のホストで複数のアプリケーションを実行し、すべてのデータを別名で集計（収集）させます。
設定ファイルに名前を割り当てる
アプリ名を変更するには、エージェントの設定ファイルでアプリ名の値を設定します。1つのAPMエージェントを介してアプリケーションをデプロイしてから、別のAPMエージェントを介して同じ名前の別のアプリケーションをデプロイすると、New Relicは自動的にエージェント言語名を2番目のアプリ名の末尾に追加します。たとえば、New-Appという名前のNode.jsアプリをデプロイしてから、New-Appという名前の.NETアプリをデプロイする場合は、New Relicは2番目のアプリ名をNew-App (DOTNET)として自動的に追加します。
命名規則を遵守するため、アプリケーション名には<および>の記号は使用できないことに留意してください。これらの記号が含まれている場合は、自動的に削除されます。アプリケーション名がこの要件に従っていることを確認してください。
Agent | Configuration file value |
|---|---|
C |
|
Go |
|
Java | Javaアプリケーションの命名に関するオプションをご覧ください。 |
.NET | 使用可能オプションのいずれかを使用して、.NET アプリに命名します。 |
Node.js |
|
PHP | PHP アプリケーションに名前を付ける際のオプションをご覧ください。 |
Python |
|
Ruby |
|
アプリケーションのエイリアスの変更
New Relic ユーザーインタフェースで設定するアプリケーション名は、人が判読できるaliasです。アプリ名を変更すると、リンクされたブラウザアプリを含むNew Relic UIのすべての場所で表示名が更新されます。
最初は、このエイリアスはNew Relicエージェントの設定ファイルのアプリの識別子名と同じです。ただし、UIのエイリアスを変更しても、エージェントの設定ファイルで設定された、データのロールアップに使用する元のアプリ名はその影響を受けませんdoes not。エイリアスを変更するには、アプリケーションがアクティブにデータをレポートする必要があります。UIのエイリアスを変更すると、アプリ識別子でレポートするすべてのエージェントが再起動されます。
New Relicユーザーインタフェースでアプリケーション名のaliasを変更するには：
one.newrelic.com > All capabilities > APM & services > (select an app) > Settings > Application
に移動します。
Application alias
フィールドに、選択したアプリの新しい名前 (エイリアス) を入力します。
Save application settings
を選択します。
New Relic REST API を使用して、アプリのエイリアスを変更することもできます。
ヒント
Application settingsで変更を行うと、保存された変更によりエージェントが再起動されます。この特定のサービスのエージェントのみが再起動されますが、このアクションによってアプリプールやWebサーバーは再起動されません。
アプリに複数の名前を使用する
アプリに複数の名前を付けることにより、アプリ全体またはサービス全体で複数のエージェントのメトリクスを集計できます。
重要
アプリに複数の名前を使用する場合は、最後に割り当てた名前が、New Relic がデータのロールアップに使用する最も限定度が低い名前になります。インスタンスレベルのデータと集計データの両方を表示する最良の方法は、設定ファイル内におけるアプリのロールアップ名の順序を限定度が高い名前から低い名前の順に設定することです。