Install and configure Azure Function monitoring on New Relic

Before you begin

Ensure that your Azure Function meets our compatibility and requirements.

Link your Azure account to New Relic

You can link your Azure account to New Relic by configuring the polling of Azure monitor metrics. This allows you to see the metrics in the New Relic UI. For more information, refer Azure integration.

Instrument your Azure Function with the New Relic .NET Agent

Depending on your deployment environment, select one of the following options to instrument your Azure Function with the New Relic .NET agent.

Add the latest version of the NewRelic.Agent NuGet package to your application project.
Use your preferred publishing mechanism to deploy your updated application to Azure.
When you deploy your application, the .NET agent is installed in the /home/site/wwwroot/newrelic folder.

You can instrument your Azure Function with the New Relic .NET agent on Windows in the following ways:

The New Relic Azure Websites Extension (v1.6.0 and later) automatically installs the latest version of the .NET agent and configures instrumentation for your Windows Azure Function. To install the New Relic Azure Websites Extension, follow these steps:

In the Azure portal, navigate to your function app.
Click the Development tools section, and select Extensions.
Click + Add.
Select Search for an extension to install and enter New Relic .NET Agent in the Filter items box.
Select the New Relic .NET Agent(vx.x.x) - New Relic extension and click Add.
When installation is complete, the extension appears in the list of installed extensions. To verify correct installation, click the link under the Browse column to view the installation log. The Azure Websites Extension configures all required environment variables except your license key (see the next step for details). The .NET agent is installed to C:\home\NewRelicAgent and log files are written to C:\home\LogFiles\NewRelic.

To install the New Relic .NET agent, add the following lines to the final stage of your Dockerfile:

