Telegram-бот
Сбои сети — одним сообщением в Telegram
Что умеет бот Tickwise: карточки инцидентов с причиной и шагами, меню состояния сети, настройки уведомлений и ежедневные сводки.
На странице
В закрытой beta у Tickwise нет веб-кабинета: всё управление идёт через Telegram-бота. Он присылает уведомления о падении сервера в Telegram, показывает состояние сети и серверов, список инцидентов, а ещё позволяет настроить, что и когда присылать. Почти всё делается кнопками: бот редактирует одно сообщение-экран, на каждом экране есть «← Назад» и «🏠 Меню».
Бот управляет только уведомлениями и инцидентами. Команды на ваши серверы он не отправляет — агент их выполнять не умеет.
Подключение
Бот начинает работать в чате после первой привязки сервера: в консоли выполните tickwise link, затем отправьте боту /link КОД. Подробно — в инструкции по установке.
- Привязать сервер можно в личном чате с ботом или в группе. В группе
/linkпринимается только от администраторов чата. - Чат, где привязали первый сервер, становится организацией.
/linkв другом чате создаёт отдельную организацию. - В непривязанном чате любая команда показывает краткую инструкцию по подключению.
Главное меню и команды
/menu открывает главный экран: по каждой сети — сколько серверов на связи, сколько открытых инцидентов и худший TPS за последние 5 минут.
🏠 Моя сеть
🌐 Сеть default
🟡 на связи 3/4 · 🚨 открытых инцидентов: 1
📉 худший TPS за 5 мин: 17.8 (survival)
Обновлено 10:19 МСК
10:19
| Команда | Что открывает |
|---|---|
/menu (а также /start, /status) | главный экран |
/servers | список серверов |
/incidents | открытые инциденты |
/settings | настройки уведомлений этого чата |
/digest | сводки |
/link КОД [имя] [сеть] | привязка сервера |
/help | помощь |
/privacy | какие данные получает Tickwise |
/cancel | отменить ввод имени при переименовании |
Серверы
Список показывает каждый сервер с индикатором: 🟢 в порядке, 🟡 деградация, 🔴 упал, ⚫ агент молчит больше 90 секунд, 🛠 обслуживание, ⚪ агент ещё ни разу не выходил на связь. Заглушённые серверы помечены 🔕.
Карточка сервера содержит:
- роль (сервер, backend или прокси), платформу и версию, версию Java, версию агента и пакета сигнатур, когда агент последний раз был на связи;
- за последние 5 минут — TPS и MSPT (среднее и p95), число игроков и занятую память;
- за 24 часа — худший TPS и пиковый MSPT (для backend'ов и одиночных серверов);
- число плагинов и кнопки открытых инцидентов этого сервера.
Кнопки карточки:
- 🔕 1 ч / 🔕 8 ч / 🔕 24 ч — заглушить уведомления по серверу в этом чате. Вернуть раньше срока — «🔔 Вернуть уведомления».
- ✏️ Переименовать — бот попросит ответить новым именем в течение 5 минут: 1–32 символа, буквы, цифры, пробел,
_ . -, имя должно быть уникальным в сети. Прежнее имя остаётся псевдонимом для сопоставления сvelocity.toml. - 🔌 Отвязать — после подтверждения отзывает токен агента: сервер перестаёт отправлять данные, уведомления по нему прекращаются, локальная диагностика на сервере продолжает работать. Подключить снова —
tickwise linkв консоли.
Инциденты
/incidents открывает список с вкладками «Открытые» и «За 7 дней», по 5 инцидентов на страницу, листание кнопками ◀ ▶. Когда открывается новый инцидент, бот присылает его карточку отдельным сообщением; из списка открывается та же карточка.
🔴 CRITICAL · сеть default
Backend «lobby» недоступен: краш сервера — игроки не могут войти
Серверы: velocity (прокси), lobby (вероятная первопричина)
Причина: прокси не может подключить игроков к lobby. Вероятная первопричина — краш на самом backend'е (Exception in server tick loop).
Что изменилось перед сбоем (подозрение, не доказательство):
• lobby: LuckPerms 5.4.140 → 5.4.141
🕒 02.10 07:19 UTC
10:19
В карточке — важность, сеть, серверы и вероятная первопричина, причина и её достоверность (например, проверенное решение, вероятная причина или гипотеза), до трёх доказательств, изменения перед сбоем и до трёх шагов «Что сделать».
- 🔎 Подробнее открывает страницу инцидента по секретной ссылке, она действует 30 дней. Каждый показ карточки из меню создаёт свежую ссылку.
- 👍 Помогло / 👎 Не помогло уходят в статистику сигнатуры. 👎 на карточке «новая ошибка» глушит эту ошибку на сервере: такие больше не присылаются.
- ✅ Взял в работу и ✔️ Решено меняют статус инцидента. У закрытого инцидента этих кнопок нет.
Если облако уточнило первопричину, бот правит уже отправленную карточку (с пометкой «🔄 Обновлено») вместо нового сообщения.
Сообщение о восстановлении
Когда инцидент закрывается сам — сигналы сбоя пропали, — бот правит карточку («✅ Восстановлено · длилось 7 мин») и отвечает на неё коротким сообщением «✅ Восстановлено», чтобы пришло уведомление. Это работает для инцидентов, карточка которых уже приходила в чат. Отключается в настройках уведомлений.
Настройки уведомлений
/settings настраивает уведомления для текущего чата.
🔔 Уведомления этого чата
Уведомления: ✅ включены
Важность: все
Тихие часы: 23:00–08:00 МСК — только critical
Сообщать о восстановлении: ✅
10:19
| Настройка | Варианты | По умолчанию |
|---|---|---|
| Уведомления | включены или выключены | включены |
| Важность | всё, error и выше, только critical | всё |
| Тихие часы | выкл, 23–08, 00–09 | выкл |
| Часовой пояс | МСК или UTC | МСК |
| Сообщать о восстановлении | да или нет | да |
В тихие часы приходят только critical-инциденты, а сообщения о восстановлении и сводки приходят без звука. Если все серверы инцидента заглушены в этом чате, карточка не приходит. Заглушённые серверы перечислены на этом же экране с кнопкой «🔔 Вернуть».
Сводки
/digest присылает сводку по запросу — «📊 За сутки» или «📊 За неделю» — и задаёт расписание: не присылать (по умолчанию), ежедневно в 10:00 или по понедельникам в 10:00 в часовом поясе чата. Первая сводка по новому расписанию придёт в ближайшее 10:00, а не сразу.
В сводке:
- сколько инцидентов открыто (из них critical), закрыто и открыто сейчас;
- три самые частые категории;
- число новых неизвестных ошибок;
- по каждому серверу — доля времени на связи, худший TPS и пиковый MSPT.
Управление и права в группах
Раздел «⚙️ Управление» показывает организацию, число серверов и привязанные чаты.
- ✏️ Переименовать организацию — до 48 символов.
- 🚪 Отвязать этот чат — уведомления сюда больше не придут, серверы и история останутся. Если это единственный чат организации, а серверы ещё привязаны, бот попросит сначала отвязать серверы.
В личном чате менять всё может его владелец. В группе смотреть экраны могут все участники, а менять настройки, заглушать, переименовывать и отвязывать — только администраторы чата. Остальным бот ответит «Менять настройки в группе могут только администраторы чата».
Бот пока говорит только по-русски. Что именно Tickwise получает с серверов, описано на странице Безопасность.