Частые вопросы

Как добавить монитор

1. В меню профиля выберите «Мои мониторинги».
2. Нажмите «Добавить мониторинг».
3. Укажите адрес сайта или API и название (если имя не задано, будет использован домен).
4. Выберите режим проверки — headers или body, если тариф его разрешает.
5. Нажмите «Добавить».

Количество мониторов ограничено тарифом: Free — 2 монитора, Lite — 5 мониторов, Pro — 10 мониторов. Когда лимит исчерпан, кнопка добавления блокируется и появляется ссылка на страницу подписки.

Что можно делать с монитором

• Проверить — ручная немедленная проверка. Она не расходует суточную квоту и не записывается в историю; обновляются только текущий статус и время проверки. Между ручными проверками одного монитора действует короткая пауза (15 секунд на Free, 10 секунд на Lite, 5 секунд на Pro).
• Изменить — правка названия, режима проверки и текста контроля; при смене режима время следующей проверки пересчитывается.
• Удалить — удаление монитора с подтверждением прямо в карточке.
• История — таблица проверок: время, статус, причина, HTTP-код, латентность, режим.
• Инциденты — периоды недоступности: начало, длительность и причина.

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

Как часто идут проверки

Интервал задаётся тарифом и режимом, менять его вручную нельзя: Free — headers каждые 120 секунд; Lite — headers и body каждые 60 секунд; Pro — headers каждые 30 секунд, body каждые 60 секунд. Таймаут одной проверки — 10 секунд.

Как подключить

1. Создайте бота у @BotFather командой /newbot и скопируйте токен, который он пришлёт.
2. На сайте откройте «Настройки» в меню профиля, найдите блок «Свой бот для алертов», вставьте токен и нажмите «Подключить».
3. Выберите, куда присылать алерты:
   • личный чат — откройте бота по ссылке и нажмите «Start»;
   • группа — добавьте бота в группу по ссылке, код привязки отправится сам;
   • канал — сделайте бота администратором канала и опубликуйте пост с кодом привязки, который показан в настройках.
4. Нажмите «Проверить». Бот пришлёт тестовое сообщение, статус сменится на «Работает» — с этого момента алерты идут через него.

Код привязки действует ограниченное время — срок указан рядом с ним. Если код истёк, нажмите «Привязать другой чат», чтобы получить новый.

Что приходит от своего бота

• Через своего бота приходят только алерты мониторов.
• Сообщения о тарифе, оплате и напоминания по-прежнему присылает бот StatusEye — в чат, через который выполнен вход.
• Если свой бот перестал работать (его удалили, отозвали токен или убрали из чата), алерт придёт от бота StatusEye с пометкой о проблеме, а статус в настройках станет «Не работает». Чтобы вернуть своего бота, исправьте причину и снова нажмите «Проверить».
• При переходе на Free настройки сохраняются, но алерты присылает бот StatusEye.

Управление и частые проблемы

• Привязать другой чат — сменить, куда приходят алерты.
• Заменить токен — если вы перевыпустили токен в @BotFather.
• Отключить — алерты снова будет присылать бот StatusEye.
• «Бота уже читает другая программа» — бот подключён к другому сервису или у него настроен вебхук. Для StatusEye нужен отдельный бот, который больше нигде не используется.
• «Этот бот уже подключён к другому аккаунту» — один бот можно привязать только к одному аккаунту StatusEye.
• Токен хранится на сервере и после подключения нигде не показывается — даже вам.

Как подключить

1. Откройте «Настройки» → «Оповещения» → «Вебхуки», вставьте адрес (только https) и нажмите «Добавить». Формат подставится по адресу: Slack, Discord или JSON.
2. Нажмите «Проверить» — на адрес уйдёт тестовое сообщение, а на странице появится результат.
3. Чтобы получать алерты только на вебхуки, выключите переключатель «Алерты в Telegram». Если все вебхуки перестанут работать или тариф закончится, Telegram включится сам — алерты не пропадут.

Что приходит

Формат json — полное событие (запрос POST, тело application/json):

{
  "version": 1,
  "event_id": "…uuid…",
  "type": "monitor.down",
  "occurred_at": "2026-10-31T12:00:00Z",
  "monitor": {"id": 42, "name": "My site", "url": "https://example.com"},
  "status": "down",
  "reason": {"code": "http_5xx", "text": "…"},
  "http_status": 502,
  "latency_ms": 1200,
  "duration_sec": 3600,
  "links": {"dashboard": "https://statuseye.ru/profile"}
}

type: monitor.down, monitor.up, test. duration_sec — сколько сайт был доступен (для down) или недоступен (для up), либо null. Поля только добавляются; несовместимые изменения выйдут как version: 2. Повторы доставки приходят с тем же event_id — по нему можно отсеивать дубли.

Форматы slack и discord — готовое сообщение: у Slack, Mattermost и Rocket.Chat это поле text, у Discord — карточка с цветом (упоминания @everyone отключены).

Как проверить подпись (формат json)

Каждый запрос подписан ключом, который показывается один раз при создании вебхука. В заголовке X-StatusEye-Signature лежит t=<unix-время>,v1=<hex>; подпись — HMAC-SHA256 от строки <t>.<тело запроса> (тело берите как есть, до разбора JSON). Проверяйте и время — старые запросы отклоняйте. Другие заголовки: X-StatusEye-Event, X-StatusEye-Event-Id, User-Agent: StatusEye-Webhook/1.

Python

import hashlib, hmac, time

def verify(secret: str, body: bytes, header: str, tolerance: int = 300) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(","))
    ts, sig = int(parts["t"]), parts["v1"]
    if abs(time.time() - ts) > tolerance:
        return False  # stale request
    msg = str(ts).encode() + b"." + body
    expected = hmac.new(secret.encode(), msg, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, sig)

Node.js

const crypto = require('crypto');

function verify(secret, rawBody, header, tolerance = 300) {
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
  const ts = Number(parts.t);
  if (Math.abs(Date.now() / 1000 - ts) > tolerance) return false; // stale request
  const expected = crypto.createHmac('sha256', secret)
    .update(ts + '.').update(rawBody).digest('hex');
  const a = Buffer.from(expected), b = Buffer.from(parts.v1 || '');
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

Как работает доставка

• Ответ 2xx — доставлено. Приёмник должен ответить в течение 10 секунд; тело ответа мы не читаем и не показываем.
• Ошибка сети, таймаут, ответы 5xx и 429 — повторы через 30 секунд, 2 минуты, 10 минут, 30 минут, затем раз в час, до 24 часов.
• Ответы 400, 401, 403, 404, 410, перенаправления (3xx) и запрещённый адрес считаются постоянной ошибкой. После пяти таких ошибок подряд, а также после суток без единой доставки вебхук отключается, вам приходит сообщение в Telegram, а алерты снова идут в Telegram. Исправьте адрес или нажмите «Проверить» — вебхук вернётся в работу.
• Внутри одного вебхука события приходят по порядку: «восстановлен» не обгонит «упал».
• Разрешены только адреса https с публичным IP: внутренние сети, localhost и служебные порты запрещены. Перенаправления не выполняются — указывайте конечный адрес.

Где смотреть расход квот

В разделе «Подписка» есть блок «Квоты за сутки»: мониторы, body-проверки и алерты — использовано и осталось. Квоты считаются за сутки по UTC и обнуляются в 00:00 UTC, то есть в 03:00 по московскому времени.

Как подключить или сменить тариф

Откройте «Подписку» в меню профиля и нажмите «Подключить тариф» — откроется окно оплаты с выбором тарифа и полем для e-mail. После оплаты подписка активируется, а статус и срок окончания отображаются на той же странице. С Lite можно перейти на Pro кнопкой «Перейти на Pro»: неиспользованные дни Lite не пропадают — они пересчитываются по цене и добавляются к сроку Pro (например, 20 дней Lite дают ещё 9 дней Pro). Перейти с Pro на Lite можно после окончания Pro. Условия оплаты и возврата описаны в пользовательском соглашении, обработка данных — в политике конфиденциальности.