К содержимому
Tickwise

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

🌐 Серверы (4)🚨 Инциденты (1)
🔔 Уведомления📊 Сводки
⚙️ Управление❓ Помощь
🔄 Обновить
Главный экран. Кнопки открывают разделы в том же сообщении.
КомандаЧто открывает
/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–0800–09
• МСКUTC
✅ Сообщать о восстановлении
← Назад🏠 Меню
НастройкаВариантыПо умолчанию
Уведомлениявключены или выключенывключены
Важностьвсё, error и выше, только criticalвсё
Тихие часывыкл, 23–08, 00–09выкл
Часовой поясМСК или UTCМСК
Сообщать о восстановлениида или нетда

В тихие часы приходят только critical-инциденты, а сообщения о восстановлении и сводки приходят без звука. Если все серверы инцидента заглушены в этом чате, карточка не приходит. Заглушённые серверы перечислены на этом же экране с кнопкой «🔔 Вернуть».

Сводки

/digest присылает сводку по запросу — «📊 За сутки» или «📊 За неделю» — и задаёт расписание: не присылать (по умолчанию), ежедневно в 10:00 или по понедельникам в 10:00 в часовом поясе чата. Первая сводка по новому расписанию придёт в ближайшее 10:00, а не сразу.

В сводке:

  • сколько инцидентов открыто (из них critical), закрыто и открыто сейчас;
  • три самые частые категории;
  • число новых неизвестных ошибок;
  • по каждому серверу — доля времени на связи, худший TPS и пиковый MSPT.

Управление и права в группах

Раздел «⚙️ Управление» показывает организацию, число серверов и привязанные чаты.

  • ✏️ Переименовать организацию — до 48 символов.
  • 🚪 Отвязать этот чат — уведомления сюда больше не придут, серверы и история останутся. Если это единственный чат организации, а серверы ещё привязаны, бот попросит сначала отвязать серверы.

В личном чате менять всё может его владелец. В группе смотреть экраны могут все участники, а менять настройки, заглушать, переименовывать и отвязывать — только администраторы чата. Остальным бот ответит «Менять настройки в группе могут только администраторы чата».

Бот пока говорит только по-русски. Что именно Tickwise получает с серверов, описано на странице Безопасность.