Диагностика

Если в Gramax что-то работает не так, поддержка попросит прислать логи или поднять уровень логирования и повторить проблему. Уровень логирования и экспорт логов настраиваются в Настройки → Приложение → Диагностика.

Как снять лог для проблемы

Логи пишутся только с момента, когда включен нужный уровень — задним числом ничего не восстановить. Поэтому:

1. Поднимите уровень логирования до того, как будете повторять проблему, а не после.

2. Повторите шаги, которые приводят к проблеме.

3. Сразу выгрузите логи через Экспорт логов — пока не перезапустили приложение и не закрыли сессию.

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

Уровень логирования

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

Уровни от менее подробного к более подробному, каждый следующий включает предыдущий:

• Выключено — логи не записываются.

• Команды — выполнение команд, запуск приложения, высокоуровневые действия, падения.

• Важные — значимые шаги внутри команд: публикация, синхронизация, статус автопулла, подключение и отключение от сервера.

• Внутренняя логика — внутренняя работа с Git, каталогом и файловой структурой, а также ключевые операции чтения.

• Взаимодействие с файлами — дополнительно операции записи файлов.

• Полные — вообще все операции, включая чтение. Самый подробный и самый тяжелый уровень.

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

Рядом с уровнем можно включить Выводить логи в консоль, чтобы дублировать их в консоль разработчика (F12 -> Console).

Экспорт логов

В том же разделе, в блоке Устранение неполадок, нажмите Экспорт логов и выберите период:

• Текущая сессия — логи с момента последнего запуска приложения.

• Сегодня.

• Последние 7 дней.

• Все — весь доступный архив логов, самый тяжелый вариант.

Gramax соберет архив и предложит сохранить его на компьютер. Приложите этот архив к обращению в поддержку или к отчету об ошибке.

В десктопной версии экспортировать логи можно также через меню Помощь → Экспортировать журнал событий, выбрав тот же период.