Как проверить, включена ли отладка на сервере 1С

Режим отладки на сервере 1С:Предприятие позволяет разработчикам пошагово выполнять серверный код, ставить точки останова и смотреть значения переменных. Но если отладка осталась включённой на рабочем (продуктивном) сервере, это замедляет выполнение серверных процедур и создаёт лишнюю нагрузку. Поэтому администратору важно уметь быстро определить, в каком режиме запущен сервер агента.

Проверить состояние отладки можно несколькими способами: через консоль администрирования кластера, по параметрам запуска службы агента сервера, через реестр Windows или systemd-юнит в Linux, а также косвенно — по подключению отладчика из конфигуратора. Ниже разобраны все рабочие методы для Windows и Linux, с признаками результата и типичными ошибками.

Что такое режим отладки сервера и почему его проверяют

Агент сервера 1С (процесс ragent) может быть запущен с ключом -debug. В этом случае рабочие процессы кластера (rphost) поддерживают подключение отладчика по протоколу TCP/IP, и разработчик может отлаживать код, исполняемый на сервере: серверные процедуры, фоновые задания, web-сервисы.

Без ключа -debug серверный код отлаживать нельзя — конфигуратор просто не увидит предметы отладки, выполняемые в кластере. Поэтому проверка режима нужна в двух ситуациях: когда отладка не работает, хотя должна, и когда на продуктивном сервере подозревают, что отладку забыли выключить.

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

Проверка через консоль администрирования кластера

Самый наглядный способ — стандартная консоль «Администрирование серверов 1С:Предприятия» (оснастка MMC на Windows или консоль на Linux). Откройте консоль, подключитесь к нужному серверу и разверните дерево: «Кластеры» → нужный кластер → «Рабочие серверы».

Откройте свойства рабочего сервера (двойной щелчок). В параметрах запуска рабочих процессов видно, запущен ли сервер в режиме отладки, — при включённой отладке в свойствах фигурирует соответствующий признак и порт отладки. Также в свойствах каждого рабочего процесса (ветка «Процессы») можно увидеть, включён ли для него режим отладки и по какому протоколу.

Если консоль не установлена на вашем компьютере, её можно запустить с любой машины, где стоит дистрибутив сервера 1С той же версии платформы, что и кластер, — подключение выполняется по имени сервера и порту агента (по умолчанию 1540).

1. 1
   Откройте оснастку «Администрирование серверов 1С:Предприятия»
2. 2
   Подключитесь к серверу: «Центральные серверы 1С» → добавить сервер по имени или IP
3. 3
   Разверните кластер и откройте ветку «Рабочие серверы», затем свойства сервера
4. 4
   Проверьте признак режима отладки и порт отладки в свойствах
5. 5
   Дополнительно откройте «Процессы» и проверьте параметры каждого rphost

Проверка по параметрам запуска службы агента сервера

Windows: служба и реестр

В Windows агент сервера обычно работает как служба «Агент сервера 1С:Предприятия». Откройте «Службы» (services.msc), найдите службу нужной версии платформы и посмотрите её свойства — поле «Исполняемый файл» покажет полную командную строку запуска. Если в строке присутствует параметр -debug, отладка включена.

Ту же строку можно посмотреть в реестре без открытия служб: ключ HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\1C:Enterprise 8.3 Server Agent (имя зависит от версии и порта), параметр ImagePath. Это удобно для быстрой проверки удалённо или скриптом.

sc qc "1C:Enterprise 8.3 Server Agent (x86-64)"

Команда sc qc выведет конфигурацию службы, включая BINARY_PATH_NAME — полную строку запуска. Ищите в ней -debug. Если параметра нет — сервер работает в обычном режиме.

Linux: юнит systemd и процессы

В Linux проверьте командную строку работающего процесса агента. Команда ps aux | grep ragent покажет все параметры запуска. Просмотрите также unit-файл службы: systemctl cat srv1cv83 (имя юнита зависит от способа установки) — параметры запуска обычно вынесены в переменные окружения или указаны прямо в ExecStart.

ps aux | grep ragent | grep -v grep

Проверка через подключение отладчика из конфигуратора

Практический способ без доступа к серверу — попытаться подключить отладку из конфигуратора. Откройте конфигуратор, меню «Отладка» → «Подключение». Если в списке доступных предметов отладки видны серверные процессы (тип «Сервер», «Фоновое задание» кластера), значит сервер запущен в режиме отладки.

Если серверных предметов отладки в списке нет и появиться они не могут, а клиентские сеансы видны — скорее всего, отладка на сервере выключена. Учтите, что для полноценной проверки в настройках отладки (меню «Отладка» → «Настройка») должны быть включены нужные типы предметов отладки и выбран протокол, совпадающий с настройками сервера.

Косвенные признаки и журналы

Косвенно режим отладки виден по открытым портам: при включённой отладке агент и рабочие процессы слушают дополнительные порты для подключения отладчика. Проверить прослушиваемые порты можно командами netstat -ano (Windows) или ss -tlnp (Linux) и сопоставить их с процессами ragent и rphost.

Технологический журнал и журнал регистрации напрямую не фиксируют режим отладки как отдельное событие, но события подключения отладчика и ошибки взаимодействия с ним могут отражаться в логах кластера (каталог srvinfo, подкаталоги reg_1541 и логи rphost). Это помогает установить, кто и когда пользовался отладкой, если возник вопрос о необоснованном включении режима.

Что делать, если отладка включена на продуктивном сервере

Если проверка показала, что продуктивный кластер работает с ключом -debug, запланируйте его отключение. Для этого нужно убрать параметр из строки запуска службы (в Windows — через реестр или переустановку службы утилитой с нужными параметрами, в Linux — правкой unit-файла) и перезапустить агент сервера.

Перезапуск агента останавливает рабочие процессы и разрывает все сеансы, поэтому операцию проводят в регламентное окно. Перед перезапуском предупредите пользователей, завершите фоновые задания и убедитесь, что нет активных транзакций. После перезапуска повторите проверку строки запуска — параметр -debug должен исчезнуть.

Для разработки и тестирования отладку держат включённой только на тестовых серверах. Хорошая практика — отдельный кластер или отдельный сервер под разработку, чтобы режим отладки физически не мог оказаться включённым там, где работают пользователи.

FAQ