# Install the latest New Relic .NET agent using the apt-get package manager
# To install a specific version of the .NET agent, add the version number to the apt-get install line (i.e. apt-get install -y newrelic-dotnet-agent=10.38.0)
RUN apt-get update && apt-get install -y wget ca-certificates gnupg \
    && echo 'deb http://apt.newrelic.com/debian/ newrelic non-free' | tee /etc/apt/sources.list.d/newrelic.list \
    && wget https://download.newrelic.com/548C16BF.gpg \
    && apt-key add 548C16BF.gpg \
    && apt-get update \
    && apt-get install -y newrelic-dotnet-agent \
    && rm -rf /var/lib/apt/lists/*

When you deploy your application, the .NET agent is installed in the /usr/local/newrelic-dotnet-agent folder.

Configure environment variables

After you've instrumented your Azure Function with the New Relic .NET Agent, configure environment variables:

Navigate to your Azure Function in the Azure portal.
Under Settings, click Environment variables, and then click Advanced edit.
Based on your deployment environment, paste the following values:

重要

Ensure that you add a comma at the end of the last existing line and update your license key in the following configurations.

({
  "name": "CORECLR_ENABLE_PROFILING",
  "value": "1",
  "slotSetting": false
},
{
  "name": "CORECLR_NEW_RELIC_HOME",
  "value": "/home/site/wwwroot/newrelic",
  "slotSetting": false
},
{
  "name": "CORECLR_PROFILER",
  "value": "{36032161-FFC0-4B61-B559-F6C5D41BAE5A}",
  "slotSetting": false
},
{
  "name": "CORECLR_PROFILER_PATH",
  "value": "/home/site/wwwroot/newrelic/libNewRelicProfiler.so",
  "slotSetting": false
},
{
  "name": "NEW_RELIC_LOG_DIRECTORY",
  "value": "/home/LogFiles/NewRelic",
  "slotSetting": false
},
{
  "name": "NEW_RELIC_LICENSE_KEY",
  "value": "<your newrelic license key here>",
  "slotSetting": false
})

New Relic Azure Websites Extension:

{
  "name": "NEW_RELIC_LICENSE_KEY",
  "value": "<your newrelic license key here>",
  "slotSetting": false
}

The Azure websites extension automatically configures all other required environment variables.

Optionally, you can specify the version of the .NET agent you want to install by adding the following environment variable:

{
  "name": "NEW_RELIC_AGENT_VERSION_OVERRIDE",
  "value": "10.38.0",
  "slotSetting": false
}

NewRelic.Agent Nuget package:

({
  "name": "CORECLR_ENABLE_PROFILING",
  "value": "1",
  "slotSetting": false
},
{
  "name": "CORECLR_NEW_RELIC_HOME",
  "value": "C:\\home\\site\\wwwroot\\newrelic",
  "slotSetting": false
},
{
  "name": "CORECLR_PROFILER",
  "value": "{36032161-FFC0-4B61-B559-F6C5D41BAE5A}",
  "slotSetting": false
},
{
  "name": "CORECLR_PROFILER_PATH_32",
  "value": "C:\\home\\site\\wwwroot\\newrelic\\x86\\NewRelic.Profiler.dll",
  "slotSetting": false
},
{
  "name": "CORECLR_PROFILER_PATH_64",
  "value": "C:\\home\\site\\wwwroot\\newrelic\\NewRelic.Profiler.dll",
  "slotSetting": false
},
{
  "name": "COR_ENABLE_PROFILING",
  "value": "1",
  "slotSetting": false
},
{
  "name": "NEW_RELIC_HOME",
  "value": "C:\\home\\site\\wwwroot\\newrelic",
  "slotSetting": false
},
{
  "name": "COR_PROFILER",
  "value": "{71DA0A04-7777-4EC6-9643-7D28B46A8A41}",
  "slotSetting": false
},
{
  "name": "COR_PROFILER_PATH_32",
  "value": "C:\\home\\site\\wwwroot\\newrelic\\x86\\NewRelic.Profiler.dll",
  "slotSetting": false
},
{
  "name": "COR_PROFILER_PATH_64",
  "value": "C:\\home\\site\\wwwroot\\newrelic\\NewRelic.Profiler.dll",
  "slotSetting": false
},
{
  "name": "NEW_RELIC_LOG_DIRECTORY",
  "value": "C:\\home\\LogFiles\\NewRelic",
  "slotSetting": false
},
{
  "name": "NEW_RELIC_LICENSE_KEY",
  "value": "<your newrelic license key here>",
  "slotSetting": false
})

({
  "name": "CORECLR_ENABLE_PROFILING",
  "value": "1",
  "slotSetting": false
},
{
  "name": "CORECLR_NEW_RELIC_HOME",
  "value": "/usr/local/newrelic-dotnet-agent",
  "slotSetting": false
},
{
  "name": "CORECLR_PROFILER",
  "value": "{36032161-FFC0-4B61-B559-F6C5D41BAE5A}",
  "slotSetting": false
},
{
  "name": "CORECLR_PROFILER_PATH",
  "value": "/usr/local/newrelic-dotnet-agent/libNewRelicProfiler.so",
  "slotSetting": false
},
{
  "name": "NEW_RELIC_LOG_DIRECTORY",
  "value": "/home/LogFiles/NewRelic",
  "slotSetting": false
},
{
  "name": "NEW_RELIC_LICENSE_KEY",
  "value": "<your newrelic license key here>",
  "slotSetting": false
})

Restart your Azure Function

After you've added the environment variables, restart your Azure Function to apply the changes.

What's next

After you complete the installation and configuration steps, send traffic to your Azure Function to see the metrics in the New Relic UI dashboard.

Install and configure Azure Function monitoring on New Relic

Before you begin

Link your Azure account to New Relic

Instrument your Azure Function with the New Relic .NET Agent

Use the New Relic Azure Websites Extension

Add the New Relic agent NuGet package to your project

Configure environment variables

重要

New Relic Azure Websites Extension:

NewRelic.Agent Nuget package:

Restart your Azure Function

What's next

Install and configure Azure Function monitoring on New Relic

Before you begin .css-21sua1{background:none;border:none;width:0;padding:0;}

Link your Azure account to New Relic

Instrument your Azure Function with the New Relic .NET Agent

Add the New Relic agent NuGet package to your project

Configure environment variables

重要

New Relic Azure Websites Extension:

NewRelic.Agent Nuget package:

Restart your Azure Function

What's next

Before you begin