# Встроенное приложение — диагностика проблем

<!--
title: Встроенное приложение — диагностика проблем
slug: kak-diagnostirovat-problemy-vstroennogo-prilozheniya
tags: [встроенное приложение, Встроенное приложение, диагностика, МФУ, Kyocera, Xerox, Ricoh, Lexmark, Pantum]
domain: Troubleshooting
type: Runbook
audience: partner-engineer
product_versions: "4.x"
status: ready
related_components: [Встроенное приложение, ПринтМенеджер, Мониторинг]
related_pages:
  - ts-vstroennoe-prilozhenie-ne-ustanavlivaetsya
  - ts-vstroennoe-prilozhenie-belyy-ekran
  - ts-zadaniya-ne-otobrazhaetsya-v-prilozhenii
  - ts-avtorizaciya-po-karte-ne-rabotaet-v-prilozhenii
  - ts-ricoh-postoyannyy-zapros-tokena
  - kak-rabotaet-avtorizaciya-na-mfu
-->

### Как устанавливается приложение

Автоматическая установка из Личного кабинета (кнопка «Установить приложение»):
- Xerox, Konica Minolta, HP, Sharp, Ricoh

Ручная установка через интерфейс МФУ с токеном:
- Kyocera, Lexmark, Pantum, Fplus, Lexmark, Avision

Настройка не требующая установки пакета приложений:
- Brother, Epson

Для получения инструкций по конкретному вендору и модели необходимо направить запрос в Техническую поддержку: support@printum.io

---

### Предусловия для работы приложения

Перед диагностикой убедиться, что выполнены все условия:

- Устройство добавлено в Мониторинг и опрашивается (статус не серый).
- У устройства есть лицензия **M** (мониторинг) + **PM** (управление печатью).
- Существует свободный слот лицензии **EMB** (встроенное приложение)
- Синхронизация Мониторинг–ПринтМенеджер выполнена (`Личный кабинет → Настройки → Интеграции → ПринтМенеджер`).
- МФУ доступен по сети с сервера ПринтМенеджера (проверить `ping <ip_мфу>` с сервера).
- Версия прошивки МФУ соответствует требованиям (запросить у ТП список совместимых прошивок).

---

### Алгоритм диагностики

**Шаг 1. Проверить лицензии**

ЛК → Управление → Устройства → развернуть карточку → вкладка «Лицензии».

Должны быть активны: M, PM, EMB. Если EMB отсутствует — нажать «Установить приложение» или «Сгенерировать токен».

**Шаг 2. Проверить синхронизацию**

Если приложение установлено, но настройки (пользователи, правила, PIN-коды) не применяются — запустить синхронизацию Мониторинг–ПринтМенеджер вручную.

**Шаг 3. Проверить логи ПринтМенеджер**

* Запустить логирование в интерактивном режиме
```bash
cd /opt/printmanager
sudo docker-compose logs -f --tail=100
```
* Выполнить запрос из встроенного приложения, например: авторизоваться.
* В логах проверить наличие запросов в контейнере printmanager-web_1

**Шаг 4. Проверить доступность ПринтМенеджер с устройства**

МФУ должен иметь сетевой доступ к серверу ПринтМенеджер. Проверить с сервера ПринтМенеджер:

```bash
ping <ip_мфу>
curl -k http://<ip_мфу>/
```

Если МФУ недоступен с сервера ПринтМенеджера — сетевая проблема, решается на стороне заказчика.

**Шаг 5. Переустановить приложение**

Если предыдущие шаги не дали результата:

1. В ЛК → Управление → Устройства → «Удалить приложение» (или «Удалить токен»).
2. Перезагрузить МФУ.
3. Установить заново.

---

### Навигация по конкретным проблемам

| Симптом | Статья |
|---|---|
| Приложение не устанавливается, ошибка при установке | [Встроенное приложение не устанавливается](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/vstroennoe-prilozenie-ne-ustanavlivaetsia) |
| Белый экран или приложение не открывается | [Белый экран во встроенном приложении](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/belyi-ekran-ili-prilozenie-ne-otkryvaetsia-na-mfu) |
| Пользователь авторизовался, но заданий нет | [Задания не отображаются в приложении](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/polzovatel-avtorizovalsia-no-zadaniia-ne-otobrazaiutsia) |
| Авторизация по карте не работает | [Авторизация по карте не работает во встроенном приложении](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/avtorizaciia-po-karte-ne-rabotaet-vo-vstroennom-prilozenii) |
| Ricoh: приложение постоянно запрашивает токен | [Ricoh — постоянный запрос токена](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/postoiannyi-zapros-tokena-na-mfu-ricoh) |
| Xerox: сканирование/копирование не работает без ошибок | [Xerox — сканирование не работает, ошибок нет](https://wiki.printum.io/books/7-ustranenie-neispravnostei/page/xerox-skanirovanie-ili-kopirovanie-ne-rabotaet-osibok-net) |

---

### Что приложить при эскалации в ТП

- Вендор и модель МФУ, версия прошивки.
- Версия приложения (есть в интерфейсе МФУ).
- Версии Мониторинга и ПринтМенеджера.
- Логи системы Printum.
- Описание симптома: что именно происходит на экране МФУ.