Blog
Support Center
Technical Community
NR University
NR Status
Skip to Navigation
↓
Contents
Agents
Manage APM Agents
Installation
Install the agent
Update the New Relic agent
Uninstall the agent
Compatibility and requirements for New Relic agents
App Naming
Name your application
Use multiple names for an app
Rename your application
Agent Data
Custom instrumentation
Agent attributes
Collect custom attributes
Collect custom events
Collect custom metrics
Manage errors in APM: Collect, ignore, and mark expected
Configuration
Configure the agent
High security mode
Add, rename, and remove hosts
Monitor background processes
Clean up your agent configuration file
Log (audit) all data your New Relic agent transmits
Maintenance
Agent established releases
Connect hosts to your account
New Relic agent and plugin end of life policy
Troubleshooting
Not seeing data
Metric grouping issues
Java Agent
Getting Started
Introduction to New Relic for Java
Compatibility and requirements for the Java agent
The Java agent and security
Java release notes
Java agent established releases
Installation
Install the Java agent
Include the Java agent with a JVM argument
Upgrade the Java agent
Uninstall the Java agent
Additional Installation
AWS Elastic Beanstalk installation for Java
Install New Relic Java agent in GAE flexible environment
Java agent self-installer
Java 2 security installation
Java SE 5.0 support
Maven installation for Java
Scala installation for Java
Heroku
Java agent and Heroku
Java agent with Scala on Heroku
No data appears with Heroku (Java)
Configuration
Java agent configuration: Config file
Java agent config file template
Hostname logic in Java
Automatic application naming
Java agent 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 (Java agent)
New Relic Browser and the Java agent
Browser best practices in Java
Java agent incubator
Ignore specific transactions
Custom Instrumentation
Java custom instrumentation
Custom Instrumentation Editor: Instrument from UI
Java instrumentation by XML
Java XML instrumentation examples
Custom JMX instrumentation by YAML
Custom JMX YAML examples
Troubleshooting Java custom instrumentation
Circuit breaker for Java custom instrumentation
Java Agent API
Introduction to Java agent API
Guide to using Java agent API
Java agent API: Instrument using annotation
Java agent API: Overview of instrumenting external calls, CAT, messaging, datastore, web frameworks
Java agent API: Custom instrumentation with annotation of an example app
Java agent API: Instrumenting example app for external datastore calls and CAT
Async Instrumentation
Introduction to Java async instrumentation
Java agent API for asynchronous applications
Troubleshoot Java asynchronous instrumentation
Disable Scala, Netty, Akka, and Play 2 Instrumentation
Troubleshooting
No data appears (Java)
All hosts appear as localhost (Java)
Generate debug logs for troubleshooting (Java)
Error starting app server (Java)
Resolve metric grouping issues in Java
No log file (Java)
No Browser data appears (Java)
NullPointerException issues (Java)
SOLR data not appearing in APM SOLR tab (Java)
SSL or connection errors (Java)
Missing stack trace: 500 errors (Java)
Stack traces missing (Java)
Traffic connectivity failure (Java)
Providing troubleshooting information (Java)
Set the hostname reported by the Java agent
Unexpected transaction traces (Java)
Update legacy attribute configuration (Java)
Miscellaneous
New Relic Java agent license
Go Agent
Get Started
Introduction to New Relic for Go
Go agent compatibility and requirements
Install New Relic for Go
Install New Relic Go agent in GAE flexible environment
Go agent Release Notes
Instrumentation
Instrument Go transactions
Instrument Go segments
Go agent configuration
Go agent attributes
Go agent logging
Uninstall the Go agent
Features
Go runtime page: Troubleshoot performance problems
Create custom events in Insights (Go)
Install New Relic Browser for Go apps
Troubleshooting
No data appears (Go)
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
Enable and disable 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
Nodejs Agent
Getting Started
Introduction to New Relic for Node.js
Compatibility and requirements for the Node.js agent
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 Node.js agent
Supported Features
Message queues
Node.js agent API
New Relic Browser and the Node.js agent
Node.js custom metrics
Node.js v1 custom instrumentation (legacy)
Node.js custom instrumentation
Node.js VMs statistics page
Node.js VM measurements
Hosting Services
Install New Relic Node.js agent in GAE flexible environment
Node.js agent on Microsoft Azure
Node.js agent and Heroku
Troubleshooting
Troubleshoot message consumers
Troubleshoot your Node.js installation
Troubleshooting large memory usage (Node.js)
Troubleshooting Browser instrumentation in Node.js
Generate trace log for troubleshooting (Node.js)
Emulating legacy server-side parameter configuration (Node.js)
PHP Agent
Getting Started
Introduction to New Relic for PHP
PHP agent compatibility and requirements
New Relic daemon processes
PHP agent release notes
Installation
PHP agent installation overview
PHP agent installation: RedHat and CentOS
PHP agent installation: Ubuntu and Debian
PHP agent installation: Tar file
Install PHP agent on shared hosting service
Upgrading the PHP agent
Advanced Installation
Using the newrelic-install script
Starting the PHP daemon (advanced)
Silent mode for the install script (advanced)
PHP agent installation: Non-standard PHP (advanced)
Install New Relic PHP agent in GAE flexible environment
PHP agent and Heroku
Uninstalling the PHP agent
Configuration
PHP agent configuration
PHP per-directory INI settings
Proxy daemon (newrelic.cfg) settings
PHP Agent API
View all methods
newrelic_add_custom_parameter (PHP agent API)
newrelic_add_custom_tracer (PHP agent API)
newrelic_background_job (PHP agent API)
newrelic_capture_params (PHP agent API)
newrelic_custom_metric (PHP agent API)
newrelic_disable_autorum (PHP agent API)
newrelic_end_of_transaction (PHP agent API)
newrelic_end_transaction (PHP agent API)
newrelic_get_browser_timing_footer (PHP agent API)
newrelic_get_browser_timing_header (PHP agent API)
newrelic_ignore_apdex (PHP agent API)
newrelic_ignore_transaction (PHP agent API)
newrelic_name_transaction (PHP agent API)
newrelic_notice_error (PHP agent API)
newrelic_record_custom_event (PHP agent API)
newrelic_set_appname (PHP agent API)
newrelic_set_user_attributes (PHP agent API)
newrelic_start_transaction (PHP agent API)
Attributes
PHP agent attributes
Enabling and disabling attributes
Attribute examples
Features
Multiple accounts
New Relic Browser and the PHP agent
PHP custom instrumentation
Recording deployments using a PHP script
Frameworks and Libraries
PHP frameworks: Integrating support for New Relic
Analyze PHPUnit test data in Insights
AWS Elastic Beanstalk installation for PHP
Drupal-specific functionality
Guzzle
Magento-specific functionality
Predis
WordPress-specific functionality
Troubleshooting
PHP agent not reporting errors
No data appears (PHP)
Determining permissions requirements
Generating logs for troubleshooting (PHP)
Data stops reporting while using SELinux
Agent stops working after updating PHP
Checking loaded configuration files directory
Checking PHP extensions
INI settings not taking effect immediately
PHP installation fails on OS X 10.11 - El Capitan
Protocol mismatch error
Submitting troubleshooting results (PHP)
Threaded Apache worker MPMs
Transactions named /index.php or /unknown
Troubleshoot the PHP agent instance count
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
Introduction to New Relic for Python
Compatibility and requirements for the Python agent
Python release notes
Instrumented Python packages
Installation
Standard Python agent install
Advanced install of New Relic Python agent
Python agent: Advanced integration
Python agent admin script: Advanced usage
Upgrade the Python agent
Uninstall the Python agent
Configuration
Python agent configuration
Supported Features
Python message queues
Python custom metrics
New Relic Browser and the Python agent
Monitor non-web scripts, worker processes, tasks, and functions
Python tips and tricks
Optional manual Browser instrumentation with Django templates
Back-End Services
Python agent and Celery
Custom Instrumentation
Python custom instrumentation
Python custom instrumentation via config file
API
Guide to using the Python agent API
Python Agent API
View all Python agent API calls
add_custom_parameter (Python agent API)
add_user_attribute (Python agent API)
application (Python agent API)
application_settings (Python agent API)
background_task (Python agent API)
callable_name (Python agent API)
capture_request_params (Python agent API)
current_transaction (Python agent API)
data_source_factory (Python agent API)
data_source_generator (Python agent API)
disable_browser_autorum (Python agent API)
end_of_transaction (Python agent API)
function_trace (Python agent API)
get_browser_timing_footer (Python agent API)
get_browser_timing_header (Python agent API)
global_settings (Python agent API)
ignore_transaction (Python agent API)
initialize (Python agent API)
message_trace (Python agent API)
message_transaction (Python agent API)
record_custom_event (Python agent API)
record_custom_metric (Python agent API)
record_custom_metrics (Python agent API)
record_exception (Python agent API)
register_application (Python agent API)
register_data_source (Python agent API)
set_background_task (Python agent API)
set_transaction_name (Python agent API)
shutdown_agent (Python agent API)
suppress_apdex_metric (Python agent API)
suppress_transaction_trace (Python agent API)
wsgi_application (Python agent API)
Web Frameworks and Servers
Python agent and uWSGI web server
Python agent and Gunicorn WSGI web server
Python agent and mod_wsgi web server
Python agent and Tornado 4 framework
Python agent and Tornado 3 web framework
Python agent and CherryPy web framework
Python agent and Web2py web framework
Python agent and AJP WSGI server
Python agent and FastCGI web server
Python agent and Paste
Python agent and SCGI web server
Python agent and Waitress web server
Hosting Services
Install New Relic Python agent in GAE flexible environment
Python agent and Heroku
Python agent and OpenShift
Python agent and Stackato
Python agent and WebFaction
Attributes
Python agent attributes
Enabling and disabling attributes (Python)
Python attribute examples
Troubleshooting
No data appears (Python)
Testing the Python agent
Python agent logging
Troubleshooting Browser instrumentation in Python
Emulating legacy server-side parameter configuration (Python)
Ruby Agent
Getting Started
Introduction to New Relic for Ruby
Ruby agent requirements and supported frameworks
New Relic's Github repository
Ruby release notes
Installation
Install the New Relic Ruby agent
Ruby agent installation: Rails plugin
Install New Relic Ruby agent in GAE flexible environment
Ruby agent and Heroku
Upgrade Ruby agent versions
Uninstall the Ruby agent
Configuration
Ruby agent configuration
Custom SSL certificates (Ruby)
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 with the Ruby agent
HTTP client tracing in Ruby
Cross application tracing in Ruby
Ruby VM measurements
Garbage collection
New Relic Browser and the Ruby agent
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 Ruby background processes
Delayed::Job instrumentation
Attributes
Enabling and disabling attributes (Ruby)
Ruby agent attributes
Ruby attribute examples
Troubleshooting
No data appears (Ruby)
Controlling when the Ruby agent starts
Emulating legacy server-side parameter configuration (Ruby)
Generating logs for troubleshooting (Ruby)
Incompatible gems
No data with Unicorn
Ruby agent audit log
No log file (Ruby)
Passenger troubleshooting
Agent SDK
Getting Started
Introduction to the New Relic Agent SDK
Known limitations with the New Relic Agent SDK
Security considerations with the Agent SDK
Installation and Configuration
Installing the Agent SDK
Configuring Agent SDK logging
Instrumenting your code with the Agent SDK
Configuring the Agent SDK
Limiting or disabling Agent SDK settings
Using the Agent SDK
Using the Agent SDK
Miscellaneous
libjson license