Documentation/config/trace2.txt

   1 Trace2 config settings are only read from the system and global
   2 config files; repository local and worktree config files and `-c`
   3 command line arguments are not respected.
   4
   5 trace2.normalTarget::
   6         This variable controls the normal target destination.
   7         It may be overridden by the `GIT_TRACE2` environment variable.
   8         The following table shows possible values.
   9
  10 trace2.perfTarget::
  11         This variable controls the performance target destination.
  12         It may be overridden by the `GIT_TRACE2_PERF` environment variable.
  13         The following table shows possible values.
  14
  15 trace2.eventTarget::
  16         This variable controls the event target destination.
  17         It may be overridden by the `GIT_TRACE2_EVENT` environment variable.
  18         The following table shows possible values.
  19 +
  20 include::../trace2-target-values.txt[]
  21
  22 trace2.normalBrief::
  23         Boolean.  When true `time`, `filename`, and `line` fields are
  24         omitted from normal output.  May be overridden by the
  25         `GIT_TRACE2_BRIEF` environment variable.  Defaults to false.
  26
  27 trace2.perfBrief::
  28         Boolean.  When true `time`, `filename`, and `line` fields are
  29         omitted from PERF output.  May be overridden by the
  30         `GIT_TRACE2_PERF_BRIEF` environment variable.  Defaults to false.
  31
  32 trace2.eventBrief::
  33         Boolean.  When true `time`, `filename`, and `line` fields are
  34         omitted from event output.  May be overridden by the
  35         `GIT_TRACE2_EVENT_BRIEF` environment variable.  Defaults to false.
  36
  37 trace2.eventNesting::
  38         Integer.  Specifies desired depth of nested regions in the
  39         event output.  Regions deeper than this value will be
  40         omitted.  May be overridden by the `GIT_TRACE2_EVENT_NESTING`
  41         environment variable.  Defaults to 2.
  42
  43 trace2.configParams::
  44         A comma-separated list of patterns of "important" config
  45         settings that should be recorded in the trace2 output.
  46         For example, `core.*,remote.*.url` would cause the trace2
  47         output to contain events listing each configured remote.
  48         May be overridden by the `GIT_TRACE2_CONFIG_PARAMS` environment
  49         variable.  Unset by default.
  50
  51 trace2.envVars::
  52         A comma-separated list of "important" environment variables that should
  53         be recorded in the trace2 output.  For example,
  54         `GIT_HTTP_USER_AGENT,GIT_CONFIG` would cause the trace2 output to
  55         contain events listing the overrides for HTTP user agent and the
  56         location of the Git configuration file (assuming any are set).  May be
  57         overriden by the `GIT_TRACE2_ENV_VARS` environment variable.  Unset by
  58         default.
  59
  60 trace2.destinationDebug::
  61         Boolean.  When true Git will print error messages when a
  62         trace target destination cannot be opened for writing.
  63         By default, these errors are suppressed and tracing is
  64         silently disabled.  May be overridden by the
  65         `GIT_TRACE2_DST_DEBUG` environment variable.
  66
  67 trace2.maxFiles::
  68         Integer.  When writing trace files to a target directory, do not
  69         write additional traces if we would exceed this many files. Instead,
  70         write a sentinel file that will block further tracing to this
  71         directory. Defaults to 0, which disables this check.