borgmatic/docs/reference/configuration/monitoring/watchgoose.md

title	eleventyNavigation
Watchgoose	key parent Watchgoose 🚨 Monitoring

New in version 2.1.7 Watchgoose is a service that "watches your cron jobs, backups, queues, and scripts" and alerts you "the second one goes late or down." borgmatic has built-in integration with it. Once you create a Watchgoose account and project on their site, all you need to do is configure borgmatic with the unique "Ping URL" for your project. Here's an example:

watchgoose:
    ping_url: https://watchgoose.com/addffa72-da17-40ae-be9c-ff591afb942a

With this configuration, borgmatic pings your Watchgoose project when a backup begins, ends, or errors, but only when any of the create, prune, compact, or check actions are run.

You can configure Watchgoose to notify you by a variety of mechanisms when backups fail or it doesn't hear from borgmatic for a certain period of time.

Sending logs

If the actions complete successfully, borgmatic can notify Watchgoose of the success and includes borgmatic logs in the payload data sent to Watchgoose. This means that borgmatic logs can show up in the Watchgoose UI, although be aware that Watchgoose currently has a 10,000 byte limit for the logs in each ping.

Log sending is disabled by default to avoid revealing private log information to a third-party service. But to enable the feature, use the send_logs option:

watchgoose:
    ping_url: https://watchgoose.com/addffa72-da17-40ae-be9c-ff591afb942a
    send_logs: true

If an error occurs during any action or hook, borgmatic notifies Watchgoose, also tacking on logs including the error itself. But the logs are only included for errors that occur when a create, prune, compact, or check action is run.

You can customize the verbosity of the logs that are sent to Watchgoose with borgmatic's --monitoring-verbosity flag. The --list and --stats flags may also be of use. See create action documentation for more information.

Set the defaults for these flags in your borgmatic configuration via the monitoring_verbosity, list, and statistics options.

Full configuration

{% include snippet/configuration/sample.md %}

{% include borgmatic/watchgoose.yaml %}