Getting started
Agents
Manage APM agents
Agent data
- Real time streaming
- Custom instrumentation
- Agent attributes
- Custom events
- Custom metrics
- Manage errors
- Link Kubernetes
App naming
Configuration
- Server-side configuration
- View config values for your app
- High security mode
- Configurable security policies
- Add, rename, and remove hosts
- Monitor background processes
Troubleshooting
C SDK
Get started
- Introduction to the C SDK
- Compatibility and requirements
- C SDK security
- Latest release
- C SDK release notes
Install and configure
- Install (compile) the C SDK
- Docker and other containers
- C SDK configuration
- Update your C SDK library
- Uninstall (remove) the C SDK
Instrumentation
- Instrument your app
- Instrument transactions
- Instrument errors
- Enable distributed tracing for your C applications
- Guide to using the C SDK API
- Use default or custom attributes
Troubleshooting
Go
Get started
Installation
Configuration
Instrumentation
- Instrument Go transactions
- Instrument Go segments
- Custom events
- Go agent attributes
- Create custom metrics in Go
API guides
Features
- Go runtime UI page
- Custom events
- Add browser monitoring
- Distributed tracing
- Cross application tracing
- Trace asynchronous applications
Troubleshooting
Java
Getting started
Installation
Additional installation
- Docker
- AWS Elastic Beanstalk
- Ansible
- WildFly installation
- GAE flex
- WebSphere App Server
- Java 2 security installation
- Maven install
- Gradle installation
Heroku
Configuration
- Java agent configuration
- Name your Java application
- Java agent config file template
- Hostname logic
- Distributed tracing
- Automatic application naming
- Error configuration
- Configuring your SSL certificates
Features
Instrumentation
- Transaction naming protocol
- Monitor deployments
- Instrument webpages via API
- Browser best practices
- Instrument Kafka message queues
- Use RabbitMQ or JMS for message queues
- Instrumentation modules
- Ignore transactions
Custom instrumentation
- Java custom instrumentation
- Custom instrumentation editor
- Scala instrumentation
- Java instrumentation by XML
- XML instrumentation example
- Custom JMX instrumentation
- Custom JMX YAML examples
- Troubleshooting Java custom instrumentation
- Circuit breaker
- Messaging framework instrumentation
Async instrumentation
Attributes
API guides
- Java agent API guide
- Java agent API annotation
- API: Externals, messaging, frameworks
- API: Annotating example app
- API example: Datastore and CAT
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
- Large number of false positive security vulnerabilities
.NET
Getting started
- New Relic for .NET
- Compatibility and requirements (Framework)
- Compatibility and requirements (Core)
- APM agent security: .NET
- Latest release
- .NET release notes
- .NET agent 8.x to 9.x migration guide
Installation
Azure installation
Other installation
- ASP.NET Core
- Install with NuGet
- Install for Docker
- Install for WCF
- Install resources (advanced)
- How to verify the checksum of .NET Agent downloads
Configuration
Other features
Custom instrumentation
- Introduction to .NET custom instrumentation
- Attribute custom instrumentation
- XML to create transactions
- XML to add detail
API guides
NET agent API
- View all methods
- DisableBrowserMonitoring
- GetAgent
- GetBrowserTimingHeader
- GetLinkingMetadata
- IAgent
- ITransaction
- ISpan
- IgnoreApdex
- IgnoreTransaction
- NoticeError
- IncrementCounter
- RecordCustomEvent
- RecordMetric
- RecordResponseTimeMetric
- SetApplicationName
- SetTransactionName
- SetTransactionUri
- SetUserParameters
- StartAgent
- TraceMetadata
Attributes
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
- No data with Microsoft App Insights
Troubleshooting
- No data appears
- Azure Pipelines wipes out NewRelic.Azure.WebSites.Extension directories
- Generate logs for troubleshooting
- Agent changes Content-Type header for WCF apps
- Support for Framework 4.0 or lower
- Debugging the .NET Core Agent on Linux
- No Browser data appears
- Profiler conflicts
- Handled errors reported
- No data and registry key permission issues
- High memory usage
- Browser injection: Health check conflict
- CoCreate errors: No event log
- CoCreateInstance errors: No profiler log
- Missing async metrics
- Missing Couchbase metrics
- Status monitor
- Monitor short-lived processes
- No data after disabling TLS 1.0
- Resolve .NET and SCOM conflicts
- No stack traces
Node.js
Getting started
- New Relic for Node.js
- Compatibility and requirements
- Node.js agent security
- Latest release
- Node.js release notes
Installation and configuration
- Install the Node.js agent
- Install Node.js agent for Docker
- Node.js agent configuration
- Update the Node.js agent
- Uninstall the agent
Extend your instrumentation
- Node.js custom instrumentation
- Node.js custom metrics
- Apollo Server plugin
- Node.js VMs statistics page
- Distributed tracing
- Message queues
- Browser monitoring
- Node.js VM measurements
- Node.js v1 custom instrumentation
Attributes
API guides
Hosting services
Troubleshooting
- Troubleshoot your installation
- Logs for troubleshooting
- Troubleshoot message consumers
- Large memory usage
- Troubleshoot Browser
PHP
Getting started
- New Relic for PHP
- Compatibility and requirements
- New Relic daemon processes
- PHP agent security
- Latest release
- PHP agent release notes
Installation
- Installation overview
- AWS Linux, RedHat, CentOS
- Ubuntu and Debian
- Tar archive
- Install agent on shared hosting service
- Update the PHP agent
Advanced installation
- newrelic-install script
- Docker or other containers with PHP
- Starting the PHP daemon
- Silent mode newrelic-install script
- Non-standard PHP
- PHP agent and Heroku
- Uninstall the agent
Configuration
API guides
PHP agent API
- View all methods
- newrelic_accept_distributed_trace_headers
- newrelic_accept_distributed_trace_payload
- newrelic_accept_distributed_trace_payload_httpsafe
- newrelic_add_custom_parameter
- newrelic_add_custom_span_parameter
- newrelic_add_custom_tracer
- newrelic_background_job
- newrelic_capture_params
- newrelic_create_distributed_trace_payload
- newrelic_custom_metric
- newrelic_disable_autorum
- newrelic_end_of_transaction
- newrelic_end_transaction
- newrelic_get_browser_timing_footer
- newrelic_get_browser_timing_header
- newrelic_get_linking_metadata
- newrelic_get_trace_metadata
- newrelic_ignore_apdex
- newrelic_ignore_transaction
- newrelic_insert_distributed_trace_headers
- newrelic_is_sampled
- 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
Features
- Multiple accounts
- Distributed tracing
- Browser monitoring
- PHP custom instrumentation
- Recording deployments
Frameworks and libraries
- Integrate support for New Relic
- Analyze PHPUnit test data in New Relic
- AWS Elastic Beanstalk installation
- Drupal-specific functionality
- Guzzle
- Magento-specific functionality
- Predis library
- 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
- First transaction not reported
Python
Getting started
- New Relic for Python
- Compatibility and requirements
- Instrumented Python packages
- Python agent security
- Latest release
- Python release notes
Installation
- Standard install
- Advanced install
- Install the Python agent for Docker
- Advanced integration
- Update the Python agent
- Admin script: Advanced use
- Uninstall the Python agent
Supported features
- Custom metrics
- Runtime metrics
- Message queues
- Event loop diagnostics
- Browser monitoring
- Monitor scripts and functions
- Tips and tricks
- Cross application tracing
- Browser and Django templates
- Python and GraphQL
Back-end services
API guides
Python agent API
- Python agent API different call forms
- View all calls
- add_custom_parameter
- add_custom_parameters
- add_custom_span_attribute
- application
- application_settings
- background_task
- web_transaction
- callable_name
- capture_request_params
- current_transaction
- create_distributed_trace_payload
- accept_distributed_trace_payload
- insert_distributed_trace_headers
- accept_distributed_trace_headers
- 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
- get_linking_metadata
- global_settings
- ignore_transaction
- initialize
- message_trace
- message_transaction
- notice_error
- record_custom_event
- record_custom_metric
- record_custom_metrics
- register_application
- register_data_source
- set_background_task
- set_transaction_name
- shutdown_agent
- suppress_apdex_metric
- suppress_transaction_trace
- wsgi_application
- asgi_application
Web frameworks and servers
Hosting services
- GAE flex
- Heroku hosting service
- OpenShift hosting service
- Stackato hosting service
- WebFaction hosting service
Attributes
Troubleshooting
- No data appears
- Troubleshooting Browser
- Emulating legacy parameters
- Testing the Python agent
- Python agent logging
- Missing information when using ensure_future
- Activate application warning
Configuration
Custom instrumentation
Async instrumentation
Ruby
Getting started
- New Relic for Ruby
- Requirements and supported frameworks
- Ruby agent security
- New Relic's GitHub repository
- Latest release
- Ruby release notes
- Ruby agent 7x migration guide
- Ruby agent 8x migration guide
Installation
- Ruby agent installation
- Rails plugin installation
- GAE flex
- Ruby agent and Heroku
- Update Ruby agent
- Uninstall Ruby agent
Configuration
Features
- Record deployments
- Message queues
- Ruby HTTP client tracing
- Ruby cross application tracing
- Ruby VM measurements
- Garbage collection
- Browser monitoring
- Developer mode
API guides
- Ruby custom instrumentation
- API guide
- Ruby custom metrics
- Ignoring specific transactions
- Reporting handled errors
- Third party instrumentation
Background jobs
- Resque instrumentation
- Sidekiq instrumentation
- Rake instrumentation
- Monitor background processes
- Delayed::Job instrumentation
Attributes
Instrumented gems
- Redis instrumentation
- Mongo instrumentation
- Rack and Metal support
- Rack middlewares
- Metal controller instrumentation
- Sequel instrumentation
- Sinatra instrumentation
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
- Update private API calls to public Tracer API
- Not installing Grape
APM UI pages
Monitoring
- APM Summary page
- Response time chart types (APM and browser)
- Distributed tracing page
- Transactions page
- Databases page
- View slow query details
- External services page
- APM data in Infrastructure
- View your applications index
- Agent-specific UI
Features
- Analyze database issues
- Tracking front-end time
- Request queue configuration
- Request queue config examples
- Ticketing integrations
Events
Error analytics
Errors inbox
Transactions
Intro to transactions
Transaction traces
- Introduction to transaction traces
- Configure transaction traces
- Summary page
- Trace details page
- Database queries page
- Security options
- Not seeing transaction traces
Key transactions
- Introduction to key transactions
- Charts and data
- Create and update
- Tag key transactions
- Key transaction alerts
Cross application traces
Reports
Service level agreements
Other performance analysis
- Background jobs analysis report
- Capacity analysis report
- Database analysis report
- Scalability analysis report
- Web transactions analysis report
- Weekly performance report
Guides
Apdex
Troubleshooting
- CPU usage mismatch
- Missing charts
- Event limits and sampling (APM, mobile)
- Errors while using other APM software