Error Tracking Exception Replay
Exception Replay for APM Error Tracking is in beta.
Overview
Exception Replay in APM Error Tracking automatically captures production variable values so you can reproduce exceptions from Error Tracking issues.
Requirements
- Supported languages
- Python, Java, .NET
- Your Datadog Agent must be configured for APM.
- Your application must be instrumented with:
ddtrace for Pythondd-trace-java for Javadd-trace-dotnet for .NET
Exception Replay is only available in APM Error Tracking. Error Tracking for Logs and RUM is not supported.
Setup
- Install or upgrade your Agent to version
7.44.0 or higher. - Ensure that you are using:
ddtrace version 1.16.0 or higher.dd-trace-java version 1.35.0 or higher.dd-trace-dotnet version 2.53.0 or higher.
- Set the
DD_EXCEPTION_DEBUGGING_ENABLED environment variable to true to run your service with Error Tracking Exception Replay enabled.
Redacting sensitive data
By default, variable data linked to specific identifiers deemed sensitive, such as password and accessToken, are automatically redacted. See the full list of redacted identifiers.
You can also scrub variable data for PII by:
To learn more about scrubbing variable data, see Dynamic Instrumentation Sensitive Data Scrubbing.
Getting started
- Navigate to APM > Error Tracking.
- Click into any Python Error Tracking issue and scroll down to the stack trace component.
- Expand stack frames to examine captured variable values.
Troubleshooting
A specific Python error trace does not have variable values
To keep the performance overhead of the feature at a minimum, error capturing is rate limited: one error per second includes variable data. If you don’t see variable values on a given trace:
- Click View Similar Errors.
- Expand the time range selection to find another instance of the exception where variable values were captured.
Further Reading
Additional helpful documentation, links, and articles:
