Общие принципы диагностики проблем интеграций и инфраструктуры

В статье описаны основные подходы к диагностике проблем при настройке интеграций и инфраструктуры BPMSoft.

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

• Входящие интеграции с веб-сервисами (REST);
• Исходящие интеграции с веб-сервисами (SOAP, REST);
• Базовые сервисы работы с данными (OData, DataService);
• Сервисы обогащения данных (например, DaData);
• Синхронизация пользователей и авторизация по LDAP;
• Авторизация через SSO.

Этапы диагностики

1. Собрать следующую информацию:
   • Инфраструктура развертывания приложения;
     • Количество нод (серверов);
     • Используется ли прокси-сервер или балансировщик нагрузки (например, HAProxy, Nginx);
   • Логи BPMSoft и затронутых внешних/внутренних сервисов;
   • Файлы конфигурации BPMSoft;
   • Описание шагов, при которых воспроизводится проблема.
2. Проверить настройки:
   • Корректность маршрутов и политик доступа;
   • Работу сессий (в том числе липкие сессии при использовании BPMSoft на платформе .NET Core/.NET 8);
   • Убедиться в наличии и корректности конфигурации интеграции (например, URL, авторизация, заголовки).
3. Если есть признаки проблем на уровне инфраструктуры, то провести анализ конфигурации балансировщика:
   • HAProxy: обратить внимание на алгоритмы балансировки и тайм-ауты.
   • Nginx: проверить типовые ошибки:
     • 499 — клиент разорвал соединение (причины: пользователь прервал загрузку, тайм-аут клиента меньше серверного).
     • 429 — превышен лимит запросов (причины: rate limiting, высокий трафик, DDoS, ошибки конфигурации).

Информация для обращения в техническую поддержку

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

1. Версия и сборка BPMSoft — эта информация требуется для проверки гипотез на инфраструктуре, приближенной к вашей, и анализа решенных проблем при выпуске новых версий BPMSoft.
2. Версия операционной системы — эта информация требуется для проверки гипотез, связанных со спецификой используемой операционной системы.
3. Инфраструктурные параметры среды:
   • Количество нод приложения;
   • Характеристики CPU и объем RAM;
   • Наличие и тип прокси-серверов и балансировщиков нагрузки.
4. Подробное пошаговое описание действий, приводящих к возникновению проблемы – подробная информация о проблеме ускоряет анализ и решение.
5. Описание способа реализации интеграции, в которой возникает ошибка — эта информация необходима для анализа способа реализации интеграции и проверки гипотез возникновения проблемы.
6. Дата и время возникновения ошибки — эта информация необходима для максимально точного исследования причин возникновения проблемы.
7. Если проблема проявляется на клиентской стороне:
   • HAR-файл, записанный в момент воспроизведения ошибки;
   • Скриншоты консоли браузера (вкладки Console и Network).
8. Если проблема возникает на уровне back-end:
   • Пример запроса, воспроизводящего ошибку (например, через Postman).
9. Конфигурационные файлы BPMSoft, относящиеся к окружению — эта информация требуется для анализа режимов работы BPMSoft и микросервисов.
10. Логи приложения за день возникновения ошибки — эта информация необходима для исследования проблемы и причин ее возникновения.
11. Графики утилизации ресурсов (CPU, RAM, дисковое пространство и сетевые интерфейсы) за соответствующий период — эта информация необходима для анализа возникающей нагрузки на системы при реализации интеграции.
12. Результаты анализа возможного влияния изменений на проектном слое — эта информация способствует ускорению решения обращения за счет минимизации количества проверяемых гипотез.

Решение типовых неполадок

Конфигурационные веб-сервисы

Использование PATCH и DELETE методов при создании конфигурационного веб-сервиса

OData

Ошибка «Не найден HTTP-ресурс, соответствующий URI запроса»

Рекомендуем изучить

Системные требования BPMSoft