BugSnag automatically captures a variety of data to help you debug your errors. You may wish to avoid capturing some types of data, particularly if there are privacy implications for your users.
User information is used to show you which errors are impacting the most users. Set your own user identifiers if you want to be able to find errors affecting individual users.
| Data | Default value | Preventing collection |
|---|---|---|
| ID | The username of an authenticated user, or the remote address of an unauthenticated user | Modify user in a callback |
| The authenticated user’s email address | Modify user in a callback |
|
| Name | The authenticated user’s name | Modify user in a callback |
| Authenticated | Whether the user is authenticated | Modify user in a callback |
Information about the device can be useful to identify if an error is only occurring on some devices.
| Data | Default value | Preventing collection |
|---|---|---|
| Hostname | The hostname of the device | Modify device in a callback |
| Runtime versions | The version of Python and supported frameworks in use | Modify device in a callback |
Details about the request can be helpful to reproduce errors.
| Data | Default value | Preventing collection |
|---|---|---|
| Method | The HTTP method, e.g. GET, PUT, POST |
Modify metadata['request'] in a callback |
| Path | The path component of the request URL | Modify metadata['request'] in a callback |
| Encoding | The encoding of the request, e.g. ‘utf-8’ | Modify metadata['request'] in a callback |
| GET parameters | The parsed query parameters from a GET request | Modify metadata['request'] in a callback |
| POST parameters | The parsed body from a POST request | Modify metadata['request'] in a callback |
| URL | The full URL requested by the client | Modify metadata['request'] in a callback |
Modifying error information may affect error grouping.
| Data | Default value | Preventing collection |
|---|---|---|
| Context | The route URL, or request method and path | Modify context in a callback |
| Error class | The class name of the exception | Modify errors[].error_class in a callback |
| Error message | The message of the error that occurred | Modify errors[].error_message in a callback |
| Stack trace | The stack trace (traceback) of the error that occurred, including file names line numbers and surrounding lines of code | Modify errors[].stacktrace in a callback |
If the logging integration is used, some contextual information is collected to populate the “extra data” tab.
| Data | Default value | Preventing collection |
|---|---|---|
asctime |
The formatted time string of when the log occurred | Modify metadata['extra_data'] in a callback |
| Created | The time the log occurred | Modify metadata['extra_data'] in a callback |
| Level name | The text level of the log | Modify metadata['extra_data'] in a callback |
| Level number | The numeric level of the log | Modify metadata['extra_data'] in a callback |
msecs |
The milliseconds portion of the created time | Modify metadata['extra_data'] in a callback |
| Name | The name of the logger | Modify metadata['extra_data'] in a callback |
| Process | The ID of the running process | Modify metadata['extra_data'] in a callback |
| Process name | The name of the running process | Modify metadata['extra_data'] in a callback |
| Data | Default value | Preventing collection |
|---|---|---|
| Log messages | The log message and its level. Only collected when using the breadcrumb log filter. | Set enabled_breadcrumb_types or modify/discard the breadcrumb in an on_breadcrumb callback |
| HTTP requests | The URL path of the current request and previous request (from the “Referer” header) | Set enabled_breadcrumb_types or modify/discard the breadcrumb in an on_breadcrumb callback |