Skip to end of metadata
Go to start of metadata

Troubleshooting crashes reported by a user

App crashes happen. With the help of the custom queries interface found in AMPLIFY Crash Analytics (ACA), you can find the most recent crash experienced by that user and gather more information about the reported crash.

  1. In the Dashboard, you browse to the Application and lookup tabCrashIssue.
  2. Click on Analytics > Custom Queries.
  3. Select Crash as the option under Grouping to group the results and use data.meta.username as the property name to filter the username. Note: if you are using ACA version 1.2, use data.username instead of data.meta.username.
  4. To filter on the username value, you should set the username value with the setusername. You can also set properties that would provide diagnostic information, like battery information, network conditions, or custom app properties using setMetadata and query for those values by filtering against data.meta.key. Additionally, the custom queries interface provides options to filter on platform versions, device model, app versions, and other properties that are supported by the platform by default.

Crash Events, Feature Events, and Breadcrumbs

When you attach breadcrumbs, the breadcrumbs are sent to the platform as feature events. Breadcrumbs are not displayed by default (along with other feature events in analytics view) in the breadcrumb's view of crash details. To view the breadcrumb details, you must enable the feature events by checking the box labeled Include feature events and then expand the breadcrumb list in the breadcrumb tabs.

Since crash events are treated as another type of AMPLIFY Analytic event, the crash events are counted against the organization’s analytics event capacity. Crash events have the same retention period entitlements as analytics events (2 years for Enterprise plans and three months for Pro plans).