.NET Azure Install Troubleshooting Framework

Once you’ve installed the .NET Core agent on Azure, 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.

This troubleshooting installation framework is geared towards Azure Web Apps, which is the most common, but you may run into:

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

  2. Confirm you installed using either NuGet or Azure Site Extension

  3. Run the Diagnostics CLI to collect data then validate the following…

    1. Confirm .NET Framework version meets requirements
    2. Confirm OS meets requirements
    3. Check how the app is hosted and its framework to see if CI is needed
    4. Confirm Env vars and Reg keys are set and correctly
    5. Confirm the config file is valid
    6. If using .NET agent version 8.21 or earlier, check for Always On
    7. Check Proxy / Network configuration is not blocking connection
    8. Check for existence of logs
    9. Restart instance and check for logs again, check event logs
    10. Check for High Security Mode configuration mismatches
  4. Check license key is valid and points to desired account

    1. License key can be gathered from the APM UI → account settings
  5. Check application name is the customer expected one

  6. Ask if using AppInsights

  7. Check if the app is a short lived web job and has required settings

  8. 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.

1 Like