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.
This documentation is for version 7+ of the BugSnag JavaScript notifier. If you are using older versions, we recommend upgrading to the latest release using our Upgrade guide. Documentation for the previous release can be found on our legacy pages.
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 |
---|---|---|
User ID | The user’s IP address | 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 result of os.hostname() on the device (or process.env.DYNO when running on Heroku) |
Modify device in a callback |
Runtime versions | The value of process.versions which lists the version of Node.js and its dependencies |
Modify device in a callback |
Details about the request can be helpful to reproduce errors.
Data | Default value | Preventing collection |
---|---|---|
URL | The full URL requested by the client | Modify request in a callback |
Path | The URL path of the request | Modify request in a callback |
HTTP method | The request method, e.g. GET , POST |
Modify request in a callback |
HTTP version | The version of HTTP used in the client request | Modify request in a callback |
Headers | The HTTP request headers | Modify request in a callback |
Query | The parsed query string | Modify request in a callback |
Body | The request body | Modify request in a callback |
Parameters | The parameters as defined by the route handler | Modify request in a callback |
Connection | Info from the underlying TCP connection: remoteAddress , remotePort , bytesRead , bytesWritten , localPort , localAddress and IPVersion |
Modify request in a callback |
Breadcrumbs are automatically recorded for common actions and can be helpful to reproduce errors.
Data | Default value | Preventing collection |
---|---|---|
Console message | The message sent to the console and its severity | Set enabledBreadcrumbTypes or modify/discard the breadcrumb in an onBreadcrumb callback |
Modifying error information may affect error grouping.
Data | Default value | Preventing collection |
---|---|---|
Context | The pathname or full URL (only when handling a request) | Modify context in a callback |
Error class | The class of the error that occurred | Modify errors[].errorClass in a callback |
Error message | The message of the error that occurred | Modify errors[].errorMessage in a callback |
Stack trace | The URL of the file where the error occurred, method and line number and surrounding code | Modify errors[].stacktrace in a callback |