Introduction to New Relic Insights

New Relic Insights is a software analytics resource to gather and visualize data about your software and what that data says about your business.

You can also track your Insights data with the New Relic Insights mobile app for iPhone, Android, and Apple TV.


New Relic Insights builds on New Relic APM (application performance monitoring) and extends it to include user behavior, business transactions, customer insights, and more. While New Relic APM helps people optimize their apps, Insights helps people optimize their bottom line. It is a software analytics resource to help everyone from C-level executives to front-end developers make better decisions and build better products.

Using the Insights interface, you can quickly and easily build dashboards to identify problems with your apps and hosts in real-time or to track ongoing data trends.

New Relic Insights contains four main components:

For a library of videos about basic concepts and advanced procedures to use New Relic Insights, visit

Event types and attributes

Insights collects events from a variety of New Relic products:

An event has a type, a timestamp, and an arbitrary number of key-value attributes. You decorate your events with custom attributes to better understand your customers, your app, and your business. You can also add any timestamped key-value data you want as arbitrary custom events for page views, host transactions, or anything that can report online. Use the event data explorer to search for and understand your event data.

Metric data

Use the metric data explorer to search and chart any metric timeslice data sent via New Relic agents, including custom metrics. Add metric widgets to an Insights dashboard to monitor the data that's most interesting to you or another team in a centralized place, alongside any event/NRQL-based widgets.

Send custom data to Insights

Adding a high number of custom attributes and events may cause degraded query performance and run up against insertion rate limits for events. For optimal performance, first think about what data you want to analyze, and then create only the custom attributes required for the events.

Source How to send custom data
APM agent Use agent API to send custom events and custom attributes
Browser agent

Add custom attributes to the PageView event via the Browser API call addCustomAttribute. Send PageAction event and attributes via Browser API.

Forward APM agent custom attributes to PageView event.

Insights REST API Insert custom events and custom attributes with the Insights REST API.
Infrastructure Collect and display data about Infrastructure attributes and events for your systems, processes, events, storage, network, and Amazon Elastic Compute Cloud (EC2) integration, or add your own custom attributes.
Mobile agent Use the mobile agent API to send custom events and custom attributes

Compatibility and requirements

Ensure your New Relic APM agent meets the minimum compatible version for Insights:

  • Go: 1.0.0 or higher
  • Java: 3.4.0 or higher
  • .NET: or higher
  • Node.js: 1.6.0 or higher
  • PHP: or higher
  • Python: or higher
  • Ruby: or higher

New Relic recommends always using the latest agent version. Older versions will lack the functionality available in the most recent version. For update instructions, see Update the New Relic agent.

For more help

For assistance with New Relic Insights, join us in the New Relic Online Technical Community. Ask and answer questions, and learn more about New Relic Insights from fellow Insights users.

If you need additional help, get support at