How to run performance tests

The primary way to run a performance test locally is to run its host-side entry point. These entry points are defined in src/tests/end_to_end/perf/. These are what are used in Fuchsia Infra builds for collecting performance results for uploading to Chromeperf. Running one of these entry points involves the following:

• Use the terminal product, in order to match what is tested on Fuchsia Infra in CI and CQ. Example:

  fx set terminal.x64-reduced-perf-variation --with //bundles/buildbot/terminal
  fx build
  

• Launch Fuchsia on hardware or on an emulator as usual.

• Run the test's host-side entry point with fx test --e2e. Example:

  fx test --e2e fidlc_microbenchmarks_test
  

  The argument to fx test should be your GN target name specified in the call to the fuchsia_component_perf_test template.

The test will write its results to a newly-created, timestamped subdirectory of out/test_out. This will include *.fuchsiaperf.json files containing the performance results. It may include other files such as Fuchsia traces.