This documentation is for version 6 of the BugSnag JavaScript notifier. We recommend upgrading to the latest release using our Upgrade guide. Documentation for the current release can be found here.
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 |
---|---|---|
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 metadata.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 |
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 error.errorClass in a callback |
Error message | The message of the error that occurred | Modify error.message in a callback |
Stack trace | The URL of the file where the error occurred, method and line number and surrounding code | Modify stacktrace in a callback |