Уведомления

Каждый сервис отправляет свои события в notify: деплои, падения, инциденты, бэкапы, ошибки, входы. notify доставляет их в каналы, на которые подписались люди и команды.

Подключите канал

В notify → Каналы:

Telegram: нажмите Привязать, откройте бота инстанса и отправьте ему код /start. Сообщения приходят на вашем языке со значками; в чате работают /mute, /subs и /status.
Web Push: разрешите уведомления в браузере.
Почта: SMTP инстанса (SMTP_URL, часто это сервис mail).
Вебхук: адрес, получающий JSON с подписью HMAC-SHA256 в X-Xvii-Signature. Приватные адреса отклоняются, если инстанс их не разрешает.

Отправьте тест в каждый добавленный канал.

Подписки

Подписка связывает канал с сервисами, командами, топиками и минимальной важностью. Полезные:

Событие	От
`app.deploy_failed`, `app.crashed`, `cron.failed`	apps
`deploy.failed`	pages
`monitor.down`, `heartbeat.missed`, `certificate.expiring`	status
`issue.new`, `issue.regressed`	errors
`backup.failed`, `backup.verify_failed`	backups
`zone.dnssec_mismatch`, `nameserver.stale`	domains

Не делайте одну подписку «на всё»: важные тревоги тонут в рутине. Тихие часы придерживают некритичные сообщения; дайджесты собирают их вместе; повторы одного события сворачиваются. Подтверждение останавливает повторы инцидента (xvii notify ack <seq>).

Топики: свои события

Топик принимает сообщения из скриптов и CI с любым токеном своей команды:

xvii notify topic backups --team ops --description "Ночные бэкапы"
xvii notify send backups "Ночной бэкап готов: 12 ГБ"
df -h | xvii notify send disk --title "Место на диске"

Или через curl:

curl -H "Authorization: Bearer $XVII_TOKEN" -H "X-Title: Backup done" \
  -d "12 GB" https://notify.xvii.network/t/backups

--priority urgent делает сообщение критическим, high — предупреждением; --link добавляет ссылку; --tags — теги.

Недавние события

xvii notify events --severity warning -n 50
xvii notify events --type 'deploy.*' --json

Активность в home показывает ту же ленту по всему инстансу.