DRX AI OPS Обсудить задачу

Наша разработка · Открытый код · Плагин для Claude Code

ИИ-агент для администратора Directum RX

Десять скилов, по которым агент разбирает инцидент, читает логи, проверяет PostgreSQL, RabbitMQ, Elasticsearch и бэкапы, готовит обновление и считает железо. Сначала смотрит сам, а перед любым изменением спрашивает вас.

В логе «sorry, too many clients already», что делать?
Кончились соединения PostgreSQL. Сейчас проверю, кто их держит: запрос к pg_stat_activity только читает. Если виноваты зависшие транзакции, покажу команду и спрошу, прежде чем их закрывать.
Хватит ли диска на пять лет при 400 документах в день?
При файле 1,2 МБ, полутора версиях и росте потока 10 % в год данных будет 1,2 ТБ. Том с запасом 1,7 ТБ, под две копии бэкапа ещё 2,5 ТБ.

Что знает агент

Скил это инструкция для агента: что проверить, какими командами, что считать нормой и куда идти дальше. Агент подгружает нужный сам, когда вопрос попал в его тему.

Разбор инцидента

«RX лежит», «всё тормозит», «у пользователей ошибки»: ресурсы сервера, контейнеры, зависимости, недавние изменения. Через 15 минут гипотеза и передача в нужный скил.

Логи и база ошибок

Где лежат логи RX и как их читать. Скрипт сверяет журналы с базой из 200 с лишним известных ошибок и сразу показывает разбор и что сделать.

PostgreSQL

Соединения, блокировки и дедлоки, autovacuum и wraparound, рост pg_wal и архив WAL, реплики, медленные запросы. Проверки одним скриптом через psql.

RabbitMQ

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

Elasticsearch

Красный кластер, блокировка записи по диску, куча и лимиты шардов, индексирование документов RX и версия, которую поддерживает вендор.

Обновление с откатом

Тестовый контур, бэкап, проверки до и после, критерии и порядок отката. Агент ведёт по шагам и само обновление не запускает.

Проверка бэкапа

Что входит в бэкап RX кроме базы, свежий ли он и восстановится ли на самом деле: инвентаризация копий и порядок пробного восстановления.

Самооценка ИБ

Опросник с весами и проверки хоста: SSH, auditd, сетевой экран, секреты в конфигах, сроки сертификатов. Итог в красной, жёлтой и зелёной зонах.

Сайзинг

Серверы и диски по числу пользователей, рост хранилища документов, настройки PostgreSQL, RabbitMQ и Elasticsearch. Те же формулы, что в калькуляторах на этом сайте.

Справка вашей версии

Ставит и проверяет rxmcp: агент отвечает по справке Directum RX той версии, что стоит у вас, и называет статью.

Знания взяты из наших статей и справочника ошибок, проверены на настоящих PostgreSQL, RabbitMQ и Elasticsearch. Справочник ошибок

Две команды в Claude Code

Агент работает там, где запущен: на сервере RX, на вашей машине с доступом к серверам по SSH или в контейнере с клиентами psql, curl и kubectl.

  1. Добавьте каталог плагинов

    /plugin marketplace add drxinfra/rxops

    В сессии Claude Code или из терминала: claude plugin marketplace add drxinfra/rxops.

  2. Установите плагин

    /plugin install rxops@drxinfra

    Скилы и хуки подключатся после перезапуска сессии.

  3. Спросите, как спросили бы коллегу

    «С утра у всех тормозит веб-клиент, разберись». Нужный скил агент возьмёт сам, явно вызывается так: /rxops:rx-incident.

Без GitHub и без интернета. Скачайте архив ниже, сверьте сумму, распакуйте и запустите claude --plugin-dir /путь/к/rxops. Скрипты скилов написаны на Python и bash без внешних пакетов и работают на Astra Linux и РЕД ОС как есть.

Claude Desktop и claude.ai

Каждый скил есть в релизе отдельным архивом, его загружают в настройках приложения (Settings → Capabilities → Skills). Хуков там нет, поэтому подтверждение изменений и маскировка паролей держатся на инструкциях скилов.

Другие агенты

Скилы написаны в открытом формате Agent Skills: папка с файлом SKILL.md и скриптами. Агент, который понимает этот формат, может взять их как есть. Проверяли мы только в Claude Code.

Скачать версию 0.1.1

Весь плагин одним архивом. Те же файлы и каждый скил по отдельности лежат в Releases на GitHub вместе с исходниками. Здесь зеркало на случай, если GitHub из вашей сети недоступен.

