Files
mtusi2026lab2/evidence/storage/statement-timeout.md
T
ricoromaandClaude Opus 5.5 484914c38a docs: add evidence for postgres-storage verify fixes
- statement timeout: 503 and no SQL parameters in logs, before and after
- failed migration keeps the API from starting
- fresh clone: console from zero, then docker and make down
- restart evidence with docker compose ps

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 16:47:42 +03:00

71 lines
4.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# `statement_timeout`: 503, а в журнале нет параметров SQL
| | |
|---|---|
| Спеки | `data-storage` «Ограниченный пул соединений и таймауты» (истёкший таймаут — 503); `service-logging` «Без содержимого сообщений и личных данных» |
| Change | `postgres-storage`, задача 9.1 (дефект нашёл `/opsx:verify`) |
| Дата | 2026-10-01 13:39 UTC (до), 13:42 UTC (после) |
| Commit | до — образ из `2d0a7c8` (в `/app/src/infra/db/engine.py` нет `hide_parameters`); после — `125145d` |
| Стенд | `make run_docker` (compose: postgres, migrate, api), API на `127.0.0.1:8080` |
| Хост | Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7 GiB RAM; лимиты контейнерам не задавались |
| Таймауты | по умолчанию: `statement_timeout_ms=5000`, `request_timeout_seconds=6` |
| Клиент | разовый stdlib-скрипт. Текст T — синтетическая строка `SYNTHETIC-<uuid>`, проверяется только её наличие в журнале. Id сокращены |
## Как воспроизведено
Таблица `messages` на 8 с захвачена в отдельной сессии `psql`:
```sql
BEGIN; LOCK TABLE messages IN ACCESS EXCLUSIVE MODE; SELECT pg_sleep(8); COMMIT;
```
Через 1 с после захвата alice отправляет сообщение с текстом T.
`INSERT` ждёт блокировку, через 5 с Postgres отменяет его по
`statement_timeout` (SQLSTATE `57014`), и `get_db_session` переводит
`DBAPIError` в 503 с записью `warning`.
## До: образ из `2d0a7c8`, без `hide_parameters`
| Запрос | Статус | Результат | Время |
|---|---|---|---|
| `POST …/messages` (alice, текст T) | 503 | `unavailable` | 5,05 с |
| `POST …/messages` (после снятия блокировки) | 201 | id `29e7c6c2…` | 0,02 с |
```json
{"timestamp": "2026-10-01T13:40:01.548127Z", "event": "Database is unavailable", "error_type": "DBAPIError", "error": "(sqlalchemy.dialects.postgresql.asyncpg.Error) canceling statement due to statement timeout\n[SQL: INSERT INTO messages (id, chat_id, sender_id, text, created_at) VALUES ($1::UUID, $2::UUID, $3::UUID, $4::VARCHAR, $5::TIMESTAMP WITH TIME ZONE)]\n[parameters: (UUID('a4817181-248e-47d5-a834-057f322f9e70'), UUID('77751dff-1589-42ba-9c75-9eb5f0fc0fe1'), UUID('b3733c1a-bb29-4977-b3d8-b6c4c655dd99'), 'SYNTHETIC-a9a422599076455184c9abca6227c3c2', datetime.datetime(2026, 10, 1, 13, 39, 56, 526563, tzinfo=datetime.timezone.utc))]\n(Background on this error at: https://sqlalche.me/e/21/dbapi)", "level": "warning"}
```
| Проверка журнала за время сценария | Результат |
|---|---|
| текст T встречается | **да** |
| `[parameters: ...]` встречается | **да** |
## После: `125145d`, `hide_parameters=True`
| Запрос | Статус | Результат | Время |
|---|---|---|---|
| `POST …/messages` (alice, текст T) | 503 | `unavailable` | 5,04 с |
| `POST …/messages` (после снятия блокировки) | 201 | id `0e93be85…` | 0,04 с |
Текст ошибки в ответе: `Service is temporarily unavailable`.
```json
{"timestamp": "2026-10-01T13:42:17.053907Z", "event": "Database is unavailable", "error_type": "DBAPIError", "error": "(sqlalchemy.dialects.postgresql.asyncpg.Error) canceling statement due to statement timeout\n[SQL: INSERT INTO messages (id, chat_id, sender_id, text, created_at) VALUES ($1::UUID, $2::UUID, $3::UUID, $4::VARCHAR, $5::TIMESTAMP WITH TIME ZONE)]\n[SQL parameters hidden due to hide_parameters=True]\n(Background on this error at: https://sqlalche.me/e/21/dbapi)", "level": "warning"}
```
| Проверка журнала за время сценария | Результат |
|---|---|
| текст T встречается | нет |
| `[parameters: ...]` встречается | нет |
| `SQL parameters hidden due to hide_parameters=True` | да |
## Вывод
- `statement_timeout` даёт 503 `unavailable` через 5 с, раньше срока
запроса 6 с. После снятия блокировки сервис отвечает 201 без
рестарта.
- До исправления строка ошибки драйвера несла все параметры `INSERT`,
включая текст сообщения. С `hide_parameters=True` в журнале остаются
SQL и причина, а параметров нет. Тот же флаг скрывает их и в
traceback ошибки 500.