Catch up on everything we announced at this year's Firebase Summit. Learn more

Configure alerts for performance issues

Use Performance Monitoring alerts to notify project members if app start time is longer than you'd expect for your app.

What triggers an alert?

An alert is triggered when the app start time for your app crosses a threshold that you define in the Firebase console. Alerts are triggered only for the latest version of your app and only if it uses a real time compatible SDK version.

An alert is specifically triggered if the following are true:

  • There were at least 100 samples of the _app_start trace received for the latest version of your app in the last hour.
  • The duration of the _app_start trace exceeded the app's defined threshold (during the last hour and for the 50th percentile of users).
  • There was no alert previously raised for the same threshold in your latest app version.

By default, every app is opted-in for the app start time alert, and the default threshold is 2 seconds. Learn more about updating this alert configuration later on this page.

Note that, currently, alerts for other performance metrics or for built-in Firebase integrations with Slack, Jira, and PagerDuty are not available for Performance Monitoring alerts.

Receive alerts

Performance Monitoring alerts are sent via email notifications.

To receive Performance Monitoring alerts, you must have the firebaseperformance.config.update permission. The following roles include this required permission by default: Firebase Performance Admin, Firebase Quality Admin, Firebase Admin, or project Owner or Editor.

Alerts and their settings are project-wide. This means that, by default, every project member (who has the required permissions to receive alerts) will get an email notification when the alert is triggered.

Turn on/off alerts for your own account

For your own account, you can turn on/off Performance Monitoring alerts without affecting other project members. Note that you still need the required permissions to receive alerts.

In the Firebase console, in the top right-corner, go to Firebase alerts > Settings, then set your account preference for Performance Monitoring alerts.

Update an alert threshold

To update Performance Monitoring alerts, you must have the firebaseperformance.config.update permission. The following roles include this required permission by default: Firebase Performance Admin, Firebase Quality Admin, Firebase Admin, or project Owner or Editor.

Configure an alert threshold for each of your registered apps. Each app can have a different alert threshold (or have no alert at all).

  1. Go to the Performance Monitoring Dashboard tab in the Firebase console, then select the app for which you want to configure an alert.

  2. Scroll down to the traces table at the bottom of the screen.

  3. In the Custom traces subtab, find the _app_start trace row.

  4. At the far right of the row, open the overflow menu (), then select Alert settings.

  5. Follow the on-screen instructions to set the alert threshold for the app or to turn on/off the alert.