/newrelic-dotnet-buildpack-tile

This is New Relic Dotnet Extension Buildpack repository for Cloud Foundry.

Primary LanguageGoApache License 2.0Apache-2.0


New Relic Dotnet Extension Buildpack for PCF (General Access)




This document describes New Relic Dotnet Extension Buildpack Tile for VMware Tanzu (PCF) and instructions on how to install and use New Relic's Dotnet extension tile to bind New Relic agents to Dotnet Core or Dotnet Framework applications to monitor them in VMware Tanzu (PCF) environment.


New Relic Dotnet Extension Buildpack


Overview

New Relic Dotnet Extension Buildpack for PCF enables you to bind your Dotnet (Core and Framework) applications to New Relic Dotnet agents, and monitor the health and performance of these applications, analyze the data captured by agents, and aditionally correlate the captured agent data with PCF infrastructure which is collected by New Relic Firehose Nozzle.

The extension buildpacks could be installed using the tile in OpsMgr, or alternatively you could extract the ".pivotal" file, and install individual extension buildpack(s) using CF CLI command "cf create-buildpack" as you wish.

Once you start monitoring your applications, you would also have the ability to set alerts based on any metrics that are collected by Dotnet agents using New Relic's alerting subsystem.

The tile installs one or more of the following 4 buildpacks depending on the tile configuration:

  1. New Relic Dotnet Core Extension Buildpack for Dotnet Core Applications (Ubuntu Jammy)
  2. New Relic Dotnet Core Extension Cached Buildpack for Dotnet Core Applications (Ubuntu Jammy) running in disconnected (isolated) PCF deployments
  3. New Relic HWC Extension Cached Buildpack for Dotnet Framework Applications (Windows 2019)
  4. New Relic HWC Extension Buildpack for Dotnet Framework Applications (Windows 2019) running in disconnected (isolated) PCF deployments

The first 2 extension buildpacks are for Dotnet Core applications running on Ubuntu Trusty (14.04) and Ubuntu Xenial (16.04). The first extension is non-cached, and the second one is cached version of buildpack for Dotnet Core.

The 3rd and 4th buildpacks are HWC extensions for Windows 2012 R2 and Windows 2016. The third extension is non-cached, and the fourth one is cached version of HWC extension buildpacks.

All 4 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 application's manifest or in the CF CLI command line.

Note: The cached version of this extension buildpack for both Dotnet Core and Dotnet Framework contains New Relic Dotnet Agents version 8.27.139.0


Product Snapshot

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

Element Details
Tile version 1.1.12
Release date July 24, 2023
Software component version New Relic Dotnet Extension Buildpack v1.1.12 (General Access)
Compatible Ops Manager version(s) v2.9.x, v2.10.x and v3.0.x
Compatible Pivotal Application Service versions v2.10.x, v2.11.x, v2.12.x, v2.13.x, v3.0.x and v4.0.x
IaaS support AWS, GCP, Azure, and vSphere

Compatibility

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

Requirements

As prerequisite you need to have the following

  • An active New Relic account with a license key which is used to bind Dotnet applications to New Relic Dotnet agents.
  • In order to use multi-buildpacks in the application's manifest file, at a minimum you need to upgrade CF CLI to version 6.38.
  • Dotnet HWC extension requires a minimum version of hwc buildpack 3.0.3.
  • Dotnet Core extension requires a minimum version of dotnet core buildpack 2.1.5.

Trial License

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

Feedback

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