mirror/borg
1
0
Fork 0
mirror of https://github.com/borgbackup/borg.git synced 2024-12-23 00:07:38 +00:00
Code Issues Releases Wiki Activity

docs: improve logging docs, fixes #3549

Browse source
This commit is contained in:
Thomas Waldmann 2018-03-09 20:44:20 +01:00
parent fcf4145222
commit 99be106bc8
1 changed files with 17 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
docs/usage_general.rst.inc
View file

@ -86,8 +86,22 @@ If you have set BORG_REPO (see above) and an archive location is needed, use
``::archive_name`` - the repo URL part is then read from BORG_REPO.
Type of log output
~~~~~~~~~~~~~~~~~~
Logging
~~~~~~~
Borg writes all log output to stderr by default. But please note that something
showing up on stderr does *not* indicate an error condition just because it is
on stderr. Please check the log levels of the messages and the return code of
borg for determining error, warning or success conditions.
If you want to capture the log output to a file, just redirect it:
::
borg create repo::archive myfiles 2>> logfile
Custom logging configurations can be implemented via BORG_LOGGING_CONF.
The log level of the builtin logging configuration defaults to WARNING.
This is because we want Borg to be mostly silent and only output
@ -238,7 +252,7 @@ Please note:
(e.g. mode 600, root:root).
.. _INI: https://docs.python.org/3.5/library/logging.config.html#configuration-file-format
.. _INI: https://docs.python.org/3/library/logging.config.html#configuration-file-format
.. _file-systems: