• /
  • Log in
  • Free account

Manage errors in APM: Collect, ignore, or mark as expected

APM agents automatically report error data for supported frameworks. To optimize error reporting and alerting, you can further manage errors in order to:

  • Catch errors that we don't instrument by default.
  • Ignore errors that you don't want reported at all.
  • Filter out noise from expected errors so you can focus on the errors that are affecting performance. (Java, Ruby, Node, Python, and .NET agents only)

Collect errors not instrumented by default

APM agents include API calls to report (or "notice") errors. These are useful when APM doesn't instrument your framework automatically or when there are particular errors that aren't caught for your supported framework.

To learn how to get an APM agent to report an error, see the agent-specific API documentation:

Ignore errors

Sometimes the APM agent instruments an error that you don't want reported, such as errors that contain sensitive information like user login errors. If you don't want an error to report to the our collector, you can ignore the error, and the APM agent discards the error entirely.


For Java, Ruby, Node.js, and Python: If you want to report errors to APM but don't want those errors to affect your Apdex or error rate, mark them as expected instead.

There are two ways to ignore errors: through the agent configuration or through server-side configuration in the UI:

Expected errors (Java, Node.js, Python, Ruby, and .NET only)

For the below APM agents, you can mark errors as expected. These errors will be reported to APM and available for viewing, but they won't affect the Apdex or error rate (or alert conditions based on error rate).

To configure errors as expected, see the agent-specific documentation:

If expected errors are enabled, APM's Error analytics page will, by default, have a filter applied with the error.expected attribute set to false, meaning expected errors will not be displayed. To view expected errors, turn off the error.expected filter.

To view expected errors, query your data:

View errors in the UI

Among other places, error data appears in these parts of the UI:

For more help

If you need more help, check out these support and learning resources:

Create issueEdit page
Copyright © 2021 New Relic Inc.