New Relic's .NET agent stores two types of log files in the Logs directory at %ALLUSERSPROFILE%\New Relic\.NET Agent\Logs. Both are needed for troubleshooting. If either log type is missing, some component of the .NET agent did not start.
- Agent logs: These filenames begin with newrelic_agent_.
- Profiler logs: These filenames begin with NewRelic.Profiler.
Generate log files
When troubleshooting your New Relic .NET agent, ensure it has been configured to generate
debug level log files, and monitor the size of your log file closely. Logging at
debug generates a lot of data very quickly. After reproducing your problem, return the log level to
If your C:\ProgramData\New Relic\.NET Agent is in a hidden folder, update your Windows settings so that you can see it. To generate New Relic for .NET log files:
- Open newrelic.config, usually located in C:\ProgramData\New Relic\.NET Agent (or %ALLUSERSPROFILE%\New Relic\.NET Agent).
- Change the
<log level="info" />setting to
<log level="debug" />.
- Save and close the file, and then wait a few minutes for the agent to read the new settings.
- Generate a few minutes of traffic to your app.
- If sending your log file to New Relic Support: In your New Relic support ticket, attach the newrelic.config file (not the text of the file) and attach the entire Logs folder from C:\ProgramData\New Relic\.NET Agent\Logs or from %ALLUSERSPROFILE%\New Relic\.NET Agent\Logs.
- In newrelic.config, change
<log level="debug" />to
<log level="info" />.
Generate Azure Web App log files
Kudu Console manages Azure Web App log reporting. To use the Kudu Console, first log into Azure.
- Navigate to the URL of your Azure Web app; for example,
- Insert the Kudu Console URL
scmsnippet into the URL; for example,
You should see a Kudu logo at the top left of the page with a black navigation bar and your Azure username at the upper right corner of the page.
To change the log level within the Kudu Console:
- On the navigation bar, select the Debug console menu and then select either CMD or PowerShell.
- Navigate to
- To edit newrelic.config, select the pencil icon.
- Save the change to newrelic.config.
- Wait a few minutes for the debug logs to be generated.
- Use the same steps to switch the
log levelback to
Collect system information
In addition to agent logs, a Microsoft System Information file is also useful for troubleshooting:
- From the Windows taskbar, select Start > Run and enter
msinfo32. Select OK.
- After the System Information page loads, select File > Save, and save the file.
- Wait a few minutes for the server to save the file.
- Attach the file to your New Relic support ticket.
Sometimes the .NET agent will start but not be able to write to its logs because it does not have the necessary permissions to create the log directory and log files. Permissions management varies greatly by environment, so you will need to work with your system administrator to verify that this is not an issue.
For more help
Additional documentation resources include: