Технические журналы TesLab: поиск ошибок и чтение файлов
Технический журнал помогает найти серверное сообщение, связанное с ошибкой, и прочитать записанную хронологию запроса. Начните с точного времени и действия. Серверные файлы нужны, если интерфейса недостаточно или разбирается прежняя установка.
В этой статье
Подготовить сведения
- Запишите время с часовым поясом, сервер и версии клиента и сервера.
- Укажите раздел, объект, ожидаемый результат и точные шаги. Уточните, затронут один сотрудник или несколько.
- Сохраните видимый отказ. Перед повторной отправкой, созданием документа или передачей сведений наружу проверьте фактический результат: отсутствие подтверждения не означает, что действие не выполнено.
Откройте «Компания» → «Конфигурация» → «Журналы» → «Технический лог». Просмотр лога, хронологии и архива регулируется отдельными правами. Для архива нужны также права на список каналов. Лента реального времени доступна администратору. Если нужное действие запрещено, попросите администратора проверить доступ.
Вопрос «кто изменил поле» разбирают через аудит изменений.
Найти запись и открыть подробности
- Обновите таблицу. Задайте небольшой период вокруг события.
- Уточните канал, уровень или сообщение. Проверьте сохранённые фильтры: по умолчанию
debugскрыт. Если сервер не записывал этот уровень, смена фильтра не восстановит записи. - Сопоставьте время, метод и сообщение с действием. Соседняя красная строка другой интеграции может относиться к другому случаю.
- Откройте контекстное меню строки и выберите «Подробности записи». Прочитайте исходное событие и контекст, сохраните точный отказ.
- Если есть
request_id, выберите «Хронология запроса». В карточном представлении переход также доступен по строке. Чтобы показать идентификатор в таблице, откройте панель «Столбцы» и включитеrequest_id.


request_idсвязывает только записанные события одного серверного запроса: технические сообщения, аудит и события объектов. Чтение карточки, её сохранение и отдельный фоновый процесс могут иметь разные идентификаторы. Это не полная история действий пользователя.
Проверить архив
- Откройте «Архив». Выберите «Канал», «С даты» и «По дату». Конечная дата включается целиком; период трактуется в часовом поясе сервера. Максимальный интервал составляет 3660 дней.
- При необходимости заполните «Текст» и «Лимит» от 1 до 5000 записей. Поиск относится к одному выбранному каналу.
- Нажмите «Искать в архиве». Сопоставьте условия над результатом с нужным событием, откройте «контекст» строки.
- Проверьте полноту. При лимите сузьте период или текст. При ошибках чтения передайте их администратору. Если сервер не подтверждает полноту, требуется его обновление.

«Записей не найдено», «архивных файлов нет» и «неполный результат» требуют разных проверок. Пустая выборка по неверному каналу или повреждённому архиву не доказывает отсутствия события. Для нового поиска проверьте все условия либо нажмите «Сбросить».
Посмотреть события в реальном времени
- Откройте «Реальное время». Укажите каналы через запятую, минимальный уровень, текст и число записей в ленте.
- Нажмите «Старт» и дождитесь статуса «Лента подключена». Ожидание можно отменить; если сервер не подтвердит подписку за 15 секунд, проверьте связь и повторите запуск.
- Выполните один согласованный безопасный сценарий. Не повторяйте значимую отправку без проверки результата.
- Нажмите «Стоп», чтобы зафиксировать полученный фрагмент для чтения. После потери соединения восстановите связь и запустите ленту заново.

«Очистить» убирает строки только с экрана. Ограниченная лента вытесняет старые события и не заменяет архив. При смене фильтров активная лента переподписывается; проверяйте подтверждение. Сообщение об обновлении сервера означает, что безопасный режим подписки ещё недоступен на этой установке.
Разобрать один запрос
Сохранение карточки отклонено. Администратор находит связанное сообщение и открывает хронологию. В одном запросе видны входящие параметры и отказ проверки поля «Название». Это объясняет отказ сохранения, но не описывает предыдущее чтение карточки.

Если строки нет, проверьте время, канал, фильтры и факт обращения к серверу. Сетевая ошибка могла возникнуть на устройстве раньше запроса. При отсутствии идентификатора передайте точные шаги и видимое сообщение.
Справочник журналов и серверных файлов
Эта часть нужна специалисту с серверным доступом. Для обычного обращения достаточно собранных выше сведений. Перейдите к нужной группе журналов и файлов: входящие запросы, статусные файлы, файлы модулей, прежняя JSON-история, архивирование, чтение в Linux.
Два поколения журналов: что искать на вашем сервере
Современный структурированный журнал и прежние файлы могут существовать одновременно. Они не являются точными копиями. Старый файл после обновления может больше не пополняться.
| Источник | Где находится | Особенности |
|---|---|---|
| Технический журнал | Таблица crm_app_logs; интерфейс «Технический лог». | Структурированные время, канал, уровень, сообщение, контекст и идентификатор запроса. Часть прежних вызовов перенаправляется сюда с событием legacy.имя. |
| Аудит изменений | crm_db_audit; вкладка «Аудит». | История предусмотренных изменений данных. Для анализа «кто поменял поле» начните с неё. |
| Архив современного техлога | XFILES_DIR/logs/archive/канал/, месячные YYYY-MM.jsonl.gz и суточные YYYY-MM-DD.jsonl.gz файлы; вкладка «Архив». | Сжатые JSONL: одна JSON-запись на строку. Поиск выполняется по выбранному каналу и периоду. |
| Файловые логи прежней системы | APP_Folder/logs/*.log. | Текущий APP::Debug пишет их только при включённом серверном AppParams['Debug']. У отдельных процессов может быть собственная прямая запись. |
| Старый файловый аудит | APP_Folder/logs/db/таблица.json. | Исторические материалы прежних версий. Нынешняя запись DB::SaveHistory использует Audit и больше не дописывает эти JSON. |
APP_Folder обозначает папку серверной программы, например /opt/TesLab/server. XFILES_DIR обозначает файловое хранилище, например /TesLabFiles; его путь задан в config/config.php. Не передавайте весь файл конфигурации ради проверки пути: в нём могут быть данные подключения.
IN.log: входящие запросы
В прежнем IN.log ищут входящие методы API, параметры и пользователя. Пример:
2026-01-04 09:30:29 uid: 100 laboratory/tasks/list
{"startRow":0,"endRow":30,"tab":"WorkingList"}
Дата и время относятся к серверу, uid обозначает ID учётной записи, laboratory/tasks/list является методом API. Формат зависит от версии; IN-контекст может иметь ключи method, id и in.
Входящий запрос не подтверждает успех. Проверьте результат и аудит. Некоторые частые методы не записываются. Современный входящий поток имеет уровень debug и может отсутствовать при более высоком минимальном уровне.
Error.400.log и другие статусные файлы
Прежние ошибки разделяются по файлам Error.400.log, Error.401.log, Error.403.log, Error.404.log, Error.419.log, Error.500.log. Файл появляется при соответствующей записи и включённом режиме. В современном журнале ищите событие вида Error.403.
| Код | С чего начать разбор |
|---|---|
| 400 | Параметры и проверки действия: обязательное поле, недопустимое значение, неподходящее состояние объекта. Читайте сообщение конкретного отказа. |
| 401 | Вход и авторизация: учётные данные или действующий контекст доступа. |
| 403 | Права и запреты доступа. Код может относиться и к другим проверкам, например блокировке IP. |
| 404 | Маршрут API либо отсутствие запрошенного ресурса. |
| 419 | Состояние токена/сеанса. Этот код используется, в частности, для заблокированного или истёкшего токена. |
| 500 | Внутренняя ошибка. Нужны сообщение, метод и место возникновения; одного номера недостаточно. |
После времени, uid и параметров обычно идёт трассировка: файлы, строки и вызовы. Сокращённый пример:
2026-01-04 09:31:02 uid: 100
{"id":1234,"-API-Method":"laboratory/tasks/list"}
[{"file":"/opt/TesLab/server/functions/class/APP.php",
"line":500,"function":"Error","args":[403]}]
Номера строк зависят от версии. Читайте цепочку до нужного обработчика. Не меняйте права по одному коду 403: сначала установите, какая проверка отказала.
Глобальные ошибки, обновления и плановые задачи
| Файл | Содержимое и применение |
|---|---|
ErrorGlobal.min.log | Сокращённые общие сообщения прежней системы. Удобен для первичной хронологии, после чего нужен профильный статусный файл. |
GlobalErrors.log | Общий файловый поток вызовов с типом error. Это исторический агрегатор, а не обязательная таблица или отдельный канал нового журнала. |
sysUpdate.log | Ход проверки и применения обновлений: инициатор, старт, поиск версии, шаги обработки. Нынешнее сопоставление отправляет соответствующие события в канал system. |
cron.log | Вывод планового процесса. В cron.php записывается непосредственно: блок начинается Start дата время и заканчивается ==. Между ними выводятся сообщения подключённых задач. |
В sysUpdate.log строки Start by 100, Check new version, Find new version: … показывают начало и обнаружение версии, но не завершение установки. Аналогично, Start в cron.log не подтверждает успех каждой задачи.
ErrorGlobal и ErrorGlobal.min не зеркалируются как дубли в современный журнал. Связанная ошибка уже может находиться в основном событии.
Справочник дополнительных файлов модулей
Состав файлов зависит от версии и подключённых функций. Отсутствие необязательного файла само по себе не является неисправностью.
| Имена | Область поиска |
|---|---|
cmd.log, wss.log, WSInfo.log | Фоновые команды и WebSocket. Рутинные запуски могут фильтроваться в новом журнале. |
sqlErrors.log, BD_Errors.log | Ошибки обращений к БД. Современный канал db. |
BackupError.log, backup.log | Резервирование и синхронизация копий. Современный канал backup и отдельный журнал бэкапов. |
archiveError.log, downloadErrors.log | Архивирование и подготовка/выдача файлов. |
techrecErrors.log, techrecZipError.log | Формирование технических записей и упаковка PDF. Современный канал protocols. |
SyncFGIS.log, FGIS.log, FsaSyncTL.log | Обмен с ФГИС; для предусмотренных сопоставлений канал fgis. У внешнего агента может быть собственный журнал на его компьютере. |
Telegram.log, tg.log, tgErrors.log, chatterError.log | Сообщения, боты и коммуникации. Имена менялись между версиями. |
webhook.log, sbisErrors.log | Входящие события интеграций и обмен с СБИС. |
RImportErrG.log, RImportErr.log | Импорт лабораторных запросов/данных. Для нынешних сопоставлений канал laboratory. |
Прежнее имя может стать событием внутри канала. Например, BackupError.log ищите также по сообщению в канале backup.
Историческая папка db и схема JSON
В прежнем logs/db файлы назывались по таблице, например clients_acts.json. Исходный файл может содержать объекты через запятую, включая последнюю запятую. Старый просмотрщик дополняет последовательность до массива. Ниже показано нормализованное представление:
[{"i":1234,"r":"127.0.0.1","d":"2026-01-04 09:32:00",
"t":2,"u":100,"v":{"invoice":"827"}}]
| Поле | Значение в прежнем формате |
|---|---|
i | ID изменяемой записи таблицы, а не порядковый номер сообщения. |
r | IP источника изменения. |
d | Дата и время. |
u | ID пользователя; нулевое значение может относиться к системной операции. |
t | Код операции: 1 добавление, 2 изменение, 3 удаление, если событие такого типа было записано соответствующим механизмом. |
v | Объект сохранённых значений: ключи являются именами столбцов. |
Не исправляйте исходник вручную ради преобразования в массив. Это историческая схема, не формат нынешнего crm_db_audit. Прекращение роста старого JSON не доказывает отсутствия изменений.
Ротация, архивы и сроки хранения
Порог ротации файлов APP::Debug: 52 428 800 байт, то есть 50 МиБ. Проверка выполняется при очередной записи. Прямые записи других процессов, например вывод cron, могут обходить этот механизм.
При успехе фрагмент попадает в XFILES_DIR/logs/имя-YYYY-MM.zip с уникальным именем по дате и времени. В прежних ZIP встречается имя_YYYY-MM-DD_HH:MM.log. Исходник укорачивается после проверки архива; при отказе сохраняется и продолжает расти. За месяц в ZIP накапливаются несколько фрагментов.
По умолчанию оперативные технические разделы БД хранятся 30 дней, затем экспортируются по каналам в logs/archive/канал/. Новые части: YYYY-MM-DD.jsonl.gz; прежние месячные YYYY-MM.jsonl.gz также читаются. При отказе экспорта раздел остаётся в БД, пропущенные дни обрабатываются следующими запусками. Для аудита задано 10 лет. Параметры tech_hot_days и audit_years меняются конфигурацией.
Настройки срока не гарантируют работу cron. Проверяйте выполнение, свободное место и доступность архивов. Уточняйте отдельную политику резервирования и удаления старых ZIP и холодных GZ.
Чтение файлов в Linux
Команды предназначены администратору с правом чтения. Замените пути своими. Для остановки непрерывного просмотра нажмите Ctrl+C.
# Последние 200 строк ошибки 500
tail -n 200 /opt/TesLab/server/logs/Error.500.log
# Новые строки входящих запросов
tail -F /opt/TesLab/server/logs/IN.log
# Учётная запись с ID 100 в старом IN
grep -nE -- 'uid: *100([[:space:]]|$)' /opt/TesLab/server/logs/IN.log
# Упоминание метода API; в JSON слэши могут быть экранированы
grep -nF -e 'laboratory/tasks/list' -e 'laboratory\/tasks\/list' /opt/TesLab/server/logs/IN.log
# Состав прежнего ZIP без распаковки
unzip -l /TesLabFiles/logs/IN-2026-01.zip
# Последние 50 строк современного сжатого архива канала
gzip -cd /TesLabFiles/logs/archive/system/2026-01.jsonl.gz | tail -n 50
tail -F следит за именем и повторяет открытие после ротации; tail -f может остаться на прежнем дескрипторе. Граница UID отделяет 100 от 1000. Поиск метода учитывает обычные и экранированные слэши. Если файла нет, проверьте путь, режим и месяц. Не создавайте пустой лог. Ограничивайте вывод больших архивов.
Время и чувствительные данные
Сопоставляйте серверные часы с часами браузера и внешнего агента с учётом часового пояса. Синхронизация времени относится к обслуживанию ОС. Неверные часы нарушают порядок событий и поиск по периоду.
Современный журнал маскирует предусмотренные ключи, обычно как [redacted], и ограничивает контекст. Старый IN скрывает отдельные пароли как ********. Произвольные строки и трассировки всё равно могут содержать секреты. Просматривайте фрагмент перед передачей. Доступ к файлам определяется правами ОС, к журналам TesLab правами приложения.
Передать полезный фрагмент
- Ожидаемый и фактический результат, короткие шаги и уже выполненные проверки.
- Время с часовым поясом, версии, раздел и идентификатор объекта.
- Точный отказ, канал, request_id и связанные записи. Для архива также условия, число прочитанных файлов и предупреждение о неполноте.
Просмотрите фрагмент перед передачей: исключите пароли, токены и лишние персональные данные. Не отправляйте весь архив без необходимости. Поиск не исправляет причину и не отменяет выполненное действие. Значимый сбой оформляют как инцидент ЛИМС, выполненные вмешательства фиксируют в журнале обслуживания.
Связанные инструкции
- Аудит изменений и проверка целостности истории
- Рабочее место администратора: конфигурация и доступные действия