Introduction to error analytics

The New Relic APM Error analytics feature gives you useful tools to analyze and resolve errors being reported by your applications. For example, DevOps teams can:

  • Assess the health of your applications with fine-grained data on error events over the past eight days.
  • Select which parameters to use to group and show error information in the UI; for example, error class, error message, host, transaction name, etc.
  • Drill down into stack trace details to diagnose and resolve specific errors.
  • Identify continuing trends in error rates for periods longer than eight days.

The Error analytics feature automatically groups errors by their class so you can immediately see where to focus your attention. You can also apply filters and use the Group by function to help pinpoint the underlying problems or patterns according to criteria most important to you.

You can also use links in the Error analytics UI to share error data through New Relic Insights dashboards or through your organization's ticketing system. Sharing actionable data will allow you to coordinate your resources and resolve errors more quickly.

Access to this feature depends on your subscription level.

View options

Depending on your account level, New Relic agent, and time window, New Relic APM's Error analytics page provides two different data views with different data retention periods. Both views include error traces.

Data view Comments
Error events

The comprehensive error events view is available for New Relic agents with the supported agent version for time periods within the past eight days.

Access to this feature depends on your subscription level.

Error metrics

New Relic APM provides the basic error metrics view to:

  • All account types
  • Any time period that falls outside or extends beyond the past eight days
  • Every New Relic agent that does not support error events
New Relic APM: Error analytics
APM > Applications > (selected app) > Events > Error analytics: Here is an example of the error events view, grouping by transactions and filtering to a specific transaction name. Both the error events and error metrics views include error traces.

The Error analytics events view includes these features:

Error analytics UI Features
Error rate chart The first chart, Error rate, shows the overall error rate to provide context.
Top 5 errors chart

The second chart, Top 5 errors, shows error counts. Error counts reflect the totals for the selected group based on the current filters.

By default, these are grouped by error class, but you can change the grouping option by selecting Back to groupings list.

Error traces table The Error traces table includes links to individual traces with additional details. When grouping by error class and filtering by transaction name, the counts match those listed in the Error traces table.
Error frequency heatmap The Error frequency heatmap uses shades of color to help you immediately see increasing severity levels of problems in time blocks.

Event and metric view compatibility

The ability to view error events, error metrics, and detailed error traces from the Error analytics page depends on your New Relic agent version. However, regardless of which agent version you have, you still have the ability to view error rate and error trace information from New Relic APM's legacy Errors page.

Agent version Error analytics events view Error analytics metrics view
Go 1.0 or higher [check icon] [check icon]
Java 3.21.0 or higher [check icon] [check icon]
.NET 3.1.65 or higher [check icon]
.NET 6.8.xx or higher [check icon] [check icon]
Node.js 1.24.0 or higher [check icon] [check icon]
PHP 5.1.1.130 or higher [check icon] [check icon]
Python 2.58.0.43 or higher [check icon] [check icon]
Ruby 3.14.0.305 or higher [check icon] [check icon]

For more help

Additional documentation resources include:

Join the discussion about New Relic APM in the New Relic Online Technical Community! The Technical Community is a public platform to discuss and troubleshoot your New Relic toolset.

If you need additional help, get support at support.newrelic.com.