В этой статье:

События со статусом «Дебаг»

Просмотр связанных событий

Загрузка файла с ответом на запрос

Воспроизведение запроса

Просмотр и настройка системных логов

Для отслеживания нарушений защиты системы доступен:

Примечание. Проверьте корректность системного времени перед установкой продукта «Форсайт. Мобильная платформа». Если системное время изменить после установки, то продукт не гарантирует корректность логирования и выполнения задач по расписанию.

Для просмотра системных логов используйте подраздел «Системные логи» в разделе «Системные логи и инструменты аналитики»:

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

Важно. При изменении названия проекта будут недоступны предыдущие системные логи, сформированные до изменения названия. Для проекта с измененным названием формируются новые системные логи.

При нажатии на событие раскроется полное описание:

Фильтрация журнала с логами

Экспорт журнала с логами

События со статусом «Дебаг»

При активации правил логирования запросов к источникам данных записываются события типа «Запрос RPC API», «Запрос Web-сервиса», «Запрос JSON ресурса» со статусом «Дебаг». Доступно расширенное логирование следующих запросов:

Для просмотра описания событий со статусом «Дебаг» администратор должен обладать полномочием «Чтение дебаг логов» для одного из вариантов доступа:

Цветовая индикация определяет статус выполнения события. Серым цветом отмечаются события со статусом «Дебаг», содержащие подробную отладочную информацию, полученную в соответствии с добавленными правилами логирования запросов к источникам данных на вкладке «Дебаг правила логирования запросов к источникам данных» в подразделе «Настройки системных логов».

Пример описания события:

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

В свёрнутом описании события отображается метод API, который использовал пользователь, и маршрут обработки запроса в формате <метод API> <отправитель> - <получатель>, например:

В примере приведено событие, описывающее запрос, который отправил пользователь API серверу мобильной платформы для получения данных ресурса «ZFRUITS_GET».

Маршрут обработки запроса:

  1. Пользователь API отправляет запрос на получение данных ресурса к серверу мобильной платформы (Пользователь - ФМП).

  2. Сервер мобильной платформы отправляет запрос на получение данных ресурса к источнику данных/базе данных (ФМП - Источник/БД).

  3. Источник данных возвращает данные запрашиваемого ресурса серверу мобильной платформы (Источник/БД - ФМП).

  4. Сервер мобильной платформы возвращает данные ресурса пользователю API (ФМП - Пользователь).

Маршрут отображается в виде отдельных связанных событий.

Просмотр связанных событий

Для одного запроса пользователя API может быть отображено несколько связанных событий.

Для просмотра связанных событий:

  1. Раскройте описание основного события со статусом «Успех» или «Ошибка»:

  1. Нажмите кнопку «Показать связанные логи».

После выполнения действий будут отображаться связанные события по конкретному запросу пользователя API, например:

Для отображения всех логов нажмите кнопку «Показать все логи» в описании основного события.

Загрузка файла с ответом на запрос

Событие со статусом «Дебаг» содержит в описании ответ, который записывается в файловое хранилище MinIO/Ceph в формате JSON и доступен для загрузки в виде файла, при выполнении следующих маршрутов обработки запроса:

Для загрузки файла с ответом на запрос:

  1. Раскройте описание события.

  2. Скопируйте ссылку на файл с ответом в поле «Описание».

Примечание. Ссылка на загрузку файла действительна 365 дней с момента записи лога.

  1. Вставьте ссылку в адресную строку браузера.

После выполнения действий начнётся загрузка файла с ответом на запрос.

В файловом хранилище MinIO/Ceph JSON-файлы с ответами хранятся в отдельном разделе debug-logs-storage по пути debug_logs/<наименование среды>/<наименование проекта>/<наименование ресурса>.

Наименование JSON-файла формируется следующим образом:

Формат времени записи лога: %d-%m-%Y-%H-%M-%S.

Пример наименования JSON-файла: db_to_fmp_1-12-2024-14-55-1.json.

При необходимости очистки файлового хранилища от JSON-файлов удалите их с помощью интерфейса MinIO/Ceph. Для получения подробной информации о настройке удаления JSON-файлов по расписанию в MinIO обратитесь к разделу «Очистка файлового хранилища MinIO по расписанию».

Воспроизведение запроса

Событие со статусом «Дебаг» содержит в описании команды для воспроизведения запроса от сервера мобильной платформы к определенному источнику данных/базе данных. Для разных источников и баз данных используйте соответствующий инструмент воспроизведения:

psql

curl

sqlplus

sqlcmd

python-скрипт

redis-cli

См. также:

Администрирование и контроль доступа | Настройка параметров хранения логов | Настройки параметров политики логирования устройств | Логирование запросов к источникам данных | Просмотр фоновых задач