Get Started with Maestro
Install @testrelic/maestro-analytics alongside Maestro and capture flow 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.
Full guide
Detailed install steps live in the upstream package documentation. This page is a short on-ramp for the docs site.
npm install @testrelic/maestro-analyticsMobile 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-networkTune 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.harmitmproxy required for live capture
--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.