Support / bug reports (testing)

What to include in a report

Every report should contain the following:

• Version: git commit hash (или tag), OS/kernel.
• Launch config: конфиг (angarabase.conf) и команда запуска.
• Reproduction steps: SQL/шаги/клиент (psql/ORM/tool).
• Expected vs actual behavior: что ожидалось и что произошло.
• Artifacts:
• Логи сервера.
• Если это crash/recovery/backup тема: summary.json и папку artifacts/ целиком.

Helpful tooling (already in repo)

Nightly-style evidence pack

Запуск локальной evidence-пачки (один прогон):

tools/ci/nightly_gate.sh --runs 1 --root artifacts/nightly_local

Diagnostics bundle

Сбор диагностического бандла:

tools/diagnostics_bundle/run.sh --root artifacts/diagnostics_bundle

Specific scenarios

Hang / stall

Если проблема — зависание или stall:

• Приложите client-side timeout/hang описание.
• Приложите логи сервера.
• Приложите stack trace или diag bundle (если возможно).
• Проверьте known issues — в частности KI-2026-001 (pg_database probe stall).

Crash / recovery

• Приложите summary.json из artifacts/.
• Приложите полный каталог artifacts/.
• Укажите, было ли это при обычном запуске, при restart или при backup/restore.

Unexpected SQLSTATE

• Укажите полный текст ошибки (SQLSTATE код + message).
• Проверьте known issues — многие SQLSTATE коды документированы как ожидаемое поведение.

Дальше

• Известные ограничения и SQLSTATE — проверьте, не описана ли ваша проблема как известное ограничение.
• Совместимость клиентов — если проблема в драйвере или клиенте.
• Диагностика — как собрать EXPLAIN, slow-log, sys.*-снимок для прикрепления к issue.