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

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

• просмотр и настройка системных логов. Журнал с системными логами, идентифицирующий события, время и результат работы с сервером мобильной платформы. Для настройки параметров логирования на сервере мобильной платформы и на мобильном устройстве используйте вкладки «Настройки», «Глобальная политика логирования» в подразделе «Настройки системных логов», вкладку «Проектная политика логирования» конкретного проекта. Для получения подробной информации о настройке параметров логирования обратитесь к разделам «Настройка параметров хранения логов», «Настройка параметров политики логирования устройств»;

• просмотр запросов к источникам данных. Журнал с подробной отладочной информацией о запросах ресурсов источника данных конкретным пользователем API. Для добавления и настройки правил логирования запросов к источникам данных используйте вкладку «Дебаг правила логирования запросов к источникам данных» в подразделе «Настройки системных логов». Для получения подробной информации обратитесь к разделу «Расширенное логирование запросов к источникам данных»;

• просмотр фоновых задач. Журнал активных фоновых задач и задач, которые запускаются по расписанию. Для просмотра журнала фоновых задач используйте подраздел «Фоновые задачи». Для получения подробной информации о журнале фоновых задач обратитесь к разделу «Просмотр фоновых задач».

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

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

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

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

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

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

Просмотр оригинального IP-адреса пользователя API или администратора

При открытии полного описания лога отображается цепочка IP-адресов в параметре «IP-адрес/хост». В цепочке содержатся узлы, через которые прошёл запрос пользователя API или администратора.

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

• X-Forwarded-For. Заголовок, который формирует сторонний прокси-сервер или балансировщик нагрузки. В значении передаётся список IP-адресов. Каждый узел, через который проходит запрос, дополняет список IP-адресом, от которого этот запрос был получен, и передаёт заголовок дальше. Не все узлы могут быть настроены на дополнение заголовка, в таком случае заголовок будет передаваться без фиксации узла, от которого получен запрос. IP-адрес пропущенного узла не будет отображаться в списке IP-адресов. Если заголовок не был получен сервером мобильной платформы, то в логе не будет отображаться список IP-адресов;

Примечание. Если заголовок X-Forwarded-For не был получен сервером мобильной платформы при использовании кластерной конфигурации, то прокси-сервер оркестратора Deckhouse/Kubernetes (ingress) может самостоятельно его сформировать и указать только один IP-адрес, от которого получен запрос. Для этого на прокси-сервере должна быть настроена специализированная политика.

• X-Forwarded-Host. Заголовок, который формирует мобильное приложение, сторонний прокси-сервер или балансировщик нагрузки. В значении передаётся DNS-имя сервера - источника заголовка. Если заголовок не был сформирован ни одним узлом, то в логе не будет отображаться DNS-имя сервера;

• X-Real-API. Заголовок, который формирует прокси-сервис мобильной платформы nginx. В значении передаётся IP-адрес узла, который передал запрос nginx. При использовании одиночной конфигурации передаётся IP-адрес клиента сети Docker, при использовании кластерной конфигурации - IP-адрес прокси-сервера оркестратора (ingress);

• REMOTE_ADDR. Переменная, которая формируется контейнером мобильной платформы. В значении передаётся IP-адрес узла, который передал запрос контейнеру. При использовании одиночной или кластерной конфигурации передаётся IP-адрес прокси-сервиса nginx;

• fmp-server. В значении передаётся IP-адрес контейнера мобильной платформы.

Общая схема формирования и передачи заголовков/переменных:

Просмотр описания событий со статусом «Дебаг»

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

• /api/v1/rpc/{<название ресурса>}/;

• /api/<v1 или v2>/web/{<название ресурса>}/;

• /api/v1/json/{<название ресурса>}/.

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

• Доступ к разделу «Среды». Доступен просмотр событий, связанных с запросами ресурсов любой среды;

• Доступ к среде. Доступен просмотр событий, связанных с запросами ресурсов конкретной среды;

• Доступ к проекту. Доступен просмотр событий, связанных с запросами ресурсов конкретного проекта.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Источник/БД - ФМП;

• ФМП - Пользователь.

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

• при использовании «Форсайт. Мобильная платформа» версии 25.10.002:

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

2. Нажмите на наименование файла в поле «Описание».

• при использовании «Форсайт. Мобильная платформа» версии 25.10.001:

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

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

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

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

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

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

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

• Источник - ФМП: ds_to_fmp_<время записи лога в момент получения запроса от пользователя>.json;

• БД - ФМП: db_to_fmp_<время записи лога в момент получения запроса от пользователя>.json;

• ФМП - Пользователь: fmp_to_user_<время записи лога в момент получения запроса от пользователя>.json.

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

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

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

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

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

psql

curl

sqlplus

sqlcmd

python-скрипт

import http.client
import json
from typing import Optional
 
# Задайте учётные данные пользователя
hashed_password = "<пароль пользователя>"

username = "<имя пользователя>"

repository_id = "FUNCTION"
fap_type = "D"
fap_object = "195258"
params = json.loads("{"attributes": []}")
structures = json.loads("{}")
url_path = "/FPBI_App_v10.x/axis2/services/PP.SOM.Som"

method = "POST"
.........................................
.........................................
.........................................
 
# open DIM
payload = open_dim(metabase_moniker, combo_param_monikers)
conn.request(method, url_path, payload, headers)
res = conn.getresponse()
response_data = json.loads(res.read().decode("utf-8"))
meta = response_data["OpenDimResult"]["meta"]
data_ = meta["els"]["els"]["e"] if "e" in meta["els"]["els"] else []
keys = [elem["id"] for elem in meta["data"]["attrs"]["it"]]
a_rows = (elem["a"]["it"] for elem in data_)
ea_rows = (
    map(lambda x: x.get("@dv", None) if isinstance(x, dict) else None, elem["ea"]["it"])
    for elem in data_
)
result_data = {
    "a": (dict(zip(keys, row)) for row in a_rows),
    "ea": (dict(zip(keys, row)) for row in ea_rows),
}

redis-cli