Your data. Anywhere you go.

New Relic for iOS or Android


Download on the App Store    Android App on Google play


New Relic Insights App for iOS


Download on the App Store


Learn more

Close icon

Relic Solution: .NET Core Agent Required Environment Variables


#1

The following environment variables are required to be present in your application’s process environment (not just on the server) in order for the .NET Core agent to successfully monitor your application.

These variables are specific to applications running on the .NET Core CLR. If your application uses the .NET Framework CLR, see this post instead.

Windows (Installed with the MSI)

  • Please note “Program Files” vs “ProgramData” in the CORECLR_NEWRELIC_HOME and NEWRELIC_INSTALL_PATH variables.
CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
CORECLR_NEWRELIC_HOME=C:\ProgramData\New Relic\.NET Agent\
NEWRELIC_INSTALL_PATH=C:\Program Files\New Relic\.NET Agent

Windows (Installed without the MSI)

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
CORECLR_NEWRELIC_HOME=PATH\TO\INSTALL\DIRECTORY
CORECLR_PROFILER_PATH=PATH\TO\INSTALL\DIRECTORY\NewRelic.Profiler.dll

Linux

CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
CORECLR_NEWRELIC_HOME=PATH/TO/INSTALL/DIRECTORY
CORECLR_PROFILER_PATH=PATH/TO/INSTALL/DIRECTORY/libNewRelicProfiler.so

Relic Solution: .NET Core Agent Installation Troubleshooting in Windows
Relic Solution: .NET Core Agent Installation Troubleshooting in Linux
#2

As of 2019-10-10, I was told in a support ticket:

Could we please unset the CORECLR_PROFILER_PATH variable? It’s not required on Windows. The only variables that are required for .NET Core on Windows are:
CORECLR_ENABLE_PROFILING=1
CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
CORECLR_NEWRELIC_HOME=C:\ProgramData\New Relic\.NET Agent\
NEWRELIC_INSTALL_PATH=C:\Program Files\New Relic\.NET Agent\
Please note that CORECLR_NEWRELIC_HOME is set to ProgramData while NEWRELIC_INSTALL_PATH is set to Program Files.


#3

Thanks for reminding me about this! I made some edits to reflect the changes with the most recent installer.