Быстрый старт

Это руководство проведёт вас через первый запуск StatusRadar: создание аккаунта, добавление монитора, установка агента на сервер, публикация status-страницы и настройка оповещений. Каждый шаг ссылается на более подробную документацию, когда вы будете готовы углубиться в детали.

Если сначала хотите увидеть общую картину, прочитайте Обзор.

Шаг 1 — Создайте аккаунт

  1. Зарегистрируйтесь на statusradar.dev и подтвердите свой email.
  2. (Рекомендуется) Включите 2FA в разделе Settings → Security — TOTP с кодами восстановления, хешированными Argon2.
  3. Ваш аккаунт начинает работу на тарифе, который определяет ваши квоты (мониторы, status-страницы, серверы, места в команде, срок хранения и объём observability).

Работаете с командой? Приглашайте людей в разделе Settings → Team и назначайте роли (owner, admin, member, viewer). Количество мест привязано к вашему тарифу.

Шаг 2 — Добавьте первый монитор

Монитор наблюдает за одним эндпоинтом или ресурсом с распределённых probe.

  1. Перейдите в Dashboard → Monitors → Create (/dashboard/monitors/create).
  2. Выберите тип — HTTP/HTTPS, SSL, TCP, Ping, DNS или Server.
  3. Заполните основные поля:
    • Name — понятная человеку метка, например Marketing site
    • Target — URL, хост или запись для проверки, например https://example.com
    • Interval (interval_seconds), Timeout (timeout_seconds), Retries (retry_count)
    • Probe servers — одна или несколько локаций для проверки
  4. Задайте опции, зависящие от типа, если они применимы:
    • HTTP/HTTPS: method, expected_status, expected_string, headers, follow_redirects
    • SSL: alert_days_before_expiry
    • TCP: port
    • DNS: dns_record_type, dns_expected
  5. Сохраните. Монитор отображается как pending, пока не придёт первая проверка, после чего переключается в up или down.

Предпочитаете API? Создайте пользовательский API-токен в разделе Settings → API и выполните POST к User API:

curl -X POST https://api.statusradar.dev/v1/monitors \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"http","name":"Marketing site","target":"https://example.com","interval_seconds":60}'

→ Полные подробности: Обзор мониторов

Шаг 3 — Установите агента на сервер

Чтобы мониторить сервер изнутри (CPU, память, диск, сеть и сервисы), установите агента StatusRadar.

  1. Перейдите в Dashboard → Servers → Add (/dashboard/servers/add), чтобы получить токен агента.
  2. На сервере запустите однострочный установщик, указав ваш токен в переменной окружения TOKEN:
TOKEN='your-agent-token' bash -c "$(curl -sL https://statusradar.dev/install-agent.sh)"
  1. Чтобы мониторить и сервисы, включите плагины при установке. Настройки плагинов передаются как переменные окружения:
PLUGINS='redis,nginx' \
REDIS_HOST='localhost' REDIS_PORT='6379' \
NGINX_STATUS_URL='http://127.0.0.1/nginx_status' \
TOKEN='your-agent-token' \
bash -c "$(curl -sL https://statusradar.dev/install-agent.sh)"

Установщик скачивает агента в /opt/statusradar, записывает файл окружения shell в /opt/statusradar/config.env, создаёт systemd-сервис statusradar-agent и начинает сбор метрик. Убедитесь, что он работает:

sudo systemctl status statusradar-agent

Затем обновите страницу Dashboard → Servers, чтобы увидеть метрики в реальном времени. Чтобы добавить или изменить настройки плагинов позже, отредактируйте /opt/statusradar/config.env и выполните sudo systemctl restart statusradar-agent.

Требования: Linux с Python 3.6+. Установщик автоматически определяет ваш менеджер пакетов (apt, dnf/yum, zypper, pacman, apk). Windows и macOS не поддерживаются.

→ Полные подробности: Установка агента

Шаг 4 — Создайте status-страницу

Опубликуйте страницу, чтобы ваши пользователи могли видеть состояние вашего сервиса.

  1. Перейдите в Dashboard → Status Pages → Create (/dashboard/status-pages/create).
  2. Задайте:
    • Slug — сегмент публичного URL; страница находится по адресу /status/{slug}
    • Visibility — публичная или приватная
    • Theme — основной цвет и верстка
    • History — сколько дней доступности показывать (show_history_days: 30, 60, 90, 180 или 365)
  3. Сохраните, затем назначьте мониторы странице на экране управления мониторами.
  4. Поделитесь публичным URL, например https://statusradar.dev/status/your-slug.

→ Полные подробности: Настройка status-страниц

Шаг 5 — Настройте оповещения

Узнавайте о любой поломке в момент её возникновения.

  1. Добавьте каналы уведомлений в разделе Dashboard → Alerts — email, Slack, Telegram, Discord, webhooks, SMS или голосовой звонок.
  2. Настройте, когда срабатывают оповещения:
    • Пороги сбоя / восстановления — сколько подряд идущих сбоев запускает оповещение и когда восстановление его снимает
    • Истечение SSL — предупреждать до того, как сертификат истечёт
    • Обнаружение аномалий — ML-оповещения о необычном времени отклика, частоте ошибок или использовании ресурсов
  3. Выберите, какие каналы использует каждое оповещение; группировка и троттлинг снижают шум.

При срабатывании оповещение может открыть инцидент, который вы подтверждаете и устраняете, публикуя обновления, отображающиеся на вашей status-странице.

→ Полные подробности: Обзор оповещений

Всё готово и работает

Теперь у вас есть внешний монитор, мониторируемый сервер, публичная status-страница и оповещения, подключённые к вашей команде. Отсюда можно углубиться дальше:

Дальнейшие шаги