docs: when describing profiling, briefly explain .pprof files

This commit is contained in:
Ilya Grigoriev
2025-04-27 20:20:05 -07:00
committed by Michael Eischer
parent f4e21cdb75
commit e8dbb69a94

View File

@@ -71,10 +71,17 @@ The program can be built with debug support like this:
$ go run build.go -tags debug
This will make the ``restic debug <subcommand>`` available which can be used to
inspect internal data structures. In addition, this enables profiling flags such
as ``--cpu-profile`` and ``--mem-profile`` which can help with investigation
performance and memory usage issues. See ``restic help`` for more details and a
few additional ``--...-profile`` flags.
inspect internal data structures.
In addition, this enables profiling flags such as ``--cpu-profile`` and
``--mem-profile`` which can help with investigation performance and memory usage
issues. See ``restic help`` for more details and a few additional
``--...-profile`` flags.
Running Restic with profiling enabled generates a ``.pprof`` file such as
``cpu.pprof``. To view a profile in a web browser, first make sure that the
``dot`` command from `Graphviz <https://graphviz.org/>`__ is in the PATH. Then,
run ``go tool pprof -http : cpu.pprof``.
************