Что спросить у ИИ-ассистента
ИИ-ассистент, подключённый к Наблюдателю по MCP, понимает обычные вопросы: не нужно знать названия вкладок, инструментов и полей. Ниже — примеры запросов по сценариям: что можно попросить, что ассистент сделает сам и где он спросит вашего подтверждения. Как подключить ассистента — в статье MCP-сервер.
Лучше всего ассистент работает, когда открыт в вашем репозитории (Claude Code, Cursor): он видит docker-compose.yml, манифесты и код и может сразу внести изменения — добавить агента, подключить трассировку, отправку событий или страницу метрик.
Как ассистент работает с вашими данными
- Начинает со сводки. Обычно ассистент сначала смотрит ваши проекты и сводку по нужному проекту, а потом углубляется в стек, сервис, контейнер.
- Сверяется с руководствами. Прежде чем менять конфигурацию вашего приложения, ассистент читает встроенные руководства Наблюдателя и проверяет, что в стеке уже работает.
- Подбирает пороги по истории. Для правил уведомлений ассистент смотрит фактическую нагрузку за прошлые дни, а не ставит пороги наугад.
- Говорит, если не хватает прав. С ключом «Только чтение» он ничего не меняет и предложит значения, которые вы зададите сами.
Подключить мониторинг
Запросы:
- «Подключи этот проект к Наблюдателю. Изучи код и docker-compose в репозитории, создай проект и стек, добавь агента в docker-compose, заведи проверки публичных адресов, подключи сбор ошибок и трассировку, настрой уведомления в Telegram. Перед правкой кода покажи, что собираешься менять» — этот промпт кабинет предлагает новому пользователю на странице «Обзор»
- «Подключи мониторинг к моему docker-compose и присылай алерты в Telegram»
- «Поставь агента на новый сервер и подключи его к проекту shop»
- «Подключи сервер db-01 к проекту shop» или «Отключи старый сервер от проекта»
- «У нас production и staging в Kubernetes, в разных namespace. Как лучше разложить их в Наблюдателе?»
- «Подключи трассировку к моему приложению на FastAPI»
- «Какие очереди и фоновые задачи в этом репозитории стоит собирать как метрики?»
- «Отправляй журнал запросов к платёжному шлюзу как поток событий»
- «Подключи бакет с бекапами и предупреждай, если свежий бекап не появился»
- «Подключи мой локальный проект, чтобы смотреть запросы к базе при разработке»
Что сделает ассистент: объяснит, как разложить окружения по проектам и стекам (подробнее), создаст проект и стек или сервер вместе с агентом. Он добавит сервис агента в ваш docker-compose.yml или подготовит манифест Kubernetes, команду установки на сервер. Затем проверит, что агент подключился и данные пошли. Для трассировки, событий и метрик ассистент подскажет или сам внесёт изменения в код. После подключения он сам предложит пройти по слепым зонам проекта — что ещё не видно и кто это закрывает. Часть он закроет сам, например создаст HTTP-проверку или свяжет стек с сервером. Для другой нужна правка в приложении — подключить OpenTelemetry или экспортер метрик базы: ассистент подскажет, а в вашем репозитории сделает. Для третьей нужна команда на сервере — ассистент её покажет. В конце он проверит, что каждая зона закрылась. Подробнее — Карта проекта.
Токен агента показывается один раз. Ассистент получает его при создании стека или сервера и сразу вписывает в конфигурацию. Если токен потерян, ассистент может выпустить новый — старый при этом перестанет работать, поэтому он спросит вас. Если у стека или сервера агента нет, ассистент выпустит нового агента с инструкцией установки.
Настроить уведомления
Запросы:
- «Какие правила уведомлений уже есть в проекте и какие из них выключены?»
- «Включи уведомления о заполнении диска с порогом по нашей истории»
- «Алерты по диску шумят каждую ночь. Подбери нормальный порог»
- «Присылай в рабочий чат только ошибки, а предупреждения — на почту»
- «Предупреди, если очередь писем больше 1000 дольше 10 минут»
- «Добавь проверку https://shop.example.ru каждые 30 секунд»
- «Отправь тестовое уведомление в Telegram»
- «Какая цель у сервиса заказов и сколько осталось запаса?»
- «Задай сервису заказов цель: p95 не больше 300 мс, ошибок не больше 1%»
Что сделает ассистент: покажет действующие правила и сколько раз каждое срабатывало за неделю, найдёт шумные. По истории метрик он предложит порог и включит или изменит правило, настроит уровни и фильтр каналов, создаст HTTP-проверку и отправит тестовое сообщение. Цель сервиса ассистент подберёт по тому, как сервис держал её за сутки и неделю, и задаст после вашего согласия; так же вернёт автоматическую цель. Подробнее — Аномалии и поиск причины.
Токен бота Telegram или MAX ассистент не принимает: его один раз указывают в кабинете, «Управление» → «Уведомления». Подробнее — Каналы уведомлений и Правила уведомлений.
Разобрать сбой
Запросы:
- «Почему ночью упал api в проекте shop?»
- «Почему ночью перезапускался контейнер api?»
- «Что сейчас не так в проекте shop?»
- «Сайт отвечал медленно с 14:00 до 14:20. Что случилось?»
- «Какие ошибки появились после последней выкатки?»
- «Почему на сервере db-01 закончилось место?»
- «Найди в логах контейнера api запрос с id 7f3a…»
Что сделает ассистент: начнёт с поиска причины — пройдёт от сервиса вниз по зависимостям и соберёт улики за час: аномалии сервисов и запросов к базе, выкатки, падения и OOM контейнеров, заполненные диски, события серверов. С агентом сервера 0.14 на машине стека поиск проходит и через базы и очереди, которые сервисы вызывают без трассировки. Детали он проверит по метрикам контейнера, логам, ленте событий и трассам. Строку в логе контейнера, например id запроса, ассистент ищет по последним 5000 строкам — для этого агент стека должен быть на связи. В ответе будет цепочка «симптом ← … ← причина» и предложение, как исправить, вплоть до правки в коде.
Если уведомление пришло с вероятной причиной, ассистент видит её в событии и может перепроверить. Подробнее — Аномалии и Лента событий.
Найти медленные запросы
Запросы:
- «Какие запросы к базе самые медленные?»
- «Какие запросы к базе тормозят checkout?»
- «Есть ли N+1 в сервисе заказов?»
- «Как дела у сервиса заказов за последний час по сравнению со вчера?»
- «Кто вызывает сервис заказов и где растут ошибки?»
- «Покажи самые долгие запросы к API за сутки»
Что сделает ассистент: найдёт медленные и ошибочные операции, самые долгие трассы и разберёт одну из них — какой запрос к базе или вызов другого сервиса занял время. По карте сервисов покажет, кто кого вызывает. Вызовы внешних сервисов в новых трассах подписаны адресом, например «POST api.partner.ru/v1/orders», поэтому ассистент различает, какой из внешних API тормозит. Если открыт ваш репозиторий, предложит исправление в коде. Для этого в стеке должна работать трассировка — Трассировка, Запросы к базе данных.
События и логи приложения
Запросы:
- «Какие входы пользователя не прошли за последние сутки?»
- «Какой партнёр чаще всего отвечал 500 на этой неделе?»
- «Сколько платежей было вчера, с разбивкой по статусу?»
- «Найди в журнале запросов request id 7f3a…»
- «Дай потоку понятное название и выбери колонки для таблицы»
Что сделает ассистент: посмотрит поля и частые значения потока, найдёт записи по фильтру, посчитает и разобьёт их по полю за 24 часа, 7 или 30 дней. Если приложение пишет в записи trace_id, ассистент по трассе увидит записи всех потоков с этим trace_id — что пришло в запросе и что ответили. Может переименовать поток, выбрать колонки таблицы и убрать лишние поля. Записи потоков хранятся 30 дней. Подробнее — Потоки событий.
Метрики серверов, контейнеров и свои
Запросы:
- «Что сейчас грузит процессор на сервере web-01?»
- «Хватит ли места на диске до конца месяца?»
- «Сколько памяти потребляет контейнер worker за неделю?»
- «Покажи длину очереди emails за сутки»
- «Назови метрики понятно и проставь единицы»
Что сделает ассистент: возьмёт текущий снимок от агента (топ процессов, давление на память, сеть), историю заполнения дисков, метрики контейнера за период или ряд своей метрики. Может задать название и единицы метрики. Подробнее — Серверы, Контейнеры и поды, Свои метрики.
Ошибки приложения
Запросы:
- «Какие ошибки сейчас открыты в стеке prod?»
- «Разбери эту ошибку и предложи исправление»
- «Эта ошибка исправлена — отметь её решённой»
- «Заглуши ошибку про таймаут healthcheck»
Что сделает ассистент: покажет сгруппированные ошибки со стек-трейсом, частотой по часам, контейнерами и версиями, найдёт место в коде. Может отметить ошибку решённой или заглушить её. Подробнее — Ошибки приложений.
Поддержка
Запросы:
- «Агент не подключается по инструкции — напиши в поддержку»
- «Есть ли ответ по моему обращению?»
- «Вопрос решён, закрой обращение»
Если ассистент упирается в ошибку Наблюдателя или нужной возможности нет, он сам предложит написать в поддержку. Он соберёт подробности — что вы хотели сделать, что получилось, тексты ошибок, — покажет черновик и отправит только после вашего согласия. Ответ поддержки ассистент перескажет и продолжит задачу. Обращаться в поддержку можно и с ключом «Только чтение». Подробнее — Поддержка.
Что ассистент делает сам, а что — после подтверждения
| Действие | Как |
|---|---|
| Смотреть данные: сводки, метрики, логи, трассы, события, настройки | сам, с любым ключом |
| Создавать и менять: проекты, стеки, серверы, проверки, правила, каналы, метрики, потоки | сам по вашей просьбе, нужен ключ «Редактирование и удаление» и роль «Редактор» или «Владелец» в проекте |
| Выпустить агенту новый токен | спросит: старый токен сразу перестаёт работать |
| Удалить проверку, правило, источник метрик, поток, S3-хранилище, сервер; отключить сервер от проекта | только после вашего подтверждения — удаление необратимо |
| Отправить обращение в поддержку | покажет черновик и отправит после вашего согласия |
| Задать токен бота Telegram или MAX | не может — только вы в кабинете |
Многие клиенты дополнительно спрашивают разрешение перед каждым вызовом инструмента или перед изменениями — это настраивается в самом клиенте.
Что дальше
- MCP-сервер — выпустить ключ и подключить Claude, Cursor и других.
- Проекты, стеки и серверы — как ассистент раскладывает окружения.
- Правила уведомлений — какие правила уже есть в проекте.
Первый сервер или стек подключается за пару минут. Бесплатно в раннем доступе.
Нашли неточность или не хватает ответа? Напишите на hello@nablserver.ru