Контрольные суммы SHA-256
rxops e8a62d28e2b050632cb2e49f4179d104fdf7f3957882d2bf0053a21b96d58edd
rx-backup-check b90ca0cc2a3c02452a1a92459367784ceb8635063e96e8eff8bfa548a77c929d
rx-connect 0efd462d5945509b22d4e6522cfab2cfc00a68aef35a930d1c5ecf9c1017d687
rx-elasticsearch 79113a1b8ad40d097fc166b40cc60e5c980f39bcec3a9966c97351f4324998a8
rx-incident 37b7883c05344569b64c8af3c75d5e8e11b2ebe79aef0f68ee91dd2a67196487
rx-logs d6fb553694c19f32230d05a40a7920b1c17ea8fae96bfae8123667bbf1412926
rx-postgresql 8fc13b757f076131874cebf1148dffe1fae62e09df8a77512f07bb6ae969c25a
rx-rabbitmq 0b1a18edb148ea720462d702af3f6f6ee73bb73f4d495cd0b3fded8bf39f2088
rx-security-check cc2c21462922fb05380a942adf503d47579115059a02d1bc696c01ebcfb437be
rx-sizing 0bd0e79970bfc1fdb2dfc4de998b90c1dc442c49257da0d29935bbe582a81cf2
rx-update 055cc6950ddb55015cc23618c3a285d10c9c39b47c02fd4a32bef994f8262f6c

Что агент может и чего не может

Код и тексты открыты под лицензией Apache-2.0: служба безопасности может прочитать всё, что агент получит в инструкциях.

Сначала смотрит

Каждый скил начинается с правила: сначала только чтение. Скрипты проверок ничего не перезапускают, не удаляют и не меняют.

Спрашивает перед изменениями

Перед systemctl restart, docker compose down, kubectl apply, записью в базу, очисткой очереди, удалением в системных каталогах и установкой пакетов Claude Code показывает команду и ждёт вашего подтверждения, даже в автоматическом режиме. Форматирование дисков агенту запрещено совсем.

Пароли не уходят модели

Вывод команд, прочитанные файлы и результаты поиска проходят через маскировщик до того, как их увидит модель: пароли, токены, ключи и строки подключения заменяются на «‹скрыто›». Проверили в Claude Code: модель получает маску вместо значения.

Где защита заканчивается

Хуки работают только в Claude Code и требуют python3 на машине, где запущен агент. Проверка команд построена на шаблонах, и необычно записанную команду она может пропустить. В режиме полного обхода разрешений на подтверждение не рассчитывайте.

Что уходит в ИИ-сервис и как это закрыть настройками. Разбор в блоге

Что спрашивают перед установкой

Что нужно, чтобы начать?

Claude Code с подпиской Claude или ключом API и доступ к серверам RX оттуда, где запущен агент. Со стороны Directum RX ничего ставить не надо. Для ответов по справке своей версии подключите rxmcp, скил rx-connect проведёт по шагам.

Агент может что-то сломать?

Скилы требуют сначала смотреть, а изменения делать только после вашего согласия. Хук Claude Code дополнительно останавливает команды, которые меняют систему, и показывает их вам. Работайте на тестовом контуре, пока не привыкнете к тому, как агент рассуждает, и не запускайте его с полным обходом разрешений на рабочих серверах.

Куда уходят логи и конфиги?

В тот ИИ-сервис, которым вы пользуетесь, вместе с вашим вопросом. Пароли и токены хук прячет до отправки. Остальное содержимое логов и конфигов уходит как есть, поэтому решение о внешнем сервисе остаётся за вашей службой ИБ. Для закрытого контура нужна локальная модель.

Можно в закрытом контуре с локальной моделью?

Скилы это текстовые файлы и скрипты, их можно унести в контур архивом. Мы проверяли их с моделями Claude. Агента с локальной моделью для закрытого контура настраиваем при внедрении, как это выглядит, показано в демо.

Чем это отличается от скилов для разработчиков?

Есть наборы скилов для разработки на платформе Directum: создать модуль, собрать решение, проверить код. rxops про эксплуатацию: серверы, база, брокер, поиск, обновления, бэкапы и защищённость. Наборы не пересекаются и могут стоять рядом.

Почему бесплатно и открыто?

Это витрина: мы сопровождаем инфраструктуру Directum RX и показываем, как работаем. Скилы ваши, обязательств нет. Нашли ошибку или не хватает проверки, напишите на GitHub.