NAME

perf-tool - Command-line tool for working with Perf data.

SYNOPSIS

perf-tool

[--help|-h]
[--logging]

Usage:

perf-tool [GLOBAL OPTIONS] command [COMMAND OPTIONS] [ARGUMENTS...]

GLOBAL OPTIONS

--help, -h: show help

--logging: Turn on logging while running commands.

COMMANDS

config

create-pubsub-topics-and-subscriptions

Create PubSub topics and subscriptions for the given config.

--config_filename="": Load configuration from FILE

--connection_string="": Override the connection string in the config file.

validate

Validate the given config

--config_filename="": Load configuration from FILE

tiles

last

Prints the index of the last (most recent) tile.

--config_filename="": Load configuration from FILE

--connection_string="": Override the connection string in the config file.

--local: If true then use gcloud credentials.

list

Prints the last N tiles and the number of traces they contain.

--config_filename="": Load configuration from FILE

--connection_string="": Override the connection string in the config file.

--local: If true then use gcloud credentials.

--num="": The number of tiles to display. (default: 10)

traces

list

Prints the IDs of traces in the last (most recent) tile, or the tile specified by the --tile flag, that match --query.

--config_filename="": Load configuration from FILE

--connection_string="": Override the connection string in the config file.

--local: If true then use gcloud credentials.

--query="": The query to run.

--tile="": The tile to query. (default: -1)

export

Writes a JSON files with the traces that match --query for the given range of commits.

--begin="": The commit number to start loading data from. Inclusive. (default: -1)

--config_filename="": Load configuration from FILE

--connection_string="": Override the connection string in the config file.

--end="": The commit number to load data to. (default: -1)

--local: If true then use gcloud credentials.

--out="": The output filename.

--query="": The query to run.

ingest

force-reingest

--config_filename="": Load configuration from FILE

--dryrun: Just display the list of files to send.

--local: If true then use gcloud credentials.

--start="": Start the ingestion at this time, of the form: 2006-01-02. Default to one week ago.

--stop="": Ingest up to this time, of the form: 2006-01-02. Default to now.

validate

--in="": The input filename.

--verbose: Verbose output.

database

backup

alerts

--config_filename="": Load configuration from FILE

--connection_string="": Override the connection string in the config file.

--local: If true then use gcloud credentials.

--out="": The output filename.

shortcuts

--config_filename="": Load configuration from FILE

--connection_string="": Override the connection string in the config file.

--local: If true then use gcloud credentials.

--out="": The output filename.

regressions

--backup_to_date="": How far back in time to back up Regressions. Defaults to four weeks.

--config_filename="": Load configuration from FILE

--connection_string="": Override the connection string in the config file.

--local: If true then use gcloud credentials.

--out="": The output filename.

restore

alerts

--config_filename="": Load configuration from FILE

--connection_string="": Override the connection string in the config file.

--in="": The input filename.

--local: If true then use gcloud credentials.

shortcuts

--config_filename="": Load configuration from FILE

--connection_string="": Override the connection string in the config file.

--in="": The input filename.

--local: If true then use gcloud credentials.

regressions

--config_filename="": Load configuration from FILE

--connection_string="": Override the connection string in the config file.

--in="": The input filename.

--local: If true then use gcloud credentials.

trybot

reference

Generates a reference file to be used by nanostat for the given trybot file.

--config_filename="": Load configuration from FILE

--connection_string="": Override the connection string in the config file.

--filename="": The full URL of a nanobench trybot results files, e.g.: ‘gs://skia-perf/...foo.json’

--local: If true then use gcloud credentials.

--num="": The number of ingestion files to load. (default: 5)

--out="": The output filename.

markdown

Generates markdown help for perf-tool.

--help, -h: show help

help, h

Shows a list of commands or help for one command