Browse Source

Add docs/default about systemd journald rate limiting.

tags/1.3.6
Dan Helfman 1 year ago
parent
commit
4f0d3bf4ed
3 changed files with 16 additions and 2 deletions
  1. +13
    -0
      docs/how-to/inspect-your-backups.md
  2. +2
    -2
      docs/how-to/set-up-backups.md
  3. +1
    -0
      sample/systemd/borgmatic.service

+ 13
- 0
docs/how-to/inspect-your-backups.md 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


+ 2
- 2
docs/how-to/set-up-backups.md 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


+ 1
- 0
sample/systemd/borgmatic.service View File

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

Loading…
Cancel
Save