Чек-лист перед обращением в техническую поддержку
Описание
Для получения качественной и быстрой помощи в обращении необходимо указать версии всех компонентов системы и собрать логи. Ниже описаны проверки работоспособности системы. Рекомендуется использовать после установки системы, крупных обновлений и при исправлении ошибок.
Чек-лист корректности настройки системы мониторинга
- Найдены все устройства в сети.
- У всех принтеров и МФУ корректно отображаются модели.
- По всем принтерам и МФУ корректно отображаются серийные номера.
- По всем цветным принтерам и МФУ отображаются показания цветного счётчика.
- По всем принтерам подгружаются запчасти из базы (корректные русские названия, тип — «расходные материалы» или «ресурсные запчасти»).
- По всем принтерам есть данные по оставшемуся ресурсу расходных материалов, полученных от устройства (в столбце «Оставшийся ресурс» для деталей с типом «Расходные материалы» отображается иконка «принтер»).
- Нет запчастей с типом «Другое».
- Не отображаются одновременно несколько картриджей одного цвета и разной ёмкости.
Как определить версии компонентов
Мониторинг и ПринтМенеджер
В терминале сервера введите команды:
cat /opt/printum/.version
cat /opt/printmanager/.version
Клиент ПМ (Windows)
- Перейдите в папку с Клиентом ПМ:
C:\Program Files\printum\printmanager_client\ - Откройте свойства файла
as_service.exe. - Перейдите во вкладку «Подробно». В графе «Версия файла» указана версия программы.
Сбор логов
Мониторинг и ПМ
Если установлен Мониторинг и ПринтМенеджер или только Мониторинг:
bash /opt/printum/logs.sh
Если установлен только ПринтМенеджер:
bash /opt/printmanager/logs.sh
Если Мониторинг или ПринтМенеджер установлен с включённым шифрованием .env:
sudo -E ENV_VAULT_PASSWORD=<password> bash /opt/printum/logs.sh
или
sudo -E ENV_VAULT_PASSWORD=<password> bash /opt/printmanager/logs.sh
После завершения выводится сообщение вида:
Логи успешно собраны и сохранены в /путь_к_каталогу/ALL_LOGS/logs-2023-12-06-17-14-44.tar.gz
Собранные логи сохраняются в папке ALL_LOGS в виде архивов. При повторном запуске команды создаются новые архивы — ранее сформированные файлы не перезаписываются.
Включение режима DEBUG
- Перейдите в директорию нужного продукта:
- Мониторинг:
cd /opt/printum/ - ПринтМенеджер:
cd /opt/printmanager/
- Мониторинг:
- Откройте файл
.env:sudo nano .env - Измените параметры:
DEBUG=True
LOG_LEVEL=DEBUG
- Перезапустите контейнеры:
sudo docker-compose down && sudo docker-compose up -d
Что указать в обращении
- Версии всех компонентов: Мониторинг, ПринтМенеджер, Клиент ПМ.
- Архив с логами.
- Описание симптомов и шагов для воспроизведения.
- Модель и IP-адрес устройства (при проблемах с конкретным МФУ).
- Ошибки идентификации из столбца «Ошибки идентификации» (при проблемах с обнаружением).