Automatically captured data

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

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.

If no user ID is set on the Bugsnag client, a Bugsnag-generated Device ID is used for the user.id property of BugsnagEvent and BugsnagSession objects. To prevent collection, set an initial value in the Bugsnag client or update the data in an event callback and a session callback block.

Device information

Information about the device can be useful to identify if an error is only occurring on some devices.

To see the data collected about a user’s device, see the device property of the BugsnagEvent and BugsnagSession classes. To prevent collection, update the data in an event callback and a session callback block.

In addition, the following data is collected and added to the metadata field of a BugsnagEvent. This data can be removed by clearing the following keys from metadata:

Section Key Description
device batteryLevel Amount of battery charge available at time of report
device simulator A boolean value which is true if the device is a simulator
device charging A boolean value which is true if the device is charging its battery
device wordSize Word size of OS (32-bit or 64-bit)
device timezone The device’s timezone

Application information

Information about the application can be useful to identify if an error occurs in certain versions.

To see the data collected about your app, see the app property of the BugsnagEvent and BugsnagSession classes. To prevent collection, update the data in an event callback and a session callback block.

Section Key Description
app name The name of the executable, set from `CFBundleExecutable

Error information

Modifying error information may affect error grouping.

To see the data collected about a captured error/signal, see the errors property of the BugsnagEvent class. To prevent collection, update the data in an event callback block.

Breadcrumbs are automatically recorded for common actions and can be helpful to reproduce errors.

The following breadcrumbs are collected and can be filtered/amended in a breadcrumb callback block or disabled by its type using enabledBreadcrumbTypes:

Data Default value Preventing collection
NSUndoManagerDidUndoChangeNotification State Notification when an undo operation occurs
NSUndoManagerDidRedoChangeNotification State Notification when a redo operation occurs
UIWindowDidBecomeVisibleNotification State Notification when the window becomes visible
UIWindowDidBecomeHiddenNotification State Notification when the window becomes hidden
UIWindowDidBecomeKeyNotification State Notification when the window becomes the key window
UIWindowDidResignKeyNotification State Notification when the window stops becoming the key window
UIScreenBrightnessDidChangeNotification State Notification when the device’s screen brightness changes