Rename your application

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:

  1. Go to rpm.newrelic.com/apm > (select an app) > Settings.
  2. In the Name field, type a new name (alias) for the selected app.
  3. Select Save application settings.

You can also change the app's alias with the New Relic REST API.

screen-renaming-applications.png
rpm.newrelic.com/apm > (select an app) > Settings > Application: Changing this alias does not change the application's name in its configuration file. Only changing the application identifier in your New Relic configuration file will affect where your application data is reported in the UI.

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
Go Set AppName to a maximum of three names separated by a semicolon.
Java Set app_name to a maximum of three names separated by a semicolon.
.NET Use any of the available options to name your .NET app.
Node.js Set app_name to a maximum of three names separated by a comma. Enclose the names with single or double quotes. (Or, change the environment variable NEW_RELIC_APP_NAME.)
PHP Set newrelic.appname to a maximum of three names separated by a semicolon.
Python Set app_name to a maximum of three names separated by a semicolon. Do not add a space after the semicolon, or the next name will be interpreted as a comment.
Ruby Set app_name to a maximum of three names separated by a semicolon.

For more help

Additional documentation resources include:

Join the discussion about New Relic APM in the New Relic Online Technical Community! The Technical Community is a public platform to discuss and troubleshoot your New Relic toolset.

If you need additional help, get support at support.newrelic.com.