Часто-задаваемые вопросы. Качество данных 2.0

Скопировать прямую ссылку на статью

Дата актуализации: 03.06.2026.
Причина актуализации: Добавлен вопрос про настройку Агента проверок в Витрине ЛАЙТ.

Внимание!

Данный раздел наполняется в ходе консультационной поддержки участников СМЭВ. Рекомендуем при решении ваших задач опираться на официальную документацию и рассматривать данный раздел как информационную помощь к ней.

Как настроить балансировку запросов за Агентом СМЭВ4 между Агентом проверок и Prostore?

Для чего нужна настройка балансировки?

По умолчанию Агент СМЭВ4 поддерживает работу только с одним REST-сервисом. В конфигурации Агента СМЭВ4 (раздел api-gateway) нельзя указать два или более REST-сервиса одновременно. Поскольку в проверках качества данных используется несколько REST-сервисов, необходимо применять промежуточный балансировщик запросов — такой, как NGINX или аналогичный ему.

Настройка балансировки через NGINX также необходима, если ранее Агент СМЭВ4 уже был настроен на иной REST-сервис участника.

Схема маршрутизации запросов

Ниже представлена схема маршрутизации входящих запросов, поступающих на NGINX из Агента СМЭВ4, который, в свою очередь, получил эти запросы из СМЭВ4:

Агент СМЭВ4→ NGINX (порт 8088)

├──→ /dqf/quality-checks → Агент проверок (порт 3010)
├──→ /api/v1/incidents/upload → Агент проверок (порт 3010)
├──→ /api/v1/datamarts → Prostore (порт 9090)
└──→ остальные запросы → Prostore (порт 9090)

Конфигурация NGINX
Пример конфигурационных файлов в архиве.

⚠️ Замените <CHECK_ADAPTER_HOST> и <PROSTORE_HOST> на IP-адреса или DNS-имена своих серверов Агента проверок и Prostore .

Проверка и перезапуск NGINX

Выполните команды:

sudo nginx -t
sudo systemctl restart nginx
Настройка Агента СМЭВ4

Отредактируйте конфигурацию агента СМЭВ4 (application.yml):

api-gateway:
  client:
    impl: APACHE
    options:
      default-host: <NGINX_HOST>
      default-port: 8088
      ssl: false
      verifyHost: false
      maxPoolSize: 100

⚠️ Замените <NGINX_HOST> на адрес, по которому доступен твой NGINX. После этого перезапусти Агент СМЭВ4.

Логирование и отладка

Просмотр логов NGINX:

# Логи доступа (access.log)
sudo tail -f /var/log/nginx/access.log

# Логи ошибок (error.log)
sudo tail -f /var/log/nginx/error.log

Как настроить несколько схем в 1 ПО ВД и АРМ ДС?

Если в ПО Витрина данных реализовано несколько схем/моделей Витрин, то и Агент проверок и АРМ ДС можно нацелить на эти несколько схем. Для этого: 1. В конфиге application.yml Агента проверок правится блок datamarts, согласно примеру:



	 nsud:


	 datamarts:


	     - datamart_mnemonic_1


	     - datamart_mnemonic_2


	     - datamart_mnemonic_3



	 2. В docker-compose.yml правится блок volumes, согласно примеру:


	 volumes:


	       - ./application.yml:/egov/java/conf/application.yml


	       - ./datamart_mnemonic_1.sql:/egov/java/datamart_mnemonic_1.sql


	       - ./datamart_mnemonic_2.sql:/egov/java/datamart_mnemonic_2.sql


	       - ./datamart_mnemonic_3.sql:/egov/java/datamart_mnemonic_3.sql



	 3. В АРМ ДС схемы указываются в массиве:

 datamart:
  list: # массив из пар: mnemonic — мнемоника datamart (основная схема), dqf — схема dqf-данных в нем
    - mnemonic: datamart_mnemonic_1
      dqf: datamart_mnemonic_dqf
    - mnemonic: datamart_mnemonic_2
      dqf: datamart_mnemonic_dqf
  default: datamart_mnemonic_1 # мнемоника по умолчанию

⚠️ Схема dqf одна для всех Витрин и она же должна быть указана в конфигурации Агента проверок (check-adapter): atamart_dqf_schema: "datamart_mnemonic_dqf".

Как настроить Агент проверок (check-adapter) в Витрине ЛАЙТ?

Важно!

Настройка Агента проверок в Витрине ЛАЙТ доступна только в версии 2.6.1

Для работы проверок качества 2.0 в Витрине ЛАЙТ нужно настроить Агент проверок.

Для этого нужно сформировать и подложить ему конфигурационный файл. До установки файл конфигурации кладётся в ansible/files/check-adapter. Если витрина уже установлена, то файл конфигурации подкладывается в /etc/dtm-lite/check-adapter/ и после рестрарта контейнера Агента проверок (check-adapter) он будет смонтирован внутри контейнера.

Конфигурационный файл заполняется согласно документации ПО Витрина данных - https://docs.rtk-soft.ru/dtm-docs/latest/project_dtm/modules/check-adapter/doc/check_adapter_config.html#check-application-yml

Помимо установки и настройки Агента проверок нужно изменить конфигурацию Агента СМЭВ4 (добавить секцию api-gateway), настроить nginx (описано в этой же статье), выполнить предварительные действия в ЕИП НСУД. Более подробно в статье - Настройка работы с качеством данных 2.0

, чтобы оставить комментарий к статье