New Relicは、ライセンスキーとプライマリアプリケーション名を使用して、メトリクスを各アプリケーションに接続します。アプリケーション名は、設定ファイルで変更するか、アプリケーションにエイリアスを割り当てて、New Relic UI に表示する名前を変更できます。
重要
New Relic設定ファイルにアプリケーション名を指定しない場合、ほとんどのNew Relicエージェントはデフォルトで汎用アプリケーション名を使用します。同じアプリケーションに対するすべての集計データが正確にレポートされるようにするには、各アプリケーションに分かりやすい名前を付ける必要があります。
名前対エイリアスの変更
アプリには新しい名前を割り当て、またはエイリアスを変更できます。これには 2 つの効果があります。
用語 | 変更方法 | 効果 |
---|---|---|
名前 | エージェントの設定ファイル内のアプリケーション名を変更すると、アプリケーションは、New Relicユーザーインタフェースの新しい見出しに完全に不連続なデータをレポートします。 これは、たとえば、最初からやり直して新しいデータをレポートする場合に便利です。他のエージェントが古いアプリケーション名にレポートしていない場合、古いアプリケーション名はグレー表示され、削除できます。 | |
エイリアス | アプリケーション名にエイリアスを作成すると、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)
として自動的に追加します。
エージェント | 設定ファイルの値 |
---|---|
C |
|
Go |
|
Java | Javaアプリケーションの命名に関するオプションをご覧ください。 |
.NET | 使用可能オプションのいずれかを使用して、.NET アプリに命名します。 |
Node.js |
|
PHP | PHP アプリケーションに名前を付ける際のオプションをご覧ください。 |
Python |
|
Ruby |
|
アプリケーションのエイリアスの変更
New Relic ユーザーインタフェースで設定するアプリケーション名は、人が判読できるエイリアスです。アプリ名を変更すると、リンクされたブラウザアプリを含むNew Relic UIのすべての場所で表示名が更新されます。
最初は、このエイリアスはNew Relicエージェントの設定ファイルのアプリの識別子名と同じです。ただし、UIエイリアスを変更しても、エージェントの設定ファイルで設定された、データのロールアップに使用する元のアプリ名には影響しません。エイリアスを変更するには、アプリケーションがアクティブにデータをレポートする必要があります。UIエイリアスを変更すると、アプリ識別子でレポートするすべてのエージェントが再起動されます。
New Relicユーザーインタフェースでアプリケーション名のエイリアスを変更するには:
- one.newrelic.com > APM & services >(アプリを選択)> Settings > Applicationの順に移動します。
- Application aliasフィールドに、選択したアプリの新しい名前(エイリアス)を入力します。
- Save application settingsを選択します。
ヒント
New Relic REST API を使用して、アプリのエイリアスを変更することもできます。
アプリに複数の名前を使用する
アプリに複数の名前を付けることにより、アプリ全体またはサービス全体で複数のエージェントのメトリクスを集計できます。
重要
アプリに複数の名前を使用する場合は、最後に割り当てた名前が、New Relic がデータのロールアップに使用する最も限定度が低い名前になります。インスタンスレベルのデータと集計データの両方を表示する最良の方法は、設定ファイル内におけるアプリのロールアップ名の順序を限定度が高い名前から低い名前の順に設定することです。