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

Эта статья проведёт от регистрации до первых графиков и первого уведомления в Telegram. Мониторинг Docker Compose, Kubernetes или сервера Linux подключается одинаково: создаёте проект и стек (или сервер), получаете агента с готовой командой установки и запускаете её. Обычно на всё уходит около пяти минут, первые данные приходят примерно через минуту после запуска агента.

Всё то же самое можно сделать одним сообщением ИИ-ассистенту: новому пользователю кабинет сам предлагает этот путь на странице «Обзор». Как это устроено — в последнем разделе, а по шагам ниже описан ручной путь.

#Шаг 1. Зарегистрируйтесь

Откройте app.nablserver.ru/signup и заполните форму «Создание аккаунта»:

1. «Email» — рабочая почта.
2. «Пароль» и «Подтверждение пароля» — не короче 8 символов, со строчной и заглавной латинской буквой и цифрой.
3. Отметьте согласие с пользовательским соглашением и согласие на обработку персональных данных.
4. Нажмите «Создать аккаунт».

Подтверждать почту не нужно: после регистрации вы сразу попадаете в кабинет. Карта не нужна, в раннем доступе всё бесплатно. Подробнее — в статье Аккаунт и тарифы.

#Шаг 2. Создайте проект

Проект объединяет окружения одного продукта и задаёт, куда приходят уведомления.

1. Пока проектов нет, на странице «Обзор» показано подключение через ассистента. Чтобы создать проект вручную, нажмите «Создать проект вручную» в блоке «Без ассистента». Если проекты уже есть — «Новый проект».
2. Укажите «Название», например Магазин, и при желании «Описание».
3. Нажмите «Создать».

В новом проекте сразу заведены типовые правила уведомлений: сайт недоступен, контейнер упал или нездоров, нехватка памяти (OOM), частые перезапуски и другие. Остаётся подключить канал, куда их присылать, — это шаг 6.

Не уверены, как разложить production, staging и несколько продуктов, — загляните в Проекты, стеки и серверы.

#Шаг 3. Добавьте стек

Стек — одно окружение приложения: один Docker Compose или один namespace в Kubernetes.

1. Откройте проект и нажмите «Добавить».
2. В окне «Добавить в «Магазин»» укажите «Название», например prod.
3. Нажмите «Создать».

Если нужно следить только за машиной целиком (диски, память, процессор), вместо стека добавьте сервер: раздел «Серверы» в меню → «Добавить сервер» → «Название» и, по желанию, «Основной IP» → «Создать».

#Шаг 4. Установите агента

На странице нового стека появится предупреждение «Агент не привязан».

1. Нажмите «Создать агента», введите «Название агента» и нажмите «Создать».
2. Скопируйте токен из поля «Bearer Token». Он показывается один раз — сохраните его, если будете ставить агента не прямо сейчас.
3. В блоке «Где работает стек» выберите «Docker Compose» или «Kubernetes» и выполните инструкцию.

#Docker Compose

Скопируйте блок «Сервис для docker-compose.yml» и добавьте сервис nabl-agent в раздел services: вашего docker-compose.yml, рядом с остальными сервисами. Токен и адрес платформы уже подставлены. Затем запустите:

docker compose up -d nabl-agent

Агенту нужен доступ к /var/run/docker.sock — строка монтирования уже есть в блоке. Через него агент видит контейнеры стека. Подробности, ограничения ресурсов и порты для трасс и логов — в статье Агент для Docker Compose.

#Kubernetes

Укажите «Namespace», за которым нужно следить, скопируйте «Манифест nabl-agent.yaml» в файл и примените:

kubectl apply -f nabl-agent.yaml

Агент ставится в тот же namespace и читает поды через ServiceAccount — нужные права уже в манифесте. Графики CPU и памяти появятся, если в кластере есть metrics-server. Подробнее — Агент в Kubernetes.

#Сервер Linux

На странице сервера нажмите «Создать агента» — вы получите «Команду для Linux (systemd)». Выполните её на сервере:

curl -fsSL https://nablserver.ru/install.sh | sudo -E env NABL_AGENT_TOKEN=<токен> NABL_BASE_URL=https://app.nablserver.ru sh

Команда ставит агента как службу nabl-agent. Если на этой машине уже работает стек со своим агентом, Наблюдатель сам свяжет стек с сервером — в шапке стека у сервера появится пометка «авто». Подробнее — Агент на сервере Linux.

