gplay-vitals

gplay vitals (post-launch quality signals)

gplay vitals reads Android vitals, the post-launch quality signals you know from the Play Console: crash rate, ANR rate, slow cold start, slow rendering, excessive wakeups, low-memory kills, stuck background wakelocks, plus error reports and Play-detected anomalies. Shared conventions (auth, output, exit codes, --package pinning) are in gplay-cli-usage.

Two things make this namespace different from the rest of gplay:

• A distinct Google service. Vitals is backed by the Play Developer Reporting API (playdeveloperreporting), not the Android Publisher API. Same service-account file, but a different OAuth scope (…/auth/playdeveloperreporting). If the service account was invited only for publishing, vitals calls fail with a 403 (exit 11) until the reporting scope is granted; that is an environment fix, not a flag.
• Read-only, always. Every vitals command only reads metrics. There is no write here, so GPLAY_READONLY never blocks it, and no command needs --confirm.

Preset rate commands: the fast path

Each vital has an opinionated preset that needs no metric/dimension knowledge; it reports the set's primary metric over a default 28-day DAILY window:

gplay vitals crashes           # crash rate (on the pinned package)
gplay vitals anr               # ANR rate
gplay vitals slowstart         # slow cold-start rate
gplay vitals slowrendering     # janky-frames rate
gplay vitals excessivewakeup   # excessive wakeup rate
gplay vitals lmk               # low-memory-kill rate
gplay vitals stuckbgwakelock   # stuck background wakelock rate

All the presets share the same knobs:

gplay vitals crashes --by versionCode --version 123   # slice, then filter to one build
gplay vitals crashes --by country                     # or by country / device
gplay vitals anr --since 7d --period DAILY             # window: 28d default; HOURLY opt-in

• --by country|device|versionCode slices the timeline (availability depends on the metric set); --version filters to a single versionCode.
• --since 28d / --period DAILY|HOURLY|FULL_RANGE set the window.