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.

Access to this feature depends on your subscription level.

Analyze and share errors

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.

View options

To get a high-level overview of all your applications and services, use the entity explorer in New Relic One.

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 > (select an 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. For more information, search your APM language agent's release notes. 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.

What the New Relic agent defines as an error will depend on the agent. For example, HTTP errors are unhandled exceptions thrown by the application and are not related to HTTP error code. In most cases, the HTTP errors are neither sent nor received by the application. Instead, HTTP errors typically will match a 400 or 500 error response.

For more help

Recommendations for learning more: