Технические журналы TesLab: поиск ошибок и чтение файлов

В документации мы постарались ответить на частые вопросы по работе TesLab, с которыми сталкиваются пользователи.
Если Вы не нашли ответ на свой вопрос, напишите нам.

Личный кабинет

Технические журналы TesLab: поиск ошибок и чтение файлов

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

В этой статье

Подготовить сведения

  • Запишите время с часовым поясом, сервер и версии клиента и сервера.
  • Укажите раздел, объект, ожидаемый результат и точные шаги. Уточните, затронут один сотрудник или несколько.
  • Сохраните видимый отказ. Перед повторной отправкой, созданием документа или передачей сведений наружу проверьте фактический результат: отсутствие подтверждения не означает, что действие не выполнено.

Откройте «Компания» → «Конфигурация» → «Журналы» → «Технический лог». Просмотр лога, хронологии и архива регулируется отдельными правами. Для архива нужны также права на список каналов. Лента реального времени доступна администратору. Если нужное действие запрещено, попросите администратора проверить доступ.

Вопрос «кто изменил поле» разбирают через аудит изменений.

  1. Обновите таблицу. Задайте небольшой период вокруг события.
  2. Уточните канал, уровень или сообщение. Проверьте сохранённые фильтры: по умолчанию debug скрыт. Если сервер не записывал этот уровень, смена фильтра не восстановит записи.
  3. Сопоставьте время, метод и сообщение с действием. Соседняя красная строка другой интеграции может относиться к другому случаю.
  4. Откройте контекстное меню строки и выберите «Подробности записи». Прочитайте исходное событие и контекст, сохраните точный отказ.
  5. Если есть request_id, выберите «Хронология запроса». В карточном представлении переход также доступен по строке. Чтобы показать идентификатор в таблице, откройте панель «Столбцы» и включите request_id.
Уровень, сообщение и панель столбцов технического журнала
1: фильтр уровня. 2: сообщение записи. 3: панель «Столбцы», где можно включить request_id.
Контекстное меню записи: подробности и хронология запроса
1: полный контекст записи. 2: переход к хронологии, если у строки есть request_id.

request_id связывает только записанные события одного серверного запроса: технические сообщения, аудит и события объектов. Чтение карточки, её сохранение и отдельный фоновый процесс могут иметь разные идентификаторы. Это не полная история действий пользователя.

Проверить архив

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

«Записей не найдено», «архивных файлов нет» и «неполный результат» требуют разных проверок. Пустая выборка по неверному каналу или повреждённому архиву не доказывает отсутствия события. Для нового поиска проверьте все условия либо нажмите «Сбросить».

Посмотреть события в реальном времени

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

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

Разобрать один запрос

Сохранение карточки отклонено. Администратор находит связанное сообщение и открывает хронологию. В одном запросе видны входящие параметры и отказ проверки поля «Название». Это объясняет отказ сохранения, но не описывает предыдущее чтение карточки.

Один request_id, входящий запрос и причина отказа в контексте
1: общий request_id двух записанных событий. 2: конкретное поле, из-за которого запрос отклонён.

Если строки нет, проверьте время, канал, фильтры и факт обращения к серверу. Сетевая ошибка могла возникнуть на устройстве раньше запроса. При отсутствии идентификатора передайте точные шаги и видимое сообщение.

Справочник журналов и серверных файлов

Эта часть нужна специалисту с серверным доступом. Для обычного обращения достаточно собранных выше сведений. Перейдите к нужной группе журналов и файлов: входящие запросы, статусные файлы, файлы модулей, прежняя 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"}}]
ПолеЗначение в прежнем формате
iID изменяемой записи таблицы, а не порядковый номер сообщения.
rIP источника изменения.
dДата и время.
uID пользователя; нулевое значение может относиться к системной операции.
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 и связанные записи. Для архива также условия, число прочитанных файлов и предупреждение о неполноте.

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