Техническая поддержка

Техническая поддержка

🚫

Перед созданием обращения обязательно обновите версии сервисов Digital Q.BPM, в которых возникла проблема, до актуальной версии

Общая информация

Перед созданием обращения необходимо диагностировать и проанализировать проблему самостоятельно. В большинстве случаев при качественном анализе привлечение производственной команды не требуется.
Для самостоятельного анализа вам необходимо проверить ошибки на вкладках network и console в браузере. Проверить логи сервиса на наличие ошибок.
Описание распространенных ошибок при публикации и выполнении процессов
Описание распространенных ошибок при запуске сервисов

Мы принимаем обращения через supportmsa@diasoft.ru

При обращении следует уточнять приоритет задачи и его обоснование (opens in a new tab)

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

  1. Последняя допустимая дата реализации/консультации.
  2. Приоритет (низкий/средний/высокий/очень высокий).

Если речь идет о доработках, на сроки также влияют:

  1. Открыт ли спринт для планирования.
  2. Достаточно ли предоставлено информации о требуемой доработке.
  3. Насколько ближайшие спринты загружены.

Решение несоответствий (НСЕ) и консультаций

Обязательная информация в описании задачи

  1. Ссылка на страницу и стенд, где воспроизводится проблема. Доступы к стенду/неймспейсу.
  2. Какая задача решается (название задачи) - нужно описать, с чем придется работать. Хорошо помогает назвать задачу, если применить следующий принцип: «Что произошло?», «Где?», «Когда?», «При каких условиях?».
  3. Описание проблемы - необходимо, исходя из названия, дать развернутый ответ проблемы.
  4. Шаги воспроизведения – необходимо детально описать по шагам, что нужно сделать для воспроизведения бага.
  5. Ожидаемый результат.
  6. Фактический результат.
  7. Версии сервисов Digital Q.BPM на стенде.
  8. Ошибка на вкладках network и console в браузере.
  9. Логи сервиса, где возникает ошибка
  10. Скриншот/Видео – предоставить скриншот или запись экрана.

Анализ ошибок

Снятие HeapDump через Spring Boot Actuator

Для диагностики проблем с памятью (OutOfMemoryError) или зависаниями микросервиса необходимо снять дамп памяти (heapdump).
Для активации эндпоинта необходимо добавить соответствующий параметр в ConfigMap сервиса и перезагрузить сервис. После перезагрузки снять heapdump можно будет по ссылке https://<serviceName>.<nameSpace>.<cluster-domain>/<serviceName>/actuator/heapdump

  management.endpoints.web.exposure.include: heapdump

Все доступные эндпоинты, в параметре перечисляются через запятую. Пример:

 management.endpoints.web.exposure.include: health,info,loggers,metrics,prometheus,heapdump,threaddump,lowcode

/health — проверка состояния приложения (жив/мертв), используется для Kubernetes probes
/info — мета-информация о приложении (версия, git-коммит, время сборки)
/loggers — просмотр и изменение уровней логирования в runtime
/metrics — метрики производительности (память, GC, HTTP-запросы, CPU)
/prometheus — метрики в формате Prometheus (для Grafana)
/heapdump — дамп памяти (HPROF) для анализа утечек и OOM
/threaddump — дамп всех потоков JVM для анализа deadlock'ов и зависаний
/lowcode — информация о low-code компонентах (процессы, модели, деплои)

Руководство администратораВыпуски Digital Q.BPM