Install App Health Watcher
Bridge Crashlytics, Remote Config and Performance Monitoring to a push notification on your phone.
Your phone receives a push notification within seconds of your production app crashing.
Before you begin
- The Test Nexus app on your Android device.
- A Test Nexus account.
- A Gold subscription. Connected Apps is a Gold feature — worth knowing before you set up a Firebase project for it.
- A Firebase project on the Blaze plan. Every Firebase Extension requires it.
- At least one Firebase service in use: Crashlytics, Remote Config or Performance Monitoring.
- The Firebase CLI: npm install -g firebase-tools, then firebase login.
Create a connection
- In Test Nexus, open the main menu and tap Connected Apps.
- Tap the add button, then enter an app identifier you will recognise later.
- Select any combination of Crashlytics, Performance and Config.
- Add recipients if you want alerts to reach more than one person.
Generate a connection token
- Tap Generate Token, then copy it when it appears.
- Copy it now — Test Nexus shows it once. If you leave the screen without copying it, generate a new one.
Download the extension
- Open the releases page: https://github.com/programmerKaustubh/test-nexus-plugin/releases/latest
- Download the testnexus-app-health-watcher archive attached to the latest release.
- Unzip it and open a terminal in the unzipped folder.
Install and deploy
- Install the package dependencies from inside the unzipped folder, as its README directs.
- Run: firebase ext:install . --project=YOUR_PROJECT_ID
- Paste your token when the CLI prompts for it, then enter the same app identifier you used in Test Nexus.
- Deploy. Run ext:install once — each run creates a separate extension instance.
What it sees, and how to stop it
- Alerts are kept briefly so Alert History works: each one is stored in your account — the issue title, the app version, the crash count — and deleted automatically after 30 days unread, or 7 days once read. Your Firebase credentials and your source are never sent to us.
- Delivery is capped per connection, so a failing release cannot send an unbounded stream. Set a crash-count threshold in Connected Apps if you want fewer alerts than the cap allows.
- Revoke the token in Connected Apps and alerts stop immediately; generate a new one to start again.
- Uninstalling the extension from the Firebase console, or with firebase ext:uninstall, ends it entirely.
Verify the result
- Trigger a crash in your app.
- Wait one to two minutes.
- A push notification arrives with the crash details, and the event appears in Alert History in Test Nexus.
Get Test Nexus on Google Play