Общие сведения

Через интерфейс приложения со страницы приложения /setting/logs (раздел "Логи" в системе) также можно скачать архив с диагностической информацией о текущем состоянии системы:

Для доступа к странице у вас должна быть роль администратора, суперпользователя или роль с доступом к логам системы.

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

Чтобы скачать файлы диагностики, кликните на странице кнопку «Выгрузить» и выберите в меню «Диагностику». По клику формируется и автоматически скачивается архив с файлами, о чем сообщает нотификация "Запущена выгрузка диагностической информации. Идет подготовка файла выгрузки". Формирование архива для скачивания может занять некоторое время.



Об успешном завершении выгрузки диагностики сообщает нотификация "Успешно сформировано. Файл диагностической информации успешно выгружен", после чего ссылка на архив с файлами диагностики приходит в уведомления системы. По ней можно скачать архив локально. 


Структура архива диагностики

Архив с файлами диагностики имеет название типа bi_pd_diag_manager_<дата_выгрузки>_<время_выгрузки>.zip. Архив имеет следующую структуру:



где:


Архив диагностики содержит в себе в том числе и логи:

  • файл filtered_user.log с логами действий пользователей за последние сутки;
  • архив logs.zip с логами сервисов и коннекторов системы. Для каждого сервиса или коннектора локально выгружаются последние 100 Мбайт логов за последние сутки. В архиве находится файл-подсказка log_structure.txt, содержащий в себе полную структуру директории логов на сервере, в т.ч. архивы логов за последние сутки, не вошедшие в последние 100 Мбайт.



Детализация файлов диагностики

Каждый файл архива диагностики содержит структурированную информацию в форматах CSV, JSON или .log. Структура каждого из файлов приведена ниже.

/configs/

Файлы в директории /configs/ имеют названия типа <SERVICE_NAME>_conf.json, где <SERVICE_NAME> - имя сервиса, к которому относится файл конфигурации.

Каждый файл конфигурации содержит параметры, соответствующие сервису, как описано в разделе Параметры конфигурации.

Записи о параметрах имеют следующий формат:

{
    "Id": 23,
    "PipelineConfigPath": "/etc/polymatica/platform/service/logstash/pipeline-config.json",
    "Log": {
        "Lvl": 4,
        "Path": "/tmp/POLYMATICA_LOGSTASH.log",
        "WithResponse": false
    },
    "Http": {
        "Host": "0.0.0.0",
        "Port": 9607,
        "MaxHeaderSize": 0,
        "ReadTimeout": 0,
        "WriteTimeout": 0
    },
    "Database": {
        "MaxOpenedConnections": 100,
        "MaxIdleConnections": 100
    },
    "Module": {
        "BackUrl": "http://logstash:9607"
    },
    "RabbitMQ": {
        "User": "polymatica",
        "Host": "rabbitmq",
        "Port": "5672",
        "VHost": "polymatica"
    },
    "Repository": {
        "Path": "/usr/share/polymatica/platform/logstash"
    },
    "Discovery": {
        "Url": "http://discovery:9610"
    }
}

 columns.csv 

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

Подробнее о расчетных колонках см. Руководство пользователя Polymatica Dashboards TN  → Датасеты → Настройка датасета → Добавление расчетной колонки.

Подробнее о массиве настроек форматирования колонки см. Руководство пользователя Polymatica Dashboards TN  → Датасеты → Настройка датасета → Настройки колонки.

components.csv 

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

Подробнее о компонентах см. Руководство пользователя Polymatica Dashboards TN  → Компоненты.

Подробнее о загрузке компонентов см. Руководство пользователя Polymatica Dashboards TN → Добавление пользовательского компонента.

connectors.csv

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

Подробнее о коннекторах см.  Руководство пользователя Polymatica Dashboards TN  → Коннекторы.

datasets.csv 

Для перечня датасетов, существующих в системе, записи в файле диагностики содержат следующие поля:

Подробнее о датасетах см. Руководство пользователя Polymatica Dashboards TN  → Датасеты.

Подробнее о локальных и объединенных датасетах см. Руководство пользователя Polymatica Dashboards TN → Датасеты → Создание датасета.

Подробнее о настройках датасета см. Руководство пользователя Polymatica Dashboards TN → Датасеты → Настройки датасета.

environment.json

Файл с описанием системного окружения имеет следующий формат:

{
    "Browser": {
        "Name": "Chrome",
        "Version": "140.0.0.0"
    },
    "OS": {
        "FullName": "Debian GNU/Linux 12 (bookworm)"
    },
    "CPU": {
        "Name": "Intel(R) Xeon(R) CPU E5-2697 v4 @ 2.30GHz",
        "Arch": "amd64",
        "Cores": 8
    },
    "MemoryGB": {
        "RAMTotal": 16.77,
        "RAMFree": 0.16,
        "SwapTotal": 0,
        "SwapFree": 0
    },
    "DiskGB": {
        "Total": 315.93,
        "Free": 148.57
    }
}

Подробнее о требованиях к системному окружению см. Требования.

filters.csv 

Для перечня фильтров, существующих в системе, записи в файле диагностики содержат следующие поля:

Подробнее о фильтрах см. Руководство пользователя Polymatica Dashboards TN  → Фильтры.

Подробнее о настройках фильтра см. Руководство пользователя Polymatica Dashboards TN  → Фильтры → Настройка фильтра.

Подробнее о расширенной фильтрации см. Руководство пользователя Polymatica Dashboards TN → Виджеты → Работа с расширенным фильтром. 

license_info.json 

Файл с информацией о лицензии имеет следующий формат:

{
    "unlimited_users": false, // количество пользователей ограничено
    "users_count": 150, // разрешенное количество пользователей 
    "unlimited_expire_date": false, // срок действия лицензии ограничен 
    "current_user_count": 80, //текущее количество пользователей 
    "activation_code": "/PviKxUe...ncnyw==\n" //код активации лицензии
  }
}

Подробнее о лицензии см. Лицензирование.

migrations.csv

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

Подробнее о базах данных см. Список баз данных. 

modules.csv

Для перечня сервисов системы записи в файле диагностики содержат следующие поля:

Подробнее о сервисах см. Руководство пользователя Polymatica Dashboards TN  → Модули.

project_themes.csv

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

Подробнее о темах оформления см. Руководство пользователя Polymatica Dashboards TN  → Темы.

projects.csv

Для перечня проектов записи в файле диагностики содержат следующие поля:

Подробнее о проектах, их слоях и элементах см. Руководство пользователя Polymatica Dashboards TN  → Проекты.

release_version.json 

Файл с информацией о версии системы имеет следующий формат:

{
    "release_version": "1.35.0"
}

system_themes.csv

Для перечня тем оформления системы записи в файле диагностики содержат следующие поля:

Подробнее о темах оформления системы см. Руководство пользователя Polymatica Dashboards TN  → Оформление.

filtered_user.log и logs.zip

Детализация файла filtered_user.log и содержимое директории хранения логов подробно описано в разделе Логирование.