Не работает сервис

Вопрос: Что предпринять, если при запуске сервиса поды находятся в состоянии Pending? В логах указано, что отсутствует связь с Redis.

Ответ:

  1. Необходимо проверить YAML-файлы с настройками подключений к Redis на корректность параметров (хост, порт, пароль).
  2. Для Redis в файле конфигурации redis.conf в параметр dir необходимо добавить путь для дампа (например, /var/lib/redis).
  3. В PostgreSQL необходимо увеличить значение параметра max_connections, рассчитывается как 25 коннектов на один микросервис. В файле redis.conf установить значение maxclients не менее 3000.
  4. В Docker указать параметры:
  redis:
    image: redis:latest
    ports:
      - "6379:6379"
    ulimits:
      nofile:
        soft: 65535
        hard: 65535
    command: ["redis-server", "--maxclients", "3000"]

Вопрос: Не сохраняются файлы, не загружается Сервис окружений.

Ответ: Наиболее вероятная причина – проблема с настройкой хранилища. Оно либо не было создано, либо существующее хранилище не было привязано к соответствующей политике.

В настройках хранилища обязательно должны быть указаны параметры подключения (путь к хранилищу и т.д.). Также в пути к хранилищу не должна быть указана временная директория (папка /tmp/), так как данные из нее могут быть утеряны.

Вопрос: Как просмотреть логи определенного сервиса в Kubernetes?

Ответ: Для просмотра логов сервиса необходимо выполнить следующие команды:

  1. Найти идентификатор пода: kubectl get pods | grep "наименование_сервиса". В результате будет получена строка с идентификатором пода.
  2. Просмотреть логи: Полученный идентификатор пода необходимо использовать в команде kubectl logs 'идентификатор_сервиса'.

Будут получены все развернутые логи.

Вопрос: Почему в реестре процессов не создается экземпляр процесса?

Ответ: Необходимо проверить корректность настройки сервисов Zeebe, Operate и Elasticsearch. Сервис Operate для отображения данных использует индексы, созданные Zeebe, поэтому оба сервиса должны быть настроены на подключение к одному и тому же экземпляру или кластеру Elasticsearch.

Вопрос: Почему появляется ошибка «Отсутствуют актуальные лицензионные условия»?

Ответ: На версиях 1.10 и 1.11 данная ошибка не влияет на работоспособность системы.

Вопрос: Как определить ошибку, которую невозможно интерпретировать по тексту в пользовательском интерфейсе или консоли разработчика?

Ответ: Для диагностики необходимо самостоятельно или с привлечением команды DevOps проанализировать логи сервисов. Следует определить, к какому сервису выполнялось обращение в момент ошибки, и последовательно изучить его логи, а также логи зависимых сервисов по цепочке вызовов.

Вопрос: По каким причинам в Системе может не работать полнотекстовый поиск?

Ответ: Необходимо проверить настройки топика Kafka – Сервис-индексатор полнотекстового поиска может слушать не тот топик Kafka, из-за чего данные не попадают в Elasticsearch. Необходимо обратиться к команде DevOps для проверки и корректировки конфигурации топиков. Возможны проблемы с настройками Elasticsearch.

Также для обеспечения полноценной работы полнотекстового поиска и индексации содержимого файлов необходимо установить и настроить Debezium.

Описание установки: Установка Debezium с помощью докера

Описание настройки: Настройки Debezium

Вопрос: По каким причинам может не работать Сервис уведомлений (dh-email-notifications)?

Ответ: Возможный вариант решения проблемы – со стороны DevOps-инженеров (или иных сотрудников, разворачивающих сервисы) необходимо проверить настройки для данного Сервиса (dh-email-notifications).

img

img

В настройках необходимо настроить HOST и PORT.

img

Затем указать адрес SMTP-сервера.

Настройка Сервиса email-notifications необязательна для работоспособности Платформы.

Вопрос: Возникла ошибка, которую невозможно интерпретировать по тексту в пользовательском интерфейсе или консоли разработчика. Что можно предпринять для диагностики?

Ответ: Для диагностики необходимо самостоятельно или с привлечением команды DevOps проанализировать логи сервисов. Следует определить, к какому сервису выполнялось обращение в момент ошибки, и последовательно изучить его логи, а также логи зависимых сервисов по цепочке вызовов.

Вопрос: В системе не работает полнотекстовый поиск, какие возможны причины?

Ответ: Необходимо проверить настройки топика Kafka – сервис-индексатор полнотекстового поиска может слушать не тот топик Kafka, из-за чего данные не попадают в Elasticsearch. Необходимо обратиться к команде DevOps для проверки и корректировки конфигурации топиков. Также возможны проблемы с настройками Elasticsearch. Также для обеспечения полноценной работы полнотекстового поиска и индексации содержимого файлов необходимо установить и настроить Debezium.

Вопрос: Почему в реестре процессов не создается экземпляр процесса?

Ответ: Необходимо проверить корректность настройки сервисов Zeebe, Operate и Elasticsearch. Сервис Operate для отображения данных использует индексы, созданные Zeebe, поэтому оба сервиса должны быть настроены на подключение к одному и тому же экземпляру или кластеру Elasticsearch.

Вопрос: Почему появляется ошибка «Отсутствуют актуальные лицензионные условия»?

Ответ: На версиях 1.10 и 1.11 данная ошибка не влияет на работоспособность системы.

Вопрос: Проблема с индексацией поиска. Почему может не выполняться поиск по объектам?

Ответ: Необходимо указать настройки для подключения любого документного сервиса к индексированию контента (на примере «ldm-system-objects-service»):

1. Настройки «dh-federal-search-service»:

  • через сервис конфигураций необходимо добавить в переменную docshouse.federal-search.services.names в конец списка наименование нового сервиса:
docshouse.federal-search.services.names = dh-documents-service,...,ldm-system-objects-service

или с помощью DevOps-инженеров в переменную окружения FEDERAL_SEARCH_INDEXED_SERVICES_NAME;

  • через сервис конфигураций необходимо добавить в переменную docshouse.federal-search.services.topics в конец списка наименование топика нового сервиса:
docshouse.federal-search.services.topics = test-dh-documents-service-topic,...,test-ldm-system-objects-service-topic

или с помощью DevOps-инженеров в переменную окружения FEDERAL_SEARCH_CHANGED_ACL_SERVICES_TOPICS.

2. Настройки «ldm-index-content-controller-service»:

  • через сервис конфигураций добавить в переменную ldm.index-content-controller.documentsApplications в конец списка наименование нового сервиса:
ldm.index-content-controller.documentsApplications = dh-documents-service,ldm-system-objects-service
  • через сервис конфигураций добавить в переменную ldm.index-content-controller.documentsTopics в конец списка наименование топика нового сервиса:
ldm.index-content-controller.documentsTopics = test-dh-documents-service-topic,test-ldm-system-objects-service-topic

или с помощью DevOps-инженеров в переменную окружения DH_INDEX_CONTENT_CONTROLLER_KAFKA_LISTENER_TOPIC_LIST.

3. Перезапустить «dh-federal-search-service» и «ldm-index-content-controller-service».

На вашем стенде префикс сервисов может отличаться (в примере указан префикс «test»).

Настройки маршрутизации распознавания контента файлов описаны в документации: Настройки маршрутизации распознавания контента файлов