Cold start is too slow

Если cold start заметно превышает ожидания, важно отличить нормальную «первую прогрузку» от проблем инфраструктуры.

Норма

• Типичный cold start: до ~5 секунд (< 5 с).
• Если БД давно не запускалась, большой объём WAL или идёт интенсивная запись в момент старта — запуск может занять дольше.

Диагностика

1. Проверьте состояние БД в Console:

   • state и target_scale/current_scale;
   • worker_id (если уже назначен);
   • updated_at / last_used_at.

2. Запустите БД вручную (Console → Start) и наблюдайте:

   • уходит ли БД из starting/booting в ready;
   • нет ли быстрого отката обратно в stopped или перехода в error.

3. Посмотрите логи (Console → Monitoring → Logs):

   • ошибки TLS/сертификатов;
   • ошибки подключения к storage/Pageserver;
   • ошибки bootstrap (миграции, расширения).

4. Исключите проблемы на стороне клиента:

   • sslmode=require включён;
   • DNS/файрволл не блокирует <gateway-host>:5432;
   • драйвер не делает агрессивный connect_timeout (например 1–2 секунды) без retry.

Типовые причины

• Нет ресурсов под compute (очередь/лимиты в кластере).
• Долгий replay/инициализация (большая БД, много изменений с прошлого запуска).
• Проблемы со storage (S3 latency/ошибки, деградация Pageserver).
• Некорректные секреты/ротация (pg_password не совпадает, цепочка CA устарела в self-hosted).

Что собрать для обращения в поддержку

• tenant и db (имя + db_id);
• время и часовой пояс попыток подключения;
• состояние БД и worker_id;
• 20–30 строк логов вокруг старта (без секретов).