Home
  • Blog
  • Support Center
  • Explorer's Hub
  • NR University
  • NR Status

Skip to Navigation ↓

Manage APM Agents

plus icon

Installation

  • Compatibility and requirements
  • Install the agent
  • Update the agent
  • Disable APM agent
  • Uninstall the agent
plus icon

App Naming

  • Name your application
  • Use multiple names for an app
plus icon

Agent Data

  • Custom instrumentation
  • Agent attributes
  • Custom attributes
  • Custom events
  • Custom metrics
  • Manage errors
plus icon

Configuration

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

Maintenance

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

Troubleshooting

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

Go Agent

plus icon

Get Started

  • New Relic for Go
  • Compatibility and requirements
  • Go agent security
  • Go agent release notes
plus icon

Installation

  • Install New Relic for Go
  • Install in GAE flex
  • Uninstall the Go agent
plus icon

Configuration

  • Go configuration
  • Go agent logging
plus icon

Instrumentation

  • Instrument Go transactions
  • Instrument Go segments
  • Go agent attributes
  • Create custom metrics in Go
plus icon

API Guides

  • Go agent API guide
plus icon

Features

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

Troubleshooting

  • No data appears

Java Agent

plus icon

Getting Started

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

Installation

  • Install the Java agent
  • Include agent with JVM
  • Upgrade the Java agent
  • Uninstall the Java agent
plus icon

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
plus icon

Heroku

  • Java agent and Heroku
  • Scala and Heroku
  • No data appears (Heroku)
plus icon

Configuration

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

Attributes

  • Java agent attributes
plus icon

Features

  • JVM metrics page
plus icon

Instrumentation

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

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
plus icon

API Guides

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

Async Instrumentation

  • Async instrumentation
  • Java async API
  • Troubleshoot async
  • Disable async frameworks
plus icon

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

plus icon

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
plus icon

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
plus icon

Additional Installation

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

Configuration

  • .NET agent configuration
  • Name your .NET application
plus icon

Custom Instrumentation

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

API Guides

  • .NET agent API guide
plus icon

.NET Agent API

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

Attributes

  • .NET agent attributes
  • .NET attribute examples
  • Enable and disable attributes
plus icon

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
plus icon

Azure Installation

  • Install Azure Marketplace app
  • Azure Cloud Services
  • Azure Web Apps
plus icon

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

plus icon

Getting Started

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

Installation and Configuration

  • Install the Node.js agent
  • Node.js agent configuration
  • Upgrade the Node.js agent
  • Uninstall the agent
plus icon

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
plus icon

Attributes

  • Node.js agent attributes
plus icon

API Guides

  • Guide to Node.js agent API
  • Node.js agent API
plus icon

Hosting Services

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

Troubleshooting

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

PHP Agent

plus icon

Getting Started

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

Installation

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

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
plus icon

Configuration

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

API Guides

  • API guide
plus icon

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
plus icon

Attributes

  • PHP agent attributes
  • Enabling and disabling attributes
  • Attribute examples
plus icon

Features

  • Multiple accounts
  • Browser monitoring
  • PHP custom instrumentation
  • Recording deployments
plus icon

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
plus icon

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

plus icon

Getting Started

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

Installation

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

Configuration

  • Python agent configuration
plus icon

Supported Features

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

Back-End Services

  • Celery back-end service
plus icon

Custom Instrumentation

  • Custom instrumentation overview
  • Instrumentation via config file
plus icon

API Guides

  • Guide to the API
plus icon

Python Agent API

  • View all calls
  • add_custom_parameter
  • add_user_attribute
  • application
  • application_settings
  • background_task
  • callable_name
  • capture_request_params
  • current_transaction
  • datastore_trace
  • data_source_factory
  • data_source_generator
  • disable_browser_autorum
  • end_of_transaction
  • external_trace
  • function_trace
  • get_browser_timing_footer
  • get_browser_timing_header
  • global_settings
  • ignore_transaction
  • initialize
  • message_trace
  • message_transaction
  • record_custom_event
  • record_custom_metrics
  • record_custom_metric
  • record_exception
  • register_application
  • register_data_source
  • set_background_task
  • set_transaction_name
  • shutdown_agent
  • suppress_apdex_metric
  • suppress_transaction_trace
  • wsgi_application
plus icon

Web Frameworks/Servers

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

Hosting Services

  • GAE flex
  • Heroku hosting service
  • OpenShift hosting service
  • Stackato hosting service
  • WebFaction hosting service
plus icon

Attributes

  • Python agent attributes
  • Enabling and disabling attributes
  • Attribute examples
plus icon

Troubleshooting

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

Ruby Agent

plus icon

Getting Started

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

Installation

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

Configuration

  • Ruby agent configuration
  • Custom SSL certificates
plus icon

Features

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

API Guides

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

Instrumented Gems

  • Redis instrumentation
  • Mongo instrumentation
  • Rack and Metal support
  • Rack middlewares
  • Metal controller instrumentation
  • Sequel instrumentation
  • Sinatra instrumentation
plus icon

Background Jobs

  • Resque instrumentation
  • Rake instrumentation
  • Sidekiq instrumentation
  • Monitor background processes
  • Delayed::Job instrumentation
plus icon

Attributes

  • Enabling and disabling attributes
  • Ruby agent attributes
  • Attribute examples
plus icon

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

plus icon

Getting Started

  • New Relic Agent SDK
  • Known limitations
  • Security considerations
plus icon

Installation and Configuration

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

Using the Agent SDK

  • Using the Agent SDK
plus icon

Miscellaneous

  • libjson license
Contents » APM Agents

Manage APM Agents

Installation

  • Compatibility and requirements for New Relic agents and products
  • Install the agent
  • Update the New Relic agent
  • Disable the APM agent
  • Uninstall the agent

App Naming

  • Name your application
  • Use multiple names for an app

Agent Data

  • Custom instrumentation
  • Agent attributes
  • Collect custom attributes
  • Collect custom events
  • Collect custom metrics
  • Manage errors in APM: Collect, ignore, or mark expected

Configuration

  • Server-side agent configuration
  • Configure the agent
  • High security mode
  • Add, rename, and remove hosts
  • Monitor background processes
  • 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

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