Включение режима отладки (debug) на сервере 1С: полное руководство для администраторов

• 📝 Журнал регистрации — основные события (вход пользователей, ошибки).
• 🔧 Технологический журнал — детальная отладка (SQL-запросы, блокировки, транзакции).
• 🖥️ Журнал производительности — метрики использования ресурсов.
• Настройте уровень детализации:
  • Ошибки — только критические сбои.
  • Предупреждения — ошибки + предупреждения.
  • Информация — стандартный уровень (рекомендуется для большинства задач).
  • Отладка — максимальная детализация (используйте осторожно!).
• Укажите путь для сохранения логов (по умолчанию: C:\ProgramData\1C\1Cv8\logs на Windows или /var/log/1C на Linux).
• Примените настройки и перезапустите кластер (если требуется).

После активации логи начнут записываться в указанную директорию. Файлы имеют формат .log или .elf (для технологического журнала).

Убедитесь, что на диске достаточно места (минимум 10 ГБ свободного пространства)|Создайте резервную копию текущих логов (если они есть)|Определите конкретную задачу отладки (чтобы не собирать лишние данные)|Проверьте права доступа к папке с логами-->

Метод 2: Редактирование конфигурационных файлов

Этот способ подходит для опытных администраторов, так как требует прямого доступа к файловой системе сервера. Основные файлы конфигурации:

Пример редактирования файла srvinfo для включения максимальной отладки на Linux:

[common]
enable_log = true
log_level = 4  # 4 — максимальный уровень (debug)
log_location = /var/log/1C/debug
max_log_size = 1000  # Максимальный размер лога в МБ

После изменения файла необходимо перезапустить сервисы 1С:

• На Windows:

  net stop srv1cv83
  net start srv1cv83

• На Linux:

  systemctl restart srv1cv83

⚠️ Внимание: Изменение файлов srvinfo или ragent.conf без резервного копирования может привести к невозможности запуска кластера. Всегда сохраняйте оригинальные версии файлов!

Метод 3: Параметры запуска для временной отладки

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

Для Windows:

1. Откройте Службы (services.msc).
2. Найдите службу Агент сервера 1С:Предприятия 8.3.
3. В свойствах службы добавьте в поле Параметры запуска:

   -debug -d "C:\Logs\1C_Debug" -l 4

4. Перезапустите службу.

Для Linux:

1. Отредактируйте файл службы ragent:

   sudo systemctl edit srv1cv83

2. Добавьте параметры в секцию [Service]:

   ExecStart=
   ExecStart=/opt/1C/v8.3/x86_64/ragent -debug -d /var/log/1C/debug -l 4

3. Перезагрузите службу:

   sudo systemctl daemon-reload
   sudo systemctl restart srv1cv83

Параметры для отладки:

• -debug — включает режим отладки.
• -d <путь> — директория для логов.
• -l <уровень> — уровень детализации (0–4, где 4 — максимальный).
• -perf — включает сбор метрик производительности.

⚠️ Внимание: Параметры запуска, переданные через службу, могут конфликтовать с настройками в srvinfo. В таком случае приоритет имеют параметры, указанные при запуске.

Настройка фильтрации логов: что исключить из записей

Отладочные логи могут содержать конфиденциальную информацию: пароли, токены доступа, персональные данные клиентов. Чтобы избежать утечек, настройте фильтрацию через параметр log_exclude в файле srvinfo.

Пример фильтрации для 1С:Предприятие 8.3.22+:

[common]
log_exclude = password,token,secret,inn,снils,паспорт
log_mask_data = yes  # Маскирует чувствительные данные звёздочками (*)

Также можно ограничить логи по:

• 📅 Времени: log_rotate_time=24h (ротация логов каждые 24 часа).
• 📦 Размеру: max_log_size=500 (максимум 500 МБ на файл).
• 🗑️ Количеству: max_log_files=10 (не более 10 архивных логов).

В версиях 8.3.20–8.3.21 параметр log_mask_data работает нестабильно — чувствительные данные могут оставаться в логах даже после его активации. Проверяйте содержимое логов вручную!

Анализ и очистка логов после отладки

После завершения диагностики важно:

1. Отключить debug-режим, чтобы не нагружать систему.
2. Архивировать логи для дальнейшего анализа.
3. Очистить ненужные файлы, чтобы освободить место.

Команды для управления логами:

• Просмотр текущего размера логов (Linux):

  du -sh /var/log/1C

• Архивация логов старше 7 дней:

  find /var/log/1C -type f -mtime +7 -exec tar -czvf logs_archive.tar.gz {} +

• Очистка логов старше 30 дней:

  find /var/log/1C -type f -mtime +30 -delete

Для Windows можно использовать PowerShell:

Get-ChildItem "C:\ProgramData\1C\1Cv8\logs" -File | Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-30) } | Remove-Item -Force

⚠️ Внимание: Перед массовым удалением логов убедитесь, что в них нет критически важной информации для аудита или расследования инцидентов. В некоторых отраслях (например, финансы) хранить логи требует закон.

FAQ: Частые вопросы по debug на сервере 1С