Blog
Support Center
Technical Community
NR University
NR Status

Skip to Navigation ↓

Manage APM Agents

Installation

Install the agent
Update the agent
Uninstall the agent

App Naming

Name your application
Use multiple names for an app
Rename your application

Agent Data

GAE Flex support
Custom instrumentation
Agent attributes
Custom attributes
Custom events
Custom metrics

Configuration

Configure the agent
High security mode
Add, rename, and remove hosts
Monitoring background processes
Clean your config file
Audit all data transmitted

Maintenance

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

Troubleshooting

Not seeing data
Metric grouping issues

Go Agent

Get Started

New Relic for Go
Install New Relic for Go
GAE Flex
Go agent Release Notes

Instrumentation

Instrument Go transactions
Instrument Go segments
Go configuration
Go agent attributes
Go agent logging
Uninstall the Go agent

Features

Go runtime UI page
Custom events

Troubleshooting

No data appears

Java Agent

Getting Started

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

Installation

Install the Java agent
Include the agent
Upgrade the Java agent
Uninstall the Java agent

Additional Installation

AWS Elastic Beanstalk
GAE Flex
Java agent self-installer
Java 2 security installation
Java SE 5.0 support
Maven installation
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

Java Agent API

Intro to Java agent API
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
All hosts appear as localhost
Generate logs for troubleshooting
Error starting app server
Resolve metric grouping issues in Java
No log file
No Browser data appears
NullPointerException issues
SOLR data missing
SSL or connection errors
Stack traces missing
Traffic connectivity failure
Providing troubleshooting data
Set the Java agent hostname
Unexpected transaction traces
Legacy attribute config

Miscellaneous

New Relic Java agent license

.NET Agent

Getting Started

New Relic for .NET
Compatibility and requirements
.NET release notes
.NET agent established release

Installation

Install the .NET agent
Scriptable Installer
Upgrade the .NET agent
Upgrading legacy agents
Uninstall the .NET agent

Configuration

.NET agent configuration
Name your .NET application

Azure Installation

Create New Relic account in Azure Portal
Azure App Services
Azure Classic Portal Web Apps
.NET Worker Role on Azure Cloud Service
Installing the .NET agent on Azure
Azure Cloud Services

.NET Agent API

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

Instrumentation

.NET custom transactions
.NET custom instrumentation
Instrument non-IIS apps
WCF application installation

Instrumentation Features

Async support in .NET
Browser monitoring

Troubleshooting

No data appears
No data and registry key permissions
Profiler conflicts
Resolve SCOM conflicts
Generate logs for troubleshooting
High memory usage with the .NET agent
CoCreateInstance errors
.NET agent reports handled errors
No event log: CoCreate errors
No Browser data appears
Missing async metrics
Status monitor

Attributes

.NET agent attributes
.NET attribute examples
Enabling and disabling attributes

Azure Troubleshooting

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

Node.js Agent

Getting Started

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

Installation and Configuration

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

Supported Features

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

Hosting Services

GAE Flex
Node.js agent on Microsoft Azure
Node.js agent and Heroku

Troubleshooting

Troubleshoot message consumers
Troubleshooting your installation
Large memory usage
Troubleshooting Browser
Logs for troubleshooting
Emulating legacy parameters

PHP Agent

Getting Started

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

Installation

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

Advanced Installation

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

Configuration

PHP agent configuration
PHP per-directory INI settings
Proxy daemon settings

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_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

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

Python Agent

Getting Started

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

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
Browser and Django templates

Back-End Services

Celery back-end service

Custom Instrumentation

Custom instrumentation overview
Instrumentation via API
Instrumentation via config file

API

API overview
Management API
Transaction API
Custom metrics API

Python Messaging API

message_trace
MessageTrace
MessageTraceWrapper
message_transaction
MessageTransaction
MessageTransactionWrapper
wrap_message_trace
wrap_message_transaction

Web Frameworks/Servers

uWSGI
Gunicorn
mod_wsgi
Tornado 4
Tornado 3
CherryPy
Web2Py
AJP
FastCGI
Paste
SCGI
Waitress

Hosting Services

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
Testing the Python agent
Python agent logging
Troubleshooting Browser
Emulating legacy parameters

Ruby Agent

Getting Started

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

Installation

Ruby agent installation
Rails plugin installation
GAE Flex
Ruby agent and Heroku
Upgrade Ruby agent versions
Uninstall the agent

Configuration

Ruby agent configuration
Custom SSL certificates

Customization

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

Features

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

Instrumented Gems

Redis instrumentation
Grape 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
Controlling when the agent starts
Emulating legacy parameters
Generating logs
Incompatible gems
No data with Unicorn
Ruby agent audit log
No log file
Passenger troubleshooting

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 agent
.NET release notes
.NET agent established release

Installation

Install the .NET agent
Scriptable Installer
Upgrade the .NET agent
Upgrade legacy .NET agents
Uninstall the .NET agent

Configuration

.NET agent configuration
Name your .NET application

Azure Installation

Create a New Relic account in Azure Portal
Azure App Services
Azure Classic Portal Web Apps
Instrument a .NET Worker Role on Azure Cloud Service
Installing the .NET agent on Azure
Azure Cloud Services

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)
SetUserParameters (.NET agent)
StartAgent (.NET agent API)

Instrumentation

.NET custom transactions
.NET custom instrumentation
Instrument non-IIS apps
WCF application installation

Instrumentation Features

Async support in .NET
New Relic Browser and the .NET agent

Attributes

.NET agent attributes
.NET attribute examples
Enabling and disabling attributes (.NET)

Troubleshooting

No data appears (.NET)
No data and registry key permission issues
Profiler conflicts
Resolve .NET and SCOM conflicts
Generate logs for troubleshooting (.NET)
High memory usage with the .NET agent
CoCreateInstance errors in Windows application event logs (.NET)
.NET agent reports handled errors
No event log: CoCreate errors (.NET)
No Browser data appears (.NET)
Missing async metrics
New Relic for .NET status monitor

Azure Troubleshooting

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