MaxBack Watchdog
The MaxBack Watchdog monitors your VssWriter services, checks that backups are running on schedule, and alerts you when something needs attention.
Service Monitoring
Automatic service restarts and health checks for your VssWriter instances.
Notifications
Get alerts by email or webhook when backups fail, services go down, or licenses expire.
What the Watchdog does
The Watchdog is a Windows service (MaxBack.Watchdog) that runs alongside your VssWriter instances. It handles three things:
Service monitoring — Detects when a VssWriter service has stopped and restarts it automatically, with retries and escalation.
Backup schedule monitoring — Checks whether your databases are being backed up on schedule. If a backup window passes without a successful backup, you get an alert.
Notifications — Sends alerts through email (SMTP) or webhooks when something goes wrong — or when things complete successfully, if you want that too.
The Watchdog is installed automatically by the MaxBack setup. It starts after the VssWriter services and requires no configuration to begin monitoring services.
What triggers a notification
The Watchdog can notify you about these events:
| Event | When it fires | Severity |
|---|---|---|
| Backup completed | A backup session finishes successfully | Info |
| Backup warning | A backup completes with warnings | Warning |
| Backup failed | A backup session fails | Error |
| Restore completed | A restore finishes successfully | Info |
| Restore warning | A restore completes with warnings | Warning |
| Restore failed | A restore session fails | Error |
| Missing backup | A scheduled backup window passes without a successful backup | Error |
| Service down | A VssWriter service is stopped and the grace period has expired | Warning |
| Service restart failed | All restart attempts have been exhausted | Error |
| License expiring | A license expires within the next 30 days | Warning |
| License expired | A license has expired | Error |
| License missing | No valid license found for an instance | Error |
| Disk space low | Free space on a log backup drive drops below 500 MB | Warning |
| Disk space critical | Free space drops below 100 MB | Error |
Notifications only fire on state changes — you won't get the same alert every two minutes.
Log files
The Watchdog writes log files to:
C:\ProgramData\Dbosoft\MaxBack\Watchdog\logs
Warnings and errors are also written to the Windows Application Event Log (source: MaxBack Watchdog), so they show up in Event Viewer and can be picked up by your existing monitoring tools.
Configuration with the command line
All Watchdog settings are managed through maxback.vssclient. See the Command-Line Reference for the full list of commands, or jump directly to:
- Watchdog options — adjust check intervals, grace periods, and retry limits
- Notification channels — set up email and webhook delivery
- Credentials — manage SMTP and OAuth2 authentication
- Backup schedules — define expected backup windows per database
No manual JSON editing needed
While the Watchdog stores its configuration in settings.json, you should always use maxback.vssclient to make changes. The CLI validates your input, encrypts credentials, and can restart the Watchdog service to pick up changes immediately.