GitLab

[tools/perf]: pinpoint_traces.py

========================================================================
Overall the tool has two subcommands:
========================================================================

usage: PINPOINT_TRACES [-h] {fetch,extract} ...

Tool to download and aggregate traces from a given Pinpoint job.

The tool is intended to be used in two steps:

Step 1: Fetch all traces from a Pinpoint job. Example:

> pinpoint_traces.py fetch \
    --job=https://pinpoint-dot-chromeperf.appspot.com/job/1709f5ff920000

Step 2: Extract all events with a matching name into a CSV file. Example:

> pinpoint_traces.py extract --event='.*Looper.dispatch.*' --output events.csv

NOTE: Currently only supported on Linux.

WARNING: Uses multiprocessing with heavy use of memory and CPU resources in each
         subprocess. This causes problems when handling SIGINT (when ^C is
         pressed), instead it is recommended to stop by ^Z and using the shell
         job control to kill or continue the job (like: kill %1).

positional arguments:
  {fetch,extract}
    fetch          Fetches job_results.csv and the traces mentioned in it
    extract        Extracts information about an event from all downloaded tracesinto a CSV file
========================================================================
The 'fetch' command takes a JOB:
========================================================================

usage: PINPOINT_TRACES fetch [-h] --job JOB

required named arguments:
  --job JOB   Pinpoint job ID or URL

========================================================================
The 'extract' command takes a regex and an output file name:
========================================================================

usage: PINPOINT_TRACES extract [-h] -e EVENT -o OUTPUT

required named arguments:
  -e EVENT, --event EVENT
                        Regex to match event names against
  -o OUTPUT, --output OUTPUT
                        CSV output file name

Bug: 1119406
Change-Id: Ief2a3d5ab97c54aa6e98c6095c6fcadbe88e4907
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/2461323
Commit-Queue: Egor Pasko <pasko@chromium.org>
Reviewed-by: John Chen <johnchen@chromium.org>
Reviewed-by: ssid <ssid@chromium.org>
Cr-Commit-Position: refs/heads/master@{#823409}