Komplett.NewRelic.AzureExtension 8.9.130

Komplett.NewRelic.AzureExtension

This is a custom made extension for Azure App Services made by Komplett for our own usage. You are probably looking for NewRelic.Azure.WebSites.Extension.

This will install version 8.9.130.0 of the NewRelic agent (Release notes).

Usage

Before installing the extension, make sure you have configured your App Service correctly.

General settings

• Platform Set this to either 32-bit or 64-bit depending on how you built your project.

AppSettings

• ASP_NET_CORE_APP [Optional] Set to True if you are running a ASP.NET Core application using AspNetCoreModule.
• NEWRELIC_HOME [Optional] Set this to the folder where you want NewRelic installed. If left blank it will install in {WEBROOT_PATH}\newrelic, which resolves to D:\Home\Site\wwwroot\newrelic.

How it works

During install this nuget will download one of the four available NewRelic agents and extract it in the application folder (controlled by NEWRELIC_HOME appSetting). There are four versions, a combination of either being 64 or 32 bit (controlled by the Platform setting) and being made for DotNetCore or for .NET Framework (controlled by the ASP_NET_CORE_APP AppSetting). It will try to remove a previously installed extension, so it's safe to update this extension without uninstalling it first. DLLs can be hard to delete if they are being used, so it will rename them instead. After extracting the extension the newrelic.config file will be updated to log to D:\Home\LogFiles\NewRelic folder.

Contributing

Building

1. Clone this repository
2. Make sure you have the latest version of nuget by running nuget update -self
3. Change the version number (see below) in Komplett.NewRelic.AzureExtension.nuspec, install.ps1 and in this Readme.md file
4. Run nuget pack in the root of the project
5. Upload the created nuget file (and the readme file) to nuget.org

Versioning

This project will install the NewRelic agent by downloading it from their website. Since it only downloads the agent when this extension is installed, the best way to keep the agent up to date is to reinstall this extension. For this reason the version of the extension will match the version of the agent. Thus, when a new version of the agent is relased, a new version of this extension should be built so that the extension can be updated in the App Service, which will cause it to download the new agent. For this reason the version number is hardcoded in the install script.