Общие принципы диагностики проблем работы бизнес-процессов

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

Диагностика проблем выполнения бизнес-процессов

Сбор информации по проблеме

1. Проверить архитектуру развертывания приложения:
   • Количество нод, использованных при инсталляции;
   • Применение RabbitMQ для выполнения бизнес-процессов.
2. Определить окружение, на котором воспроизводится проблема: prod / test / dev.
3. Уточнить периодичность возникновения проблемы.
4. Проверить выполнялся ли ранее бизнес-процесс. Если да — определить, с какого момента начались сбои (дата и время).
5. Определить с каким именно бизнес-процессом возникла проблема:
   • Изменялся ли базовый бизнес-процесс;
   • Если использовался кастомный бизнес-процесс, то подготовить экспорт метаданных процесса в формате *.md (из конфигурации).
6. Уточнить точное время возникновения ошибки.
7. Извлечь и проанализировать логи приложения с учетом времени воспроизведения.

Поиск причины проблемы

Определить на каком этапе процесса возникает ошибка:

1. Стартовый событийный сигнал:
   • Проверить корректность фильтров и условий старта;
   • Убедиться в корректности событийной модели объекта (нет ли влияния пользовательской логики).
2. Если используется стартовый или промежуточный таймер, то перейти к проверке планировщика Quartz.
3. Завершение процесса:
   • Если процесс «зависает» — проанализировать проблему завершения как самого бизнес-процесса, так и его элементов;
   • Проверить завершились ли все элементы, не заблокированы ли потоки.
4. Ошибка в другом элементе процесса:
   • Поискать ошибки в логах и трассировке. Подробнее: Трассировка параметров;
   • Определить в каком методе происходит сбой (по stacktrace);
   • Проанализировать стандартный код, если используется встроенный метод.
5. Если бизнес-процессы работают медленно:
   • Если один процесс:
     • Проверить диаграмму выполнения: где тратится время?
     • Есть ли многоэкземплярные подпроцессы?
     • Проанализировать SQL-запросы, выявить возможные блокировки.
   • Если все процессы:
     • Есть ли общие проблемы производительности?
     • Оценить нагрузку: сколько процессов запускается в час?
     • Проверить объемы таблиц:
       • SysProcessData;
       • SysProcessElementData;
       • SysPrcPresistentStore.
     • При необходимости — настроить очистку этих таблиц.
6. Дополнительно при анализе пользовательского процесса:
   • Проверить наличие и корректность подпроцессов.
   • При нестабильном или неожиданном поведении:
     • Включить трассировку процесса. Подробнее: Трассировка параметров;
     • Проанализировать полученный stacktrace.

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

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

1. Версия и сборка BPMSoft — эта информация требуется для проверки гипотез на инфраструктуре, приближенной к вашей, а также анализа решенных проблем при выпуске новых версий BPMSoft.
2. Подробное пошаговое описание действий, приводящих к возникновению ошибки — подробная информация о проблеме ускоряет анализ и решение.
3. Дата и время возникновения ошибки — эта информация необходима для максимально точного исследования причин возникновения проблемы.
4. Метаданные кастомного или измененного базового бизнес-процесса, экспортированные из конфигурации в формате .md — эта информация необходима для анализа влияния доработок на логику работы приложения.
5. Скриншоты из журнала процессов со списком выполненных элементов, полной трассировкой стека ошибок и диаграммы выполнения бизнес-процесса — эта информация необходима для более точного понимания ситуации возникновения проблемы.
6. Полные логи приложения за день возникновения ошибки — эта информация необходима для исследования проблемы и причин ее возникновения.
7. Результаты предварительного анализа влияния проектного слоя — эта информация способствует ускорению решения обращения за счет минимизации количества проверяемых гипотез.

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

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