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 4 of the BugSnag Android notifier. We recommend upgrading to the latest release using our Upgrade guide. Documentation for the current release can be found here.
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 BugSnag generated Device ID (see below) | To override use setUser |
Information about the device can be useful to identify if an error is only occurring on some devices.
Data | Default value | Preventing collection |
---|---|---|
Device ID | A UUID generated by BugSnag and used for the individual application on a device | Modify deviceId in a callback |
Memory and disk | Amount of memory and disk | Not possible |
Battery | Battery level and charging state | Not possible |
Orientation | Orientation of the device (portrait, landscape) | Not possible |
Location status | Whether access to location services is allowed by user or not | Not possible |
Network access | The type of network access available (e.g. wifi, cellular) | Not possible |
Time | The device time | Not possible |
Manufacture and model | Manufacture, model and brand | Not possible |
Screen | Screen resolution and density | Not possible |
OS version | Information about the Android OS version & API level | Not possible |
Locale | Device locale (language/currency etc) | Not possible |
Emulator | Whether the device is an emulator or not | Not possible |
CPU ABI | The type of CPU (e.g. x86) | Not possible |
Rooted | Whether the device is rooted or not | Not possible |
Runtime versions | The version of Android and supported frameworks in use | Not possible |
Information about the application can be useful to identify if an error occurs in certain versions.
Data | Default value | Preventing collection |
---|---|---|
ID | The app’s unique package name | Not possible |
Build UUID | A BugSnag generated UUID used to uniquely identify a build | Not possible |
Name | The user visible app name | Not possible |
Package name | The unique package name | Not possible |
Version name | The user-visible version | Not possible |
Version code | The internal version code | Not possible |
Release stage | The release stage of the app (e.g. production) | Not possible |
Duration | How long the application has been running for | Not possible |
Duration in foreground | How long the app has been in the foreground for | Not possible |
In foreground | Whether the app is in the foreground or not | Not possible |
Active screen | The screen name of the current foreground Activity | Not possible |
Breadcrumbs are automatically recorded for common actions and can be helpful to reproduce errors.
Data | Default value | Preventing collection |
---|---|---|
onActivityCreated |
When an Activity receives the onCreate lifecycle callback |
Filter breadcrumbs in a callback |
onActivityStarted |
When an Activity receives the onStart lifecycle callback |
Filter breadcrumbs in a callback |
onActivityResumed |
When an Activity receives the onResume lifecycle callback |
Filter breadcrumbs in a callback |
onActivityPaused |
When an Activity receives the onPause lifecycle callback |
Filter breadcrumbs in a callback |
onActivityStopped |
When an Activity receives the onStop lifecycle callback |
Filter breadcrumbs in a callback |
onActivitySaveInstanceState |
When an Activity receives the onSaveInstanceState lifecycle callback |
Filter breadcrumbs in a callback |
onActivityDestroyed |
When an Activity receives the onDestroy lifecycle callback |
Filter breadcrumbs in a callback |
android.appwidget.action.APPWIDGET_DELETED |
When an AppWidget is deleted by its host | Filter breadcrumbs in a callback |
android.appwidget.action.APPWIDGET_DISABLED |
When an AppWidget is disabled by the last host | Filter breadcrumbs in a callback |
android.appwidget.action.APPWIDGET_ENABLED |
When an AppWidget is enabled in a host for the first time | Filter breadcrumbs in a callback |
android.appwidget.action.APPWIDGET_HOST_RESTORED |
When an AppWidget is restored in its host from a backup (sent to host) | Filter breadcrumbs in a callback |
android.appwidget.action.APPWIDGET_RESTORED |
When an AppWidget is restored in its host from a backup (sent to provider) | Filter breadcrumbs in a callback |
android.appwidget.action.APPWIDGET_UPDATE |
When an AppWidget should be updated | Filter breadcrumbs in a callback |
android.appwidget.action.APPWIDGET_UPDATE_OPTIONS |
When an AppWidget’s extras change | Filter breadcrumbs in a callback |
android.intent.action.ACTION_POWER_CONNECTED |
When the device is connected to power | Filter breadcrumbs in a callback |
android.intent.action.ACTION_POWER_DISCONNECTED |
When the device is disconnected from power | Filter breadcrumbs in a callback |
android.intent.action.ACTION_SHUTDOWN |
When the device is about to shutdown | Filter breadcrumbs in a callback |
android.intent.action.AIRPLANE_MODE |
When the device switches in or out of airplane mode | Filter breadcrumbs in a callback |
android.intent.action.BATTERY_LOW |
When the device enters a low battery state | Filter breadcrumbs in a callback |
android.intent.action.BATTERY_OKAY |
When the device exits a low battery state | Filter breadcrumbs in a callback |
android.intent.action.BOOT_COMPLETED |
When the device completes its boot sequence | Filter breadcrumbs in a callback |
android.intent.action.CAMERA_BUTTON |
When the device camera button is pressed | Filter breadcrumbs in a callback |
android.intent.action.CLOSE_SYSTEM_DIALOGS |
When a user action requests dismissal of a system dialog | Filter breadcrumbs in a callback |
android.intent.action.CONFIGURATION_CHANGED |
When the configuration changes (e.g. locale, orientation) | Filter breadcrumbs in a callback |
android.intent.action.CONTENT_CHANGED |
When the content of specified URIs changes | Filter breadcrumbs in a callback |
android.intent.action.DATE_CHANGED |
When the device date changes | Filter breadcrumbs in a callback |
android.intent.action.DEVICE_STORAGE_LOW |
When the device storage is running low | Filter breadcrumbs in a callback |
android.intent.action.DEVICE_STORAGE_OK |
When the device storage is no longer running low | Filter breadcrumbs in a callback |
android.intent.action.DOCK_EVENT |
When the device dock state changes | Filter breadcrumbs in a callback |
android.intent.action.DREAMING_STARTED |
When the system has started dreaming | Filter breadcrumbs in a callback |
android.intent.action.DREAMING_STOPPED |
When the system has stopped dreaming | Filter breadcrumbs in a callback |
android.intent.action.INPUT_METHOD_CHANGED |
When the device input method changes | Filter breadcrumbs in a callback |
android.intent.action.LOCALE_CHANGED |
When the device locale changes | Filter breadcrumbs in a callback |
android.intent.action.REBOOT |
When a reboot has been requested | Filter breadcrumbs in a callback |
android.intent.action.SCREEN_OFF |
When the device switches its screen off | Filter breadcrumbs in a callback |
android.intent.action.SCREEN_ON |
When the device switches its screen on | Filter breadcrumbs in a callback |
android.intent.action.TIMEZONE_CHANGED |
When the device timezone changes | Filter breadcrumbs in a callback |
android.intent.action.TIME_SET |
When the device time is set | Filter breadcrumbs in a callback |
android.os.action.DEVICE_IDLE_MODE_CHANGED |
When the device idle mode changes | Filter breadcrumbs in a callback |
android.os.action.POWER_SAVE_MODE_CHANGED |
When the device power save mode changes | Filter breadcrumbs in a callback |
Modifying error information may affect error grouping.
Data | Default value | Preventing collection |
---|---|---|
Context | The pathname of the URL | Modify context in a callback |
Error class | The class of the error that occurred | Modify the Throwable in a callback |
Error message | The message of the error that occurred | Modify the Throwable in a callback |
Stack trace | The URL of the file where the error occurred, method and line number | Modify the Throwable in a callback |
Threads | Stack traces of all other threads | Not possible |