Getting started with the Performance Dashboard


  1. Make sure you have Python 2.7.x installed. Python 3.x is not supported.
  2. Download the Google Cloud SDK.
  3. Update the Cloud SDK and set the default project to your project ID by invoking the following commands:
    gcloud components update
    gcloud components install app-engine-python
    gcloud config set project [PROJECT-ID]
    Replace [PROJECT-ID] with your project ID. For, it's chromeperf.
  4. Make sure that gcloud is in your PATH.
  5. Make sure that you have installed protoc.

Running the tests

To run the Python unit tests, use bin/run_py_tests. To run the front-end component tests, use bin/run_dev_server_tests.

Running a local instance

Run bin/dev_server; this sets up a temporary directory, adds links to required libraries, and calls on that directory. By default, this starts a server on localhost:8080.

To load sample graph or alert data from production, navigate to /load_from_prod.

Deploying to production

See Docker deploy.

Where to find documentation