Blog
Support Center
Explorer's Hub
NR University
NR Status

Skip to Navigation ↓

Manage APM Agents

Installation

Compatibility and requirements
Install the agent
Update the agent
Disable APM agent
Uninstall the agent

App Naming

Name your application
Use multiple names for an app

Agent Data

Custom instrumentation
Agent attributes
Custom attributes
Custom events
Custom metrics
Manage errors

Configuration

Server-side configuration
Configure the agent
High security mode
Add, rename, and remove hosts
Monitor background processes
Audit all data transmitted

Maintenance

Agent established releases
Connect hosts to your account
End of life policy

Troubleshooting

New Relic Diagnostics
Not seeing data
Find the agent root directory
Generate logs
Metric grouping issues

Go Agent

Get Started

New Relic for Go
Compatibility and requirements
Go agent security
Go agent release notes

Installation

Install New Relic for Go
Install in GAE flex
Uninstall the Go agent

Configuration

Go configuration
Go agent logging

Instrumentation

Instrument Go transactions
Instrument Go segments
Go agent attributes
Create custom metrics in Go

API Guides

Go agent API guide

Features

Cross application tracing
Go runtime UI page
Custom events
Install New Relic Browser

Troubleshooting

No data appears

Java Agent

Getting Started

New Relic for Java
Compatibility and requirements
Java agent security
Java agent established releases
Java release notes

Installation

Install the Java agent
Include agent with JVM
Upgrade the Java agent
Uninstall the Java agent

Additional Installation

AWS Elastic Beanstalk
WildFly version 11 installation
GAE flex
WebSphere App Server
Java agent self-installer
Java 2 security installation
Java SE 5.0 support
Maven install
Scala installation

Heroku

Java agent and Heroku
Scala and Heroku
No data appears (Heroku)

Configuration

Java agent configuration
Java agent config file template
Hostname logic
Automatic application naming
Error configuration
Configuring your SSL certificates

Attributes

Java agent attributes

Features

JVM metrics page

Instrumentation

Use RabbitMQ or JMS for message queues
Transaction naming protocol
Monitor deployments
Browser monitoring
Browser best practices
Java agent incubator
Ignore transactions

Custom Instrumentation

Java custom instrumentation
Custom Instrumentation Editor
Java instrumentation by XML
XML instrumentation example
Custom JMX instrumentation
Custom JMX YAML examples
Troubleshooting Java custom instrumentation
Circuit breaker

API Guides

Java agent API guide
Java agent API annotation
API: Externals, messaging, frameworks
API: Annotating example app
API example: Datastore and CAT

Async Instrumentation

Async instrumentation
Java async API
Troubleshoot async
Disable async frameworks

Troubleshooting

No data appears
Determine permissions requirements
Gather troubleshooting information
All hosts appear as localhost
Error bootstrapping Java agent
Errors starting Java app server
Firewall or traffic connectivity failures
Generate logs for troubleshooting
Host links missing
Solr data does not appear
No Browser data appears
No log file
No stack traces
NullPointerException issues
Resolve metric grouping issues
SSL or connection errors
Update legacy Java config
Application server JMX setup

.NET Agent

Getting Started

New Relic for .NET
Compatibility and requirements (Core 2.0)
Compatibility and requirements (Framework)
.NET release notes
.NET agent established release
APM agent security: .NET

Installation

Install for Windows
Install Core agent for Linux
Install Core agent for Docker
Scriptable installer
Update the agent
Uninstall the .NET agent
Upgrade legacy agent

Additional Installation

Async support in .NET
Instrument non-IIS apps
Install WCF applications
Browser monitoring

Configuration

.NET agent configuration
Name your .NET application

Custom Instrumentation

Introduction to .NET custom instrumentation
Attribute custom instrumentation
XML to create transactions
XML to add detail

API Guides

.NET agent API guide

.NET Agent API

View all methods
AddCustomParameter
DisableBrowserMonitoring
GetBrowserTimingHeader
IgnoreApdex
IgnoreTransaction
IncrementCounter
NoticeError
RecordCustomEvent
RecordMetric
RecordResponseTimeMetric
SetApplicationName
SetTransactionName
SetTransactionUri
SetUserParameters
StartAgent

Attributes

.NET agent attributes
.NET attribute examples
Enable and disable attributes

Troubleshooting

No data appears
Support for Framework 4.0 or lower
Generate logs for troubleshooting
No Browser data appears
Profiler conflicts
Handled errors reported
No data and registry key permission issues
High memory usage
CoCreate errors: No event log
CoCreateInstance errors: No profiler log
Missing async metrics
Missing Couchbase metrics
Status monitor
Configure TLS protocol
Resolve .NET and SCOM conflicts

Azure Installation

Install Azure Marketplace app
Azure Cloud Services
Azure Web Apps

Azure Troubleshooting

Azure Cloud Services: No data appears
Azure Web Apps: No data appears
Azure Web Apps: Unable to open log file
Profiler .dll locks during deployment
.NET profiler conflict with Microsoft Application Insights

Node.js Agent

Getting Started

New Relic for Node.js
Compatibility and requirements
Node.js agent security
Node.js release notes

Installation and Configuration

Install the Node.js agent
Node.js agent configuration
Upgrade the Node.js agent
Uninstall the agent

Supported Features

Node.js custom instrumentation
Node.js custom metrics
Node.js VMs statistics page
Node.js VM measurements
Message queues
Browser monitoring
Node.js v1 custom instrumentation

Attributes

Node.js agent attributes

API Guides

Guide to Node.js agent API
Node.js agent API

Hosting Services

GAE flex
Install on Azure Web Apps
Node.js agent and Heroku

Troubleshooting

Troubleshoot your installation
Logs for troubleshooting
Troubleshoot message consumers
Troubleshoot Browser
Large memory usage

PHP Agent

Getting Started

New Relic for PHP
Compatibility and requirements
New Relic daemon processes
PHP agent security
PHP agent release notes

Installation

Installation overview
RedHat and CentOS
Ubuntu and Debian
Tar archive
Install agent on shared hosting service
Upgrade the agent

Advanced Installation

The newrelic-install script
Starting the PHP daemon
Silent mode newrelic-install script
Non-standard PHP
GAE flex
PHP agent and Heroku
Uninstall the agent

Configuration

PHP agent configuration
Per-Directory INI settings
Name your PHP app
Proxy daemon settings

API Guides

API guide

PHP Agent API

View all methods
newrelic_add_custom_parameter
newrelic_add_custom_tracer
newrelic_background_job
newrelic_capture_params
newrelic_custom_metric
newrelic_disable_autorum
newrelic_end_of_transaction
newrelic_end_transaction
newrelic_get_browser_timing_footer
newrelic_get_browser_timing_header
newrelic_ignore_apdex
newrelic_ignore_transaction
newrelic_name_transaction
newrelic_notice_error
newrelic_record_custom_event
newrelic_record_datastore_segment
newrelic_set_appname
newrelic_set_user_attributes
newrelic_start_transaction

Attributes

PHP agent attributes
Enabling and disabling attributes
Attribute examples

Features

Multiple accounts
Browser monitoring
PHP custom instrumentation
Recording deployments

Frameworks and Libraries

Integrating support for New Relic
Analyze PHPUnit test data in Insights
AWS Elastic Beanstalk installation
Drupal-specific functionality
Guzzle
Magento-specific functionality
Predis
WordPress-specific functionality

Troubleshooting

No data appears
Agent not reporting errors
Determine permissions requirements
Generating logs for troubleshooting
Data stops reporting while using SELinux
Agents stops after updating PHP
Checking loaded configuration files directory
Missing PHP module
Protocol mismatch error
INI settings not taking effect immediately
Submitting troubleshooting results
Threaded Apache worker MPMs
Transactions /index.php or /unknown
What the PHP instance count means
Uninstrumented time in traces
Using phpinfo to verify PHP
Verifying the PHP daemon
When to restart your web server
PHP Installation fails on El Capitan
Data stops reporting

Python Agent

Getting Started

New Relic for Python
Compatibility and requirements
Instrumented Python packages
Python agent security
Python release notes

Installation

Standard install
Advanced install
Advanced integration
Admin script: Advanced use
Upgrade the Python agent
Uninstall the Python agent

Configuration

Python agent configuration

Supported Features

Message queues
Custom metrics
Browser monitoring
Monitor scripts and functions
Tips and tricks
Cross application tracing
Browser and Django templates

Back-End Services

Celery back-end service

Custom Instrumentation

Custom instrumentation overview
Instrumentation via config file

API Guides

Guide to the API

Python Agent API

Web Frameworks/Servers

uWSGI
Gunicorn
mod_wsgi
Using trace decorators with Tornado coroutines
Tornado 4
Tornado 3
CherryPy
Web2Py
AJP
FastCGI
Paste
SCGI
Waitress

Hosting Services

GAE flex
Heroku hosting service
OpenShift hosting service
Stackato hosting service
WebFaction hosting service

Attributes

Python agent attributes
Enabling and disabling attributes
Attribute examples

Troubleshooting

No data appears
Troubleshooting Browser
Emulating legacy parameters
Python agent logging
Testing the Python agent

Ruby Agent

Getting Started

New Relic for Ruby
Requirements and supported frameworks
Ruby agent security
New Relic's Github repository
Ruby release notes

Installation

Ruby agent installation
Rails plugin installation
GAE flex
Ruby agent and Heroku
Update the agent
Uninstall the agent

Configuration

Ruby agent configuration
Custom SSL certificates

Features

Message queues
Recording deployments
HTTP client tracing in Ruby
Cross application tracing in Ruby
Ruby VM measurements
Garbage collection
Browser monitoring
Developer mode

API Guides

API guide
Ruby custom instrumentation
Ruby custom metrics
Ignoring specific transactions
Sending New Relic handled errors
Third party instrumentation

Instrumented Gems

Redis instrumentation
Mongo instrumentation
Rack and Metal support
Rack middlewares
Metal controller instrumentation
Sequel instrumentation
Sinatra instrumentation

Background Jobs

Resque instrumentation
Rake instrumentation
Sidekiq instrumentation
Monitor background processes
Delayed::Job instrumentation

Attributes

Enabling and disabling attributes
Ruby agent attributes
Attribute examples

Troubleshooting

No data appears
Generating logs
Incompatible gems
No log file
Control when the agent starts
SystemStackError: stack level too deep
Ruby agent audit log
Passenger troubleshooting
No data with Unicorn
Update deprecated API calls
Not installing Grape

Agent SDK

Getting Started

New Relic Agent SDK
Known limitations
Security considerations

Installation and Configuration

Installing the Agent SDK
Configuring logging
Instrumenting your code
Configuring the Agent SDK
Limiting or disabling settings

Using the Agent SDK

Using the Agent SDK

Miscellaneous

libjson license

Contents » APM Agents

NET Agent

Getting Started

Introduction to New Relic for .NET
Compatibility and requirements for the .NET Core 2.0 agent
Compatibility and requirements for the .NET Framework agent
.NET release notes
.NET agent established release
APM agent security: .NET

Installation

Install the .NET agent on Windows
Install the .NET Core 2.0 agent on Linux
Install the .NET Core 2.0 agent with Docker
Install the .NET agent using a scriptable installer
Update the .NET agent
Uninstall the .NET agent
Upgrade legacy .NET Framework agents

Additional Installation

Async support in .NET
Instrument non-IIS apps
Install WCF applications
New Relic Browser and the .NET agent

Configuration

.NET agent configuration
Name your .NET application

Custom Instrumentation

Introduction to .NET custom instrumentation
Custom instrumentation via attributes (.NET)
Create transactions via XML (.NET)
Add detail to transactions via XML (.NET)

API Guides

Guide to using the .NET agent API

NET Agent API

View all methods
AddCustomParameter (.NET agent API)
DisableBrowserMonitoring (.NET agent API)
GetBrowserTimingHeader (.NET agent API)
IgnoreApdex (.NET agent API)
IgnoreTransaction (.NET agent API)
IncrementCounter (.NET agent API)
NoticeError (.NET agent API)
RecordCustomEvent (.NET agent API)
RecordMetric (.NET agent API)
RecordResponseTimeMetric (.NET agent API)
SetApplicationName (.NET agent API)
SetTransactionName (.NET agent API)
SetTransactionUri (.NET agent API)
SetUserParameters (.NET agent)
StartAgent (.NET agent API)

Attributes

.NET agent attributes
.NET attribute examples
Enable and disable attributes (.NET)

Troubleshooting

No data appears (.NET)
Technical support for .NET Framework 4.0 or lower
Generate logs for troubleshooting (.NET)
No Browser data appears (.NET)
Profiler conflicts
.NET agent reports handled errors
No data and registry key permission issues
High memory usage (.NET)
CoCreate errors: No event log
CoCreateInstance errors: No profiler log
Missing .NET async metrics
Missing Couchbase metrics (.NET)
New Relic for .NET status monitor
Configure TLS protocol
Resolve .NET and SCOM conflicts

Azure Installation

Install Azure app with New Relic
Install app via Azure Cloud Services
Install the .NET agent on Azure Web Apps

Azure Troubleshooting

Azure Cloud Services: No data appears
Azure Web Apps: Using Always On and no data appears
Azure Web Apps: Unable to open log file
Azure Web Apps: Profiler .dll locks during deployment
.NET profiler conflict with Microsoft Application Insights