Уведомления

BombVault может сообщить, когда копия не удалась, когда она удалась, когда копия просрочена, и раз в неделю подвести итог. Всё настраивается в разделе Настройки, Уведомления: что вызывает сообщение, в карточке Уведомления, куда идут сообщения, в карточке Каналы, и пинги проверки в карточке Healthchecks.

Что отправляет сообщение

Карточка Уведомления задаёт правила сразу для всех каналов:

• Уведомлять: Никогда, Только при сбое или При успехе и сбое, для всех каналов ниже. Новая установка начинает с Только при сбое, так что заполненный вами канал сообщит, когда копия сломается.
• Объединять запланированные запуски в сводку: одно сообщение на плановый запуск, например 42 из 45 удались, вместо одного на каждый контейнер или виртуальную машину. Копия, которую вы запустили вручную, по-прежнему шлёт своё сообщение. Замороженная гостевая система, неудавшееся хранение или превышенный бюджет роста отправляются сразу, даже если сводки включены.
• Уведомлять об обновлении контейнера: одно сообщение о каждом контейнере, который Обновлять контейнеры после успешного резервного копирования перевело на более новый образ, чтобы вы могли проверить, что он по-прежнему работает.
• Сообщать о просроченных копиях: раз в день в 09:00 BombVault проверяет, не просрочена ли включённая копия, то есть не старше ли она двух интервалов своего расписания, и шлёт по одному сообщению на каждый случай, называя отставшую запись. Следующая удачная копия снимает его.
• Уведомления Unraid: отправляет в собственную систему уведомлений Unraid, которая умеет пересылать в Pushover, на почту или в Discord. Работает через SSH-соединение из Настройки, Интеграции, SSH хоста, поэтому этот ключ должен быть авторизован. На TrueNAS и других хостах остаётся выключенным.
• Еженедельная сводка: одна сводка в неделю с числом запусков, новыми данными копий, просроченными разделами, актуальностью копий вне сервера и главными сбоями. Её план задаётся такой же кнопкой, как любой другой план, а Выкл. отключает его. См. Расписания.

Какие аномалии отправляют сообщение, задаётся в разделе Настройки, Проверка, см. Аномалии. Отложенная копия отправляет одно сообщение, когда начинает ждать, и одно, когда ожидание заканчивается, а не по одному на каждую попытку.

Отправить тест внизу карточки отправляет пробное сообщение по каждому включённому каналу со значениями, как они сейчас стоят в форме, и называет каждый канал, который не сработал. Проверка Healthchecks получает запись в своём журнале, а её состояние остаётся прежним.

Каналы

У каждого канала в карточке Каналы свой переключатель, а его поля появляются после включения. Каждый канал отправляет сам по себе и со своим лимитом времени, поэтому один хост, который никогда не отвечает, не задерживает остальные. Оповещение о просрочке, бюджете или аномалии, которое не принял ни один канал, отправляется снова, как и еженедельная сводка. Сообщение об отдельной копии или сводка отправляется один раз.

Канал	Поля	Примечания
Webhook	URL Webhook, Формат Webhook	Форматы: Generic JSON, Discord, Slack, Gotify и ntfy. Generic JSON отправляет title, message и ok.
Apprise	URL API Apprise, Теги (необязательно)	Укажите адрес /notify/<key> вашего контейнера Apprise API, чтобы дотянуться до более чем сотни его служб. Теги выбирают часть целей этого ключа.
Matrix	URL Homeserver, Токен доступа, ID комнаты	Токен остаётся на сервере и больше не показывается.
Gotify	URL сервера, Токен приложения, Приоритет при сбое, Приоритет при успехе	Приоритеты идут от 0 до 10 и по умолчанию равны 8 для сбоев и 5 для успехов.
Эл. почта (SMTP)	Хост SMTP, Порт, Шифрование, Имя пользователя, Пароль, Адрес отправителя, Адрес получателя	Шифрование: STARTTLS, TLS (implicit) или Нет.

Секреты, такие как токен Matrix, токен приложения Gotify и пароль SMTP, хранятся в зашифрованном виде. Под сохранённым секретом в поле написано Сохранено. Оставьте поле пустым, чтобы сохранить его. Когда вы меняете адрес сервера, BombVault не отправляет старый секрет на новое место: поле снова просит его, а новый адрес сохраняется, как только вы его введёте.

Healthchecks

Служба вроде Healthchecks.io поднимает тревогу, когда BombVault перестаёт отмечаться. Вставьте URL пинга проверки, и BombVault будет пинговать его на всём жизненном цикле каждой копии: в начале, затем при успехе или с /fail. Это происходит всегда, когда URL задан, что бы ни стояло в Уведомлять, так что проверка остаётся зелёной при успехе, даже если сообщения приходят только о сбоях. Раздел, которому некуда копировать, считается неудачным, поэтому его проверка краснеет, а не получает сообщение об успехе.

Разделы с одним и тем же URL делят одну проверку. Если копия одного из них не удалась, удачные копии остальных тоже пингуют /fail и называют его, так что проверка остаётся красной, пока у той записи снова не появится удачная копия или пока вы не подтвердите сбой в Требует внимания.

Раздел может пинговать собственный адрес: Исключение в карточке добавляет его, а в строке написано Все остальные разделы пингуют этот URL.

Пример: Gotify на телефоне

У вас работает Gotify по адресу https://gotify.example.com, и вы хотите, чтобы сбои звонили на телефоне, а успехи приходили тихо.

1. В Gotify откройте Приложения, создайте приложение BombVault и скопируйте его токен.
2. В BombVault откройте Настройки, Уведомления. В карточке Уведомления выберите в Уведомлять значение При успехе и сбое и включите Объединять запланированные запуски в сводку, чтобы ночь из 45 копий отправила одно сообщение вместо 45.
3. В карточке Каналы включите Gotify.
4. Введите https://gotify.example.com в URL сервера. /message BombVault добавляет сам.
5. Вставьте токен в Токен приложения.
6. Оставьте Приоритет при сбое равным 8, а Приоритет при успехе равным 5. Приложение Gotify для Android считает 8 и выше высоким приоритетом, поэтому звук подают только сбои.
7. Нажмите Отправить тест. Строка под карточкой сообщает, принял ли его Gotify, а отклонённый токен будет назван прямо.

Следующий плановый запуск отправит одну сводку с приоритетом 5, а если в нём что-то не удалось, то с приоритетом 8.

Пример: ntfy как webhook

Для публичной темы ntfy не нужна учётная запись. Выберите название темы, которое трудно угадать, потому что любой, кто его знает, может её читать.

1. В карточке Каналы включите Webhook.
2. Введите адрес темы в URL Webhook, например https://ntfy.sh/bombvault-tower-7f3k, или адрес вашего собственного сервера ntfy.
3. Выберите в Формат Webhook значение ntfy.
4. Подпишитесь на ту же тему в приложении ntfy и нажмите Отправить тест.

BombVault отправляет сообщение как тело запроса, а заголовок передаёт в X-Title. Сбой уходит с высоким приоритетом и тегом warning, чтобы выделяться в приложении.

Если сообщения не приходят

См. Уведомления не приходят в разделе «Устранение неполадок».