New Relic provides limited technical support for customers using .NET Framework 4.0 or earlier. This level of support includes ensuring that the following areas are configured as expected:
- Agent configuration
- System settings
- Network access
- Permissions settings
You can perform most troubleshooting checks by using New Relic Diagnostics, with the exception of a few checks that must be done manually. If a New Relic Diagnostics check does find an issue, information on additional troubleshooting and potential resolutions will appear in your terminal.
To get the most out of your New Relic .NET Framework agent, make sure you follow New Relic's compatibility and requirements guidelines.
Applications running on .NET Framework version 4.0 or lower require a New Relic .NET agent version lower than 7.0.
Download and run the appropriate install package for your architecture:
Limited technical support to troubleshoot your basic installation and configuration includes:
- Check if the .NET agent is present and has valid configuration files.
- If the agent is installed, check for the agent's core
- If the config file is valid, check for expected elements. For example, include a manual check that it conforms to the standards laid out in the
Limited technical support to troubleshoot if instrumentation is possible includes:
- Check if WAS registry keys and required values are present and valid.
- Check W3SVC registry keys and required values are present and valid.
- Check ENV (non-IIS/global environment variables) reg keys and required values are present and valid.
- Verify if instrumentation is possible by using these key checks to determine what types of apps can be monitored.
- Confirm that the process has the necessary environment variables loaded. For example, use a tool such as the Microsoft Sysinternals Process Explorer.
Some checks require elevated permissions. For best results, run New Relic Diagnostics from an Admin shell.
Limited technical support to troubleshoot running web apps with the .NET agent installed includes:
- Check for any running W3WP processes, and get their
- Check for key
.dllrequired for instrumentation. For example, if there are any W3WP processes, check if the New Relic profiler
mscorelib.dllare loaded into the process.
Limited technical support to troubleshoot apps not hosted on IIS includes:
- When using the MSI, ensure the
Instrument alloption has been enabled.
- Check that the custom instrumentation file has been created, is in the proper place, and is accurate. If applicable, include a manual check that it conforms to the standards laid out in the
Limited technical support to troubleshoot system network access and permissions applies to any agent version, and includes:
- Check system network access and permissions.
- Run collector tests. For example, check whether the URL
https://collector.newrelic.com/status/mongrelis up and the server can connect to it.
- Check whether the config file contains any proxy settings, if proxy info has been passed to New Relic Diagnostics, and if these settings allow for connection to New Relic collectors.
- Check if New Relic Diagnostics is running as
New Relic Diagnostics must run as
admin to help ensure accuracy of some other tests. Also,
admin rights are required to install the .NET agent.
Limited technical support to troubleshoot information available from .NET agent logs includes:
- Gather any available agent logs.
- Check the log level.
- Check for known issues noted in the logs.
Troubleshooting log files may require you to work directly with New Relic Support.
Limited technical support depends on which .NET agent version you are using. New Relic Support will check what framework versions of the .NET agent are installed on the system.
When using OpenRasta instrumentation, the full URL may be captured on instrumented requests. This may result in query strings being collected that may contain sensitive information. See security bulletin NR19-01.
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.