If you don't have a Chromium checkout, download the latest Telemetry archive. Unzip the archive. If you're on Linux, Mac OS X, or Windows, you're all set!
Running on Android is supported with a Linux or Mac OS X host. Windows is not yet supported. There are also a few additional steps to set up:
Telemetry requires ADB. If you're running from the zip archive, ADB is already included. But if you're running with a Chromium checkout, ensure your .gclient file contains
target_os = ['android'], then resync your code.
If running from an OS X host, you need to run ADB as root. First, you need to install a "userdebug" build of Android on your device. Then run
adb root. Sometimes you may also need to run
Enable debugging over USB on your device.
To run a Telemetry test on Chrome OS, you will need a Linux, Mac OS X, or Windows host machine. Follow these steps to get set up:
You must have a test image installed on your Chrome OS device.
Connect your Chromebook and your host machine to the same network.
Get the IP address of your Chromebook.
- Ctrl+Alt+F2 will get you to a bash prompt
- Sign in as chronos
- Enter command
- Enter command
- You want the address for inet: in the en0 section
Set up a password-less ssh to your test machine.
$ cp /chromium/src/third_party/chromite/ssh_keys/testing_rsa .ssh/
$ cp /chromium/src/third_party/chromite/ssh_keys/testing_rsa.pub .ssh/
Add the following lines to .ssh/config:
Host <chromebook ip address>
Use the following options when running Telemetry:
Telemetry benchmarks can be run with
In the Telemetry zip archive, this located at
In the Chromium source tree, this is located at
Running a benchmark
List the available benchmarks with:
$ telemetry/run_benchmark list
Here's an example for running a particular benchmark:
$ telemetry/run_benchmark --browser=canary smoothness.top_25
To see additional options, run:
$ telemetry/run_benchmark run --help
Running on another browser
To list available browsers:
$ telemetry/run_benchmark --browser=list
If you are trying to run on Android, you should see an entry similar to
android-jb-system-chrome in this list. If it's not there, the device is not set up correctly.
To run a specific browser executable:
$ telemetry/run_benchmark --browser=exact --browser-executable=path_to_binary
To run on a Chromebook:
$ telemetry/run_benchmark --browser=cros-chrome --remote=ip_address