# Расширенное логирование

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

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

Чтобы включить расширенные журналы, выполните следующие действия:

1. Отредактируйте `config.properties` файл **tcp-server**:

* Linux: `/home/java/tcp-server/conf/config.properties`
* Windows: `C:\java\tcp-server\conf\config.properties`

2. Добавьте следующую строку в конец конфига (замените `<IMEI>` на фактический IMEI устройства):

```
debug.traceDevices=<IMEI>
```

Для нескольких IMEI:

```
debug.traceDevices=<IMEI1>,<IMEI2>
```

пример:

```
debug.traceDevices=33225566,44772211
```

4. Перезапустите **tcp-server** сервис. Это применит конфигурацию и создаст `/debug` подкаталог в `.../tcp-server/log/`.
5. Ожидайте появления проблем или спровоцируйте их
6. Проверьте `/log/debug` каталог. В нём будет файл(ы) с именем `trace-<IMEI>.log`.
7. Остановите расширенное логирование, когда оно больше не потребуется, иначе новые журналы будут продолжать занимать место на диске. Для этого закомментируйте (с помощью `#` символа) или удалите ранее добавленную строку, а затем перезапустите **tcp-server**.