Browse Source

Add docs/default about systemd journald rate limiting.

master
Dan Helfman 2 years ago
parent
commit
4f0d3bf4ed
  1. 13
      docs/how-to/inspect-your-backups.md
  2. 4
      docs/how-to/set-up-backups.md
  3. 1
      sample/systemd/borgmatic.service

13
docs/how-to/inspect-your-backups.md

@ -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

4
docs/how-to/set-up-backups.md

@ -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

1
sample/systemd/borgmatic.service

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