View APM errors and error traces (legacy)

Legacy

On December 1, 2015, New Relic released a new Error analytics page in APM for customers using the most recent agent versions for Java, Node.js, PHP, Python, and Ruby. Error analytics support was added to the .NET agent in March of 2017.

This document is for the legacy Errors page. This page will be retired in favor of the Error analytics experience in the future.

New Relic APM's Errors page shows a chart with the error rate percentage for the selected time period. It also shows a list of error messages. You can view and drill down details, use search and sort options, hide or delete the error, share it with others, or file a ticket about it.

The Errors chart also appears on the selected app's Overview page. If the chart shows errors, you can select its Error rate title to go directly to this Errors page.


[video link] To learn about using transaction traces and traced errors to troubleshoot your app, watch this video (approximately 16 minutes).

View the Errors page

screen-errors-dashboard.png
APM > (selected app) > Events > Errors: Here is an example of the Errors page and message details for the selected error.

To view, use search options, or delete errors:

  1. Go to rpm.newrelic.com/apm > (select an app) > Events > Errors.
  2. Use any of New Relic's standard user interface functions to drill down into detailed information.
  3. To view an error message's details, select its Message link.

From here you can:

New Relic agents only report a sample of error messages. This is why the number of error messages listed may not equal the total error count in the tooltip that appears when you mouse over the Error rate chart.

Error trace details

Here is a summary of the data available in the Error trace detail page. The labels on the example page are used to identify the data available.

Label Explanation
Time The time at which the error occurred.
Instance

The instance of the application on which the error was reported. Format:

Server name (application name)

Count The number of times this error message was encountered during the selected time range.
Similar errors to this The number shown here plus the COUNT is the total number of times this error occurred during the time range indicated. The arrows allow you change the time range.
Error message The text of the error message selected. It is reproduced at the top of the trace detail page.
Sample stack trace The trace back resulting from the error.

Disable error traces

If there are errors you do not want reporting to New Relic, disable them in the configuration file for your agent. For most agents, you can ignore certain error codes or disable errors completely. For more information, see your specific agent configuration documentation.

Delete error traces

You cannot recover error traces after you delete them.

If you want to... Do this...
Delete individual error traces

To delete an individual error trace:

  1. Go to rpm.newrelic.com/apm > (select an app) > Events > Errors.
  2. Select the error message.
  3. Select Delete this error.
Delete all error traces for your app

Owner or Admins

To delete all error traces for the selected app:

  1. Go to rpm.newrelic.com/apm > (select an app) > Events > Errors
  2. Select Delete all errors.
Delete all error traces for your account To delete all error traces for your New Relic account, get support at support.newrelic.com.

If you are doing general record cleanup, you may also want to delete transaction traces or database queries. This will remove potentially sensitive data while retaining your other application data (such as Apdex, deployment information, etc.).

For more help

Recommendations for learning more: