• Egor Pasko's avatar
    [tools/perf]: pinpoint_traces.py · 0bb86ecc
    Egor Pasko authored
    ========================================================================
    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: default avatarJohn Chen <johnchen@chromium.org>
    Reviewed-by: default avatarssid <ssid@chromium.org>
    Cr-Commit-Position: refs/heads/master@{#823409}
    0bb86ecc
pinpoint_traces.py 14 KB