Tool for opening your adaptive project in a mobile web view and gathering it's metrics using
1. Install Selenium
brew install selenium-server-standalone
2. Install ChromeDriver
Download the binary here: https://sites.google.com/a/chromium.org/chromedriver/downloads
Move it to somewhere in your path so Selenium can find it (eg.
3. Install the tool
git clone email@example.com:mobify/speedtrap.gitcd speedtrapnpm installnpm link
Performs selenium tests on your project and logs out performance metrics.
- Run Selenium using
grunt previewand copy the preview path URL to the tool.
speedtrap browser-perf --url "<preview-url>"
This command can be used to log performance stats to a CouchDB dashboard. This can be useful to run on a per-commit basis to track performance over time. It is a wrapper for perfjankie (https://github.com/axemclion/perfjankie).
grunt preview and copy the preview path URL to the tool.
speedtrap perfjankie -u "<url>" -slug "<project-slug>" -n "<project-name>"
- The URL, project name and slug need to be surrounded by
""so that special characters aren't interpreted by bash
- The "Site Url" needs to be complete (start with
SPEEDTRAP_DB_PASSWORDenvironment variables need to be set in order for test data to be posted to the CloudDB site.
- If your dashboard breaks, your
speedtrapmay be linked to a version of
perfjankiewithout the web files built. You will need to go into the linked
perfjankieproject and run
grunt distto generate the html/css/js for the dashboard. The site will then need to have the new files pushed to it (see perfjankie
Perfjankie was designed to be integrated into project CI environments to track performance over time.
- Add environment variables for
- Copy the
scripts/speedtrap-ci.shscript to your project.
- Update the fields at the top of the script:
- Call the
speedtrap-ci.shscript in your circle.yml (recommended spot is with in the
deploymentsection so tests can be run when merging to a specific branch vs. on every commit):
deployment:send_statistics:branch: [develop]commands:- <path_to_script>/speedtrap-ci.sh# OR# - <path_to_script>/speedtrap-ci.sh:# pwd: <path_to_adaptive_project_root># If your adaptive project isn't at the root of your repo
Report viewable through