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 or application not responding (ANR) events.
What triggers an alert?
Velocity alerts are triggered when an issue in your app crosses certain thresholds that you configure in the Firebase console.
You define the threshold for velocity alerts in terms of a percentage of users and the minimum number of users that were impacted by the crash or ANR. You can set the percentage threshold value between 0% and 100% of sessions. The minimum users threshold can be set to any number greater than or equal to 10. By default, the velocity alert threshold is set at 1% of sessions and 25 users.
Specifically, an alert is triggered if, during a 30-minute time period, all the following are true:
- An issue in an app exceeds the defined percentage threshold and exceeds the minimum users set for that app.
- The app has at least 10 users in that time period.
- There was no alert previously raised for the issue in the app on that version.
Configure velocity alert thresholds
To configure velocity alert thresholds, you must have the
firebasecrashlytics.config.update permission. The following roles include
this required permission by default:
Firebase Crashlytics Admin,
Firebase Quality Admin,
Firebase Admin, or
project Owner or Editor.
Configure velocity alert thresholds for each of your registered apps. Each app can have a different alert threshold.
Sign in to the Firebase console, then select your project.
Click , then select Project Settings. Select the Alerts tab.
Go to the Crashlytics alerts card and select the Velocity Alerts tab.
Configure the alert thresholds for the app.
Receive alerts
Get default alerts
By default, Firebase can send Crashlytics alerts using email. For velocity alerts and regressions, Firebase can also show these alerts in the Firebase console.
To receive Crashlytics alerts using this default mechanism, you must have
the firebase.projects.update permission. The following roles include this
required permission by default:
Firebase Admin or project
Owner or Editor.
By default, every project member (who has the required permissions to receive alerts) will get an email when an alert from Crashlytics is triggered.
Turn alerts on or off for your own account
For your own account, you can turn Crashlytics alerts on or off without affecting other project members. Note that you still need the required permissions to receive alerts.
Sign in to the Firebase console, then select your project.
Click , then select Project Settings. Select the Alerts tab.
Go to the Crashlytics alerts card and select the Velocity Alerts tab.
Set your account preference for Crashlytics alerts.
Set up basic alerting to third-party services
For Crashlytics alerts, Firebase offers a mechanism to send alerts to the following third-party services: Slack, Jira, or PagerDuty.
Set up these basic alerting options using guided workflows in the Integrations tab in your
Project settings .Select which configuration is used for individual apps and configure the destination of other alerts on the Crashlytics card of the Alerts tab in your
Project settings .
Note that if you want more control and customization for sending alerts to any third-party service (not limited to only Slack, Jira, or PagerDuty), check out the Set up advanced alerting to third-party services section that describes advanced alerting options.
Set up advanced alerting to third-party services
You can send Crashlytics alerts to your team's preferred notification channel, using Cloud Functions for Firebase. For example, you can write a function that captures an alert event for velocity alerts and posts the alert information to a third-party service, like Discord, Slack, or Jira. With this advanced alerting mechanism, you can fully customize the information sent to the third-party service; for example, you can include helpful deep-links into the Firebase console or add company-specific troubleshooting information.
To set up advanced alerting capabilities using Cloud Functions for Firebase, follow these steps:
Set up Cloud Functions for Firebase, which includes the following tasks:
- Set up a development environment for Node.js or Python.
- Install and sign into the Firebase CLI.
- Initialize Cloud Functions for Firebase using the Firebase CLI.
Write and deploy a function that captures an alert event from Crashlytics and handles the event payload (for example, posts the alert information in a message on Discord).
To learn about all the Crashlytics alert events that you can capture, go to the reference documentation for Crashlytics alerts.