New Relic Dotnet Extension Buildpack for PCF (Beta)

WARNING! The initial version of the New Relic Dotnet Extension Buildpack for Pivotal Cloud Foundry (PCF) was in private beta internally. It was used by New Relic and a select number of customers before being released to Pivotal Network. The product is currently in public beta and is intended for evaluation and testing purposes until further notice.

This documentation describes the New Relic Dotnet Extension Buildpack for PCF and provides instructions on how to install the tile. The tile can bind New Relic agents to Dotnet Core or Dotnet Framework apps so you can monitor them in a PCF environment.


New Relic Dotnet Extension Buildpack for PCF Logo

Overview

The New Relic Dotnet Extension Buildpack for PCF enables you to bind your Dotnet (Core and Framework) apps to New Relic Dotnet agents. This allows you to monitor the health and performance of these apps, analyze the data captured by agents, and additionally correlate the captured agent data with PCF infrastructure metrics and events collected by the New Relic Firehose Nozzle.

The New Relic Dotnet Extension Buildpack for PCF can be installed via the tile in Ops Manager. Alternatively, you can extract the PIVOTAL file and install individual extension buildpacks using the cf Command Line Interface (CLI) command cf create-buildpack.

After you start monitoring your apps, you can set alerts based on any metrics that are collected by Dotnet agents using the New Relic alerting subsystem.

The New Relic Dotnet Extension Buildpack for PCF installs one or more of the following buildpacks depending on the tile configuration:

  • New Relic Dotnet Core Extension Buildpack for Dotnet Core Applications (Ubuntu Trusty 14.04 and Xenial 16.04 stemcells). This extension buildpack is non-cached.

  • New Relic Dotnet Core Extension Cached Buildpack for Dotnet Core Applications (Ubuntu Trusty 14.04 and Xenial 16.04 stemcells) running in disconnected (isolated) PCF deployments

  • New Relic HWC Extension Buildpack for Dotnet Framework Applications (Windows 2012 R2 and Windows 2016 stemcells) This extension buildpack is non-cached.

  • New Relic HWC Extension Cached Buildpack for Dotnet Framework Applications (Windows 2012 R2 and Windows 2016 stemcells) running in disconnected (isolated) PCF deployments

All buildpacks use the multi-buildpack approach of Cloud Foundry and require either the standard Dotnet Core buildpack or HWC buildpack to be specified in the buildpack chain, either in the app manifest or in the cf CLI.

Product Snapshot

The following table provides version and version-support information about New Relic Dotnet Extension Buildpack for PCF.

Element Details
Tile version 1.0.1
Release date November 21, 2018
Software component version New Relic Dotnet Extension Buildpack v1.0.1
Compatible Ops Manager version(s) v2.1.x, v2.2.x, and v2.3.x
Compatible Pivotal Application Service versions v2.1.x, v2.2.x, and v2.3.x
IaaS support AWS, GCP, Azure, and vSphere

Compatibility

This product has been tested and is compatible with PCF versions v2.1.x and later.

Requirements

New Relic Dotnet Extension Buildpack for PCF requires the following:

  • An active New Relic account with a license key. This is used to bind Dotnet apps to New Relic Dotnet agents.

  • To use multi-buildpacks in the app manifest, you need cf CLI v6.38 or later. For general information about adding buildpacks to manifests, see buildpacks in the Cloud Foundry documentation.

  • To use the Dotnet HWC extension, you need the buildpack 3.0.3 or later.

  • To use the Dotnet Core extension, you need the dotnet core buildpack 2.1.5 or later.

Trial License

If you do not already have a New Relic account, you can obtain an account with a 60-day free trial license.

Feedback

If you have feature requests, questions, or information about a bug, please submit an issue on github.

Create a pull request or raise an issue on the source for this page in GitHub