Порты открывать не нужно. Агент сам подключается к Наблюдателю исходящим защищённым соединением.

#Шаг 5. Проверьте, что данные пошли

Окно создания агента можно не закрывать: внизу видно «Ждём первое подключение агента…», а когда агент подключится — «Агент на связи — данные начали поступать». Обычно это занимает до минуты.

Дальше на странице стека появятся вкладки:

• «Контейнеры» (Docker Compose) или «Поды» (Kubernetes) — статусы, CPU, память, сеть, перезапуски;
• «Консоль» — живые логи контейнеров;
• «Ошибки» — исключения и error-логи из stdout/stderr, сгруппированные по типу;
• «События» — лента событий стека.

Данные не появились — смотрите Если что-то не работает.

#Добавьте проверку сайта

Чтобы знать, что сайт или API отвечает, на странице стека нажмите «HTTP-проверку», укажите название, URL и интервал проверки и нажмите «Создать». Проверку выполняет сам Наблюдатель, агент для неё не нужен. Подробнее — HTTP-проверки.

#Шаг 6. Включите уведомления в Telegram

1. Создайте бота у @BotFather и скопируйте его токен.
2. Добавьте бота в чат или группу, куда должны приходить уведомления.
3. В проекте нажмите «Управление» и откройте вкладку «Уведомления».
4. Включите канал Telegram и заполните:
   • «Токен бота» — токен от @BotFather. Он сохраняется в защищённом виде и повторно не показывается;
   • «Чат или группа» — числовой id чата. У групп он часто начинается с -100.
5. В «О чём сообщать» отметьте уровни событий. По умолчанию включены «Успех», «Предупреждение» и «Ошибка», а «Инфо» выключено.
6. Нажмите «Сохранить», затем «Проверить отправку» — в чат придёт проверочное сообщение.

Так же настраиваются MAX и почта. Как узнать id чата и как отфильтровать уведомления — в статье Каналы уведомлений. Какие правила уже есть и как добавить свои — Правила уведомлений.

#Быстрый старт с ИИ-ассистентом

Если вы пользуетесь Claude Code, Cursor, Claude Desktop или другим ассистентом с поддержкой MCP, все шаги можно сделать одним сообщением в чате. Пока в аккаунте нет проектов, кабинет показывает этот путь прямо на странице «Обзор», в три шага:

1. «Создайте ключ для ассистента». Нажмите «Создать ключ». Ключ создаётся с правами на настройку и действует 90 дней. Скопируйте его сразу: после ухода со страницы он больше не показывается. Ключ уже подставлен в команду подключения.
2. «Подключите ассистента». Для Claude Code выполните команду из вкладки «Claude Code» в терминале. Для Cursor, Claude Desktop и других клиентов добавьте в настройки MCP конфиг из соседней вкладки. Когда ассистент сделает первый запрос, под командой появится «Ассистент подключён».
3. «Отправьте одно сообщение». Откройте ассистента в папке с вашим проектом, нажмите «Копировать промпт» и отправьте его. Промпт можно дополнить своими словами:

Подключи этот проект к Наблюдателю. Изучи код и docker-compose в репозитории, создай проект и стек, добавь агента в docker-compose, заведи проверки публичных адресов, подключи сбор ошибок и трассировку, настрой уведомления в Telegram. Перед правкой кода покажи, что собираешься менять.

Если приложение работает в Kubernetes или без Docker, допишите в промпт, где оно работает, — ассистент подберёт способ установки.

Ассистент прочитает встроенное руководство, создаст проект и стек вместе с агентом, добавит сервис агента в ваш docker-compose.yml, заведёт проверки сайтов и включит канал уведомлений. Страница «Обзор» обновится сама, когда появится первый проект. Токен бота Telegram ассистент не принимает — его один раз указывают в «Управление» → «Уведомления».

Ключ можно выпустить и в разделе «MCP» — там же выбираются права и срок действия. Подробно — MCP-сервер. Больше примеров — Что спросить у ИИ-ассистента.

#Что дальше

• Проекты, стеки и серверы — как разложить production, staging и несколько продуктов.
• Трассировка — понять, почему медленно, по пути запроса через сервисы и базу.
• Правила уведомлений — включить проверки диска, памяти и CPU с нужными порогами.
• MCP-сервер — подключить ИИ-ассистента.