New Relic's .NET agent gives you several ways to change the application name reported and displayed in APM. This document gives you an overview of those naming options.
When you first deploy your app, you can change the default name to a more descriptive one. Since New Relic collects metrics using these names, customizing them allows you to run the same application on multiple hosts and get metrics from all their instances.
Typically, configuring your app-local
newrelic.config file is the most convenient naming method.
Configure your app-local
This method lets you give your app a unique name with specific configuration settings. It also works for both IIS and non-IIS hosted apps.
As long as your app is active, data should appear within a few minutes. If not, follow our troubleshooting procedures.
If you have a specific use or purpose in mind, you may prefer a different naming method. Here's a full list of the alternative methods:
Some methods take precedence over others. Before choosing a naming method, make sure you understand how your configurations may be affected.
If you have apps hosted on IIS and prefer not to have a local
Set app name using environment variables
If you want to easily set app names during the deployment of containers, set an environment variable in the application's environment.
Name after app pools
If your IIS application pools already have unique names you like, or if you're using a shared network content infrastructure (SNCI), you can name your app after its assigned app pool.
If you have applications not hosted on IIS and prefer not to have a local
Use the .NET agent API
If you want to rename your app programmatically, you can use the
As long as your app is active, data should appear within a few minutes. If not, make sure you've performed an
IISRESET from an administrative command prompt if you've changed your .NET app's configuration file (
app.config). Otherwise, follow our troubleshooting procedures.
You can use multiple app names to aggregate data from your applications. We sometimes call this "rolling up" your data.
For the .NET agent, you can set up to three application names. The first name is the primary application name, and the second and third names are used for the more general data aggregation categories. For more about how multiple app names work, see Use multiple app names.
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's data security and licenses documentation.