Сповіщення¶
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 і називають його, тож перевірка лишається червоною, поки той запис знову не матиме вдалої копії або поки ви не підтвердите збій у Потребує уваги.
Розділ може пінгувати власну адресу: Виняток у картці додає її, а в рядку написано Усі інші розділи надсилають ping на цей URL.
Приклад: Gotify на телефоні¶
У вас працює Gotify за адресою https://gotify.example.com, і ви хочете, щоб збої дзвонили на телефоні, а успіхи приходили тихо.
- У Gotify відкрийте Застосунки, створіть застосунок
BombVaultі скопіюйте його токен. - У BombVault відкрийте Налаштування, Сповіщення. У картці Сповіщення виберіть у Сповіщати значення При успіху та збої і ввімкніть Підсумовувати заплановані запуски, щоб ніч із 45 копій надіслала одне повідомлення замість 45.
- У картці Канали ввімкніть Gotify.
- Введіть
https://gotify.example.comу URL сервера./messageBombVault додає сам. - Вставте токен у Токен застосунку.
- Залиште Пріоритет у разі збою рівним 8, а Пріоритет у разі успіху рівним 5. Застосунок Gotify для Android вважає 8 і вище високим пріоритетом, тому звук подають лише збої.
- Натисніть Надіслати тест. Рядок під карткою повідомляє, чи прийняв його Gotify, а відхилений токен буде названо прямо.
Наступний плановий запуск надішле один підсумок із пріоритетом 5, а якщо в ньому щось не вдалося, то з пріоритетом 8.
Приклад: ntfy як webhook¶
Для публічної теми ntfy не потрібен обліковий запис. Виберіть назву теми, яку важко вгадати, бо кожен, хто її знає, може її читати.
- У картці Канали ввімкніть Webhook.
- Введіть адресу теми в URL Webhook, наприклад
https://ntfy.sh/bombvault-tower-7f3k, або адресу вашого власного сервера ntfy. - Виберіть у Формат Webhook значення ntfy.
- Підпишіться на ту саму тему в застосунку ntfy і натисніть Надіслати тест.
BombVault надсилає повідомлення як тіло запиту, а заголовок передає в X-Title. Збій іде з високим пріоритетом і тегом warning, щоб виділятися в застосунку.
Якщо повідомлення не приходять¶
Див. Сповіщення не приходять у розділі «Усунення несправностей».