Get Started with Maestro Analytics
Install @testrelic/maestro-analytics next to your Maestro project. Follow the package README for the exact CLI flags and environment variables for your version.
Detailed install steps live in the upstream package documentation. This page is a short on-ramp for the docs site.
- npm
- pnpm
npm install @testrelic/maestro-analytics
pnpm add @testrelic/maestro-analytics
Mobile network capture (v1.2.2)
Capture mobile network traffic alongside your flow run in one of two ways.
Live capture — --capture-network spawns mitmproxy, so mitmdump must be on your PATH:
maestro-analytics --capture-network
Tune the proxy with these flags:
| Flag | Purpose |
|---|---|
--proxy-port | Port the proxy listens on |
--proxy-host | Host/interface for the proxy |
--skip-cert-install | Skip installing the proxy CA certificate |
--proxy-include <pat> | Only capture hosts matching the pattern |
--proxy-exclude <pat> | Exclude hosts matching the pattern |
Import a HAR — if you already have a capture, skip the proxy and import it:
maestro-analytics --har-path ./run.har
--capture-network needs mitmdump (from mitmproxy) installed and on PATH. If you cannot install a proxy CA, use --har-path to import a HAR instead.
Per-step detail
Maestro analytics parses the commands-*.json files Maestro emits to record per-step timing and per-step parameters (text typed, swipe direction, lat/lon), retry/repeat grouping, and assertions — surfaced per step in the cloud.