tree: 568917cfeb3a948fe8274ceef19c008c9788aa06 [path history] [tgz]
  1. commands/
  2. tests/
  3. app.cc
  4. app.h
  5. BUILD.gn
  6. command.cc
  7. command.h
  8. main.cc
  9. MAINTAINERS
  10. README.md
  11. results_export.cc
  12. results_export.h
  13. results_output.cc
  14. results_output.h
  15. spec.cc
  16. spec.h
  17. spec_unittest.cc
  18. tracer.cc
  19. tracer.h
bin/trace/README.md

trace - collects and converts trace data

trace enables tracing of an application. It exposes the following command line interface (invoke trace with --help to get an overview):

trace [options] command [command-specific options]
  --help: Produce this help message

  list-categories - list all known categories
  record - starts tracing and records data
    --[command args]: Run program before starting trace.
        The program is terminated when tracing ends unless --detach is specified
    --append-args=[""]: Additional args for the app being traced, appended to
        those from the spec file, if any
    --buffer-size=[4]: Maximum size of trace buffer for each provider in
        megabytes
    --buffering-mode=[oneshot]: Specify buffering mode as one of oneshot,
        circular, or streaming
    --categories=[""]: Categories that should be enabled for tracing
    --decouple=[false]: Don't stop tracing when the traced program exits
    --detach=[false]: Don't stop the traced program when tracing finished
    --duration=[10s]: Trace will be active for this long after the session has
        been started
    --output-file=[/data/trace.json]: Trace data is stored in this file
        The output file may be "tcp:IP-ADDRESS:PORT" in which case a stream
        socket is connected to that address and trace data is streamed directly
        to it instead of saving the output locally. Streaming via TCP is
        generally only done when invoked by traceutil.
    --spec-file=[none]: Tracing specification file