Add docs/default about systemd journald rate limiting.

This commit is contained in:
Dan Helfman 2019-06-11 17:03:40 -07:00
parent 9a5e7a3abb
commit 4f0d3bf4ed
3 changed files with 16 additions and 2 deletions

View file

@ -51,6 +51,19 @@ Or to increase syslog logging to include debug spew:
borgmatic --syslog-verbosity 2
```
### systemd journal
If your local syslog daemon is systemd's journal, be aware that journald by
default throttles the rate at which a particular program can log. So you may
need to [change the journald rate
limit](https://www.freedesktop.org/software/systemd/man/journald.conf.html#RateLimitIntervalSec=)
in `/etc/systemd/journald.conf` if you're finding that borgmatic journald logs
are missing.
Note that the [sample borgmatic systemd service
file](https://torsion.org/borgmatic/docs/how-to/set-up-backups/#systemd)
already has this rate limit disabled.
## Scripting borgmatic
To consume the output of borgmatic in other software, you can include an

View file

@ -185,9 +185,9 @@ You can modify the cron file if you'd like to run borgmatic more or less frequen
If you're using systemd instead of cron to run jobs, download the [sample
systemd service
file](https://projects.torsion.org/witten/borgmatic/src/master/sample/systemd/borgmatic.service)
file](https://projects.torsion.org/witten/borgmatic/raw/branch/master/sample/systemd/borgmatic.service)
and the [sample systemd timer
file](https://projects.torsion.org/witten/borgmatic/src/master/sample/systemd/borgmatic.timer).
file](https://projects.torsion.org/witten/borgmatic/raw/branch/master/sample/systemd/borgmatic.timer).
Then, from the directory where you downloaded them:
```bash

View file

@ -4,3 +4,4 @@ Description=borgmatic backup
[Service]
Type=oneshot
ExecStart=/root/.local/bin/borgmatic
LogRateLimitIntervalSec=0