New Relic connects metrics to individual applications using your license key and the primary application name. You can change the app's name in your config file, or assign an alias to the app to change how it appears in the New Relic UI.
If you do not specify the app name in your New Relic configuration file, most New Relic agents provide a generic application name by default. To ensure all aggregated data for the same app is reported accurately, make sure you give each app a descriptive name.
Changing the name vs. the alias
You can assign a new app name or change the app alias. These have two different effects:
|Term||How to change it||Effect|
|Name||Assign the name in your config file||
Changing the app name in the agent's configuration file will cause the application to report to a new heading in the New Relic user interface, with a total discontinuity of data.
This is useful, for example, if you want to start over and report new data. If no other agents are reporting to the old app name, the old app name will appear gray and can be deleted.
|Alias||Change the alias in the APM Settings UI||Creating an alias for the app name only changes how the app name appears in the New Relic UI. Changing the alias does not affect how data is reported. It simply helps you keep track of your data with a useful alias.|
Give each app a descriptive name
By default, most New Relic agents provide a default application name, such as My Application or PHP Application, for each app that is linked to your account.
We recommend changing the default name of an app to a more descriptive name before deployment, and it can be up to 128 characters long.
Each unique app name creates a new application record in your New Relic UI, which allows you to:
- Run an application on more than one host, and have all the data aggregated (collected) under the same name.
- Run multiple applications on a single host, and have all the data aggregated (collected) under different names.
Multiple names for an app
By giving your app multiple names, you can aggregate metrics for multiple agents across an entire app or service.
If you use multiple names for an app, the last name assigned is the least specific name New Relic uses to roll up the data. For best results to view both instance-level and aggregated data, set the order of your app's rollup names from most specific to least specific in your configuration file.
Assign the name in your config file
To change the app name, set the app name value in the agent's configuration file. If you have deployed an app via one APM agent, and then deploy another app with the same name via a different APM agent, New Relic will automatically append the agent language name to the end of the second app's name. For example, if you deploy a Node.js app named
New-App, and then deploy a .NET app named
New-App, New Relic will automatically append the second app name as
|Agent||Configuration file value|
|C||Identify a maximum of three names separated by a semicolon
|Java||See the options for naming your Java application.|
|.NET||Use any of the available options to name your .NET app.|
|PHP||See the options for naming your PHP application.|
Change the application's alias
The application name you set in the New Relic user interface is a human-readable alias. If you rename your app, the visible name is updated everywhere in the New Relic site, including New Relic Browser.
Initially, this alias is the same as the app's identifier name in the New Relic agent configuration file. However, changing the UI alias does not affect the underlying app name used for data rollup, which is set in the agent config file. The application must be actively reporting data to change the alias. Changing the UI alias will cause all agents that report under the app identifier to restart themselves.
To change the alias for your application's name in the New Relic user interface:
- Go to rpm.newrelic.com/apm > (select an app) > Settings.
- In the Name field, type a new name (alias) for the selected app.
- Select Save application settings.
You can also change the app's alias with the New Relic REST API.