.NET Core on Linux Troubleshooting Framework

Once you’ve installed the .NET Core agent on Linux, you should see data reporting within a few minutes. If you’re having trouble, these are the steps that our support teams take to troubleshoot, and we hope they will help you find and resolve the issue quickly.

  1. Confirm the app is receiving traffic, has been for at least 5 min, and continues to receive traffic during troubleshooting

  2. Run NrDiag to collect data then validate

  3. Confirm .NET Core Framework version meets requirements

  4. Confirm OS meets requirements

  5. Check how the app is hosted and its framework to see if custom instrumentation is needed

  6. Confirm Env vars are set and correct

  7. Confirm config file is valid

  8. Check Proxy / Network configuration is not blocking connection

  9. Check for existence of logs in the agent installation directory

  10. Check that .NET Core agent profiler is loaded into the applications process: sudo cat /proc/[pid]/maps | grep “libNewRelicProfiler.so”

  11. Check Permissions, does the applications user have permission to read/write/execute

  12. Check for High Security Mode configuration mismatches

  13. Check license key is valid and points to desired account

  14. License key can be gathered from the APM UI → account settings

  15. Check application name is the expected one

  16. Confirm there are no other profilers used

  17. Check folder/file permissions for install location are correct

  18. Check if the app is a short lived, sub 2 min, process and has required settings

  19. If you are still unable to resolve the issue please reach out to New Relic Global Technical Support by going to support.newrelic.com. Please be sure to mention, in as much detail as possible, the steps you have tried already and details of what you expect to see and what you are seeing.