Merge branch 'jh/structured-logging' into pu

* jh/structured-logging: (25 commits)
  structured-logging: add config data facility
  structured-logging: t0420 tests for interacitve child_summary
  structured-logging: t0420 tests for child process detail events
  structured-logging: add child process classification
  structured-logging: add detail-events for child processes
  structured-logging: add structured logging to remote-curl
  structured-logging: t0420 tests for aux-data
  structured-logging: add aux-data for size of sparse-checkout file
  structured-logging: add aux-data for index size
  structured-logging: add aux-data facility
  structured-logging: t0420 tests for timers
  structured-logging: add timer around preload_index
  structured-logging: add timer around wt-status functions
  structured-logging: add timer around do_write_index
  structured-logging: add timer around do_read_index
  structured-logging: add timer facility
  structured-logging: add detail-event for lazy_init_name_hash
  structured-logging: add detail-event facility
  structured-logging: t0420 basic tests
  structured-logging: set sub_command field for checkout command
  ...

Author: gitster

Documentation/config.txt

@@ -3247,6 +3247,39 @@ showbranch.default::
 	The default set of branches for linkgit:git-show-branch[1].
 	See linkgit:git-show-branch[1].
 
+slog.path::
+	(EXPERIMENTAL) Enable structured logging to a file.  This must be
+	an absolute path.  (Git must be compiled with STRUCTURED_LOGGING=1.)
+
+slog.pretty::
+	(EXPERIMENTAL) Pretty-print structured log data when true.
+	(Git must be compiled with STRUCTURED_LOGGING=1.)
+
+slog.detail::
+	(EXPERIMENTAL) May be set to a boolean value or a list of comma
+	separated tokens.  Controls which categories of optional "detail"
+	events are generated.  Default to off.  This is conceptually
+	similar to the different GIT_TRACE_<key> values.
++
+Detail events are generic events with a context-specific payload.  This
+may represent a single function call or a section of performance sensitive
+code.
++
+This is intended to be an extendable facility where new events can easily
+be added (possibly only for debugging or performance testing purposes).
+
+slog.timers::
+	(EXPERIMENTAL) May be set to a boolean value or a list of comma
+	separated tokens.  Controls which categories of SLOG timers are
+	enabled.  Defaults to off.  Data for enabled timers is added to
+	the `cmd_exit` event.
+
+slog.aux::
+	(EXPERIMENTAL) May be set to a boolean value or a list of
+	comma separated tokens.  Controls which categories of SLOG
+	"aux" data are enabled.  Defaults to off.  "Aux" data is added
+	to the `cmd_exit` event.
+
 splitIndex.maxPercentChange::
 	When the split index feature is used, this specifies the
 	percent of entries the split index can contain compared to the

Documentation/git.txt

@@ -766,6 +766,12 @@ standard output.
 	adequate and support for it is likely to be removed in the
 	foreseeable future (along with the variable).
 
+`GIT_SLOG_PARENT_SID`::
+	(Experimental) A transient environment variable set by top-level
+	Git commands and inherited by child Git commands.  It contains
+	a session id that will be written the structured logging output
+	to help associate child and parent processes.
+
 Discussion[[Discussion]]
 ------------------------