You can set the app name in two places: In the agent's configuration file and in New Relic's user interface. These have two different effects.
Change the application's alias
The application name you set in the New Relic's user interface is a human-readable alias. If you change it, the visible name of your app is updated everywhere in the New Relic site.
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.
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.
Change the application identifier
Give each application a primary name in its config file (or with environment variables, agent API calls, or other supported "local" configuration methods). This name is an identifier the data collector uses to distinguish one application from another. If two applications share a name, then their data will be aggregated in the UI.
For example, if five of your applications are named App A and one app is named App B, the UI will display two apps: App A and App B.
If you change the app identifier, a new application will appear in the New Relic user interface with the new name, and data will stop reporting to the app with the old name.
The application name is taken from the agent's configuration file:
|Agent||Configuration file value|
|.NET||Use any of the available options to name your .NET app.|
For more help
Additional documentation resources include:
- Name your application (how to give your app a specific name and why it is important)
- Use multiple names for an app (how to "roll up" data about an app)
- Cleaning up your agent configuration file (settings in your configuration file affected by server-side configuration)
- APM Overview page (view a summary of your app's performance)