VOOZH about

URL: https://docs.datadoghq.com/error_tracking/backend/capturing_handled_errors/

⇱ Capturing Handled Errors In Error Tracking

For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/error_tracking/backend/capturing_handled_errors.md. A documentation index is available at /llms.txt.

Capturing Handled Errors In Error Tracking

Overview

Datadog SDKs can automatically report handled errors. The errors are attached through span events to the span in which they are handled. They are also directly reported to Error Tracking.

Requirements

Supported languages
Python, Ruby
  • Your Datadog Agent must be configured for Standalone Backend Error Tracking or APM. You must be running Agent version 7.61.0 or higher.
  • Your application must be instrumented with:
    • dd-trace-py version 3.8.0 or higher for Python
    • dd-trace-rb version 2.16.0 or higher for Ruby
Handled errors contain the span attribute error.handling:handled. For more details, see Facets.

Capturing handled errors is only available in APM Error Tracking or Standalone Backend Error Tracking. Error Tracking for Logs and RUM is not supported.

Setup

Set up your application to capture handled errors using one of the following official Datadog SDKs:


Further reading