Customize velocity alerts

Use velocity alerts to notify your team when any individual issue is causing an urgent problem in your app. For Crashlytics, an issue is a grouping of similar crashes.

What triggers an alert?

Velocity alerts are triggered when an issue in your app crosses a threshold that you define in the Firebase console.

You define the threshold for velocity alerts in terms of a percentage of user sessions that were impacted by a crash. Refer to Google Analytics documentation to learn more about sessions. You can set a threshold value between 0.1% and 1% of sessions. By default, the velocity alert threshold is set at 1% of sessions.

Specifically, an alert is triggered if, during a one-hour time period, the following are true:

  • An issue in an app exceeds the defined threshold for that app.
  • The app has 250 sessions in that time period.
  • There was no alert previously raised for the issue in the app.

Update the alert threshold

To update velocity alerts, you must have the necessary permissions. Roles with the necessary permissions include: Firebase Quality Admin or project owner or editor.

Set a velocity alert threshold for each of your registered apps. Each app can have a different alert threshold.

  1. In the Firebase console, go to your Crashlytics dashboard.
  2. At the top of the page, select an app from the app dropdown list.
  3. In the top bar of the Issues pane, open the overflow menu (), then select Velocity alert settings.
  4. Follow the on-screen instructions to set the alert threshold for the app.

Receive alerts

You can route velocity alerts to your team using either: