Docs: подробная запись сессии 2026-08-17 (loadtest, анализ 64KB contracts-flask)

2026-08-17 17:21:19 +04:00
parent 25f163ea5e
commit c0916d5642
1 changed files with 158 additions and 0 deletions
@@ -0,0 +1,158 @@
+# Сессия 2026-08-17 — LoadTest (проверка загрузки больших файлов)
+
+_Файл: подробная запись содержимого чата. Дата: 2026-08-17._
+_Сервис: `loadtest.pythonk8s.dev.nubes.ru` (платформа Nubes, pythonk8s)._
+_Цель: проверить, доходят ли файлы (в т.ч. большие) до бэкенда или нет._
+
+---
+
+## 1. Задача (из чата)
+
+1. Создан пустой git-репозиторий `https://gitea.services.ngcloud.ru/sqs/loadtest.git`.
+2. Склонировать его в `/home/naeel/nubes/contracts/loadtest`.
+3. Сделать код по `howto-flask-nubes.md` для деплоя на Flask-платформу Nubes.
+4. Функционал: меню выбора одного файла из локали + загрузка в память Flask.
+5. Индикация прогресса загрузки — `%` и таймер (позже таймер признан неважным).
+6. **Главное** — однозначный результат: файл загрузился ИЛИ нет, максимум статистики.
+7. Код — простейший, с комментариями.
+
+## 2. Инстанс платформы (из параметров)
+
+- `instanceUid`: `bb9ed30b-1794-44ff-81a2-6ff2731200c9`
+- `connectionUrl`: `https://loadtest.pythonk8s.dev.nubes.ru/`
+- `resourceRealm`: `iot-naeel`
+- `appConfiguration` изначально: `gitPath=https://github.com/Foxyhhd/Baldurs-Gate-test.git`, `version=3.12`, `healthPath=""`
+- `clusterConfiguration`: cpu 500, memory 1024, replicas 1
+- Мониторинг: Grafana kubernetes-pods по namespace `bb9ed30b-…`
+
+**Для деплоя нужно сменить `gitPath` на `https://gitea.services.ngcloud.ru/sqs/loadtest.git`.**
+
+## 3. Что сделано
+
+### 3.1 Клонирование
+- `git clone https://gitea.services.ngcloud.ru/sqs/loadtest.git .` — успешно, ветка `master`, коммитов не было.
+
+### 3.2 Структура (обязательна по howto-flask-nubes — без `site/` платформа не запустится)
+```
+loadtest/
+├── .gitignore            # __pycache__, *.pyc
+├── requirements.txt      # Flask>=3.0, gunicorn>=21.2, requests>=2.31
+└── site/
+    ├── app.py            # точка входа (python site/app.py)
+    ├── static/style.css
+    └── templates/index.html
+```
+- НЕТ `site/__init__.py` (конфликт со stdlib `site.py`).
+- В `app.py` обязателен `app.run(host="0.0.0.0", port=5000)`.
+
+### 3.3 Код
+**`site/app.py`**:
+- `GET /` — страница; `GET /health` — `ok`.
+- `POST /upload` — принимает multipart-файл в поле `file`, читает **в память** (`f.read()`), на диск не пишет.
+- `MAX_CONTENT_LENGTH` **не задан** — цель проверить реальные лимиты платформы/прокси, а не Flask.
+- Ответ — максимум статистики: `file` (name, mime, size_bytes, size_mb), `server` (read_ms, total_ms, speed_mb_s), `md5`, `meta` (server_start, remote_addr, content_length_header, content_type_header, user_agent).
+
+**`site/templates/index.html`**:
+- Выбор одного файла + кнопка «Загрузить».
+- Загрузка через **`XMLHttpRequest`** + `xhr.upload.onprogress` — реальный `%` и скорость МБ/с (`fetch` не даёт upload progress).
+- Минимальный таймер (секунды), timeout XHR = 10 мин.
+- Исход всегда однозначный: ✅ «ФАЙЛ ЗАГРУЖЕН» / ❌ «НЕ ЗАГРУЖЕН (HTTP …)» / «СЕТЕВАЯ ОШИБКА» / «ТАЙМАУТ (10 мин)».
+- При ошибке показывается HTTP-статус и текст ответа (в т.ч. не-JSON: 413, HTML ошибок прокси).
+- Статистика: клиент (имя, размер, время старта, длительность, средняя скорость) + сервер (принято байт, чтение мс, обработка мс, скорость, MD5, заголовки, remote addr, время сервера, User-Agent).
+
+### 3.4 Локальный тест (curl, 127.0.0.1:5000)
+| Файл | Результат | Примечание |
+|---|---|---|
+| 1 МБ | ok | read 4.86 мс |
+| 10 МБ | ok | read 10.61 мс |
+| 100 МБ | ok | total 0.78 с, ~133 МБ/с |
+
+- `GET /`, `/health`, `/static/style.css` — 200.
+
+### 3.5 Коммит и пуш
+- 2 коммита (второй — убрал `__pycache__/*.pyc` из индекса, добавил `.gitignore`).
+- Пуш в gitea: ветка `master` создана, `origin/master` отслеживается.
+- Файлы в репо: `.gitignore`, `requirements.txt`, `site/app.py`, `site/static/style.css`, `site/templates/index.html`.
+
+## 4. Анализ: скорость «клиент» vs «сервер»
+
+Пример из реального теста (VirtualBox-7.2.8-173730-Win.exe, 177 853 032 байт = 169.614 МБ):
+
+```
+-- КЛИЕНТ --
+Длительность: 20.84 с
+Средняя скорость (клиент): 8.14 МБ/с
+-- СЕРВЕР --
+Чтение в память: 816.43 мс
+Обработка всего: 3308.25 мс
+Скорость (сервер): 207.75 МБ/с
+```
+
+- **Скорость клиента** (8.14 МБ/с) — браузер: размер ÷ полное время (нажатие → ответ). Реальная скорость передачи по сети клиент → прокси → сервер, со всеми задержками. **Главный показатель для диагностики** загрузки.
+- **Скорость сервера** (207.75 МБ/с) — `app.py`: размер ÷ `f.read()`. Это локальное чтение уже дошедших байт из памяти, сеть ни при чём. Всегда высокая.
+- Признак проблемы загрузки: клиентская скорость низкая/нулевая или обрыв до 100%; серверная при этом «красивая».
+
+## 5. Ключевая находка: «64KB» в contracts-flask — это СИМПТОМ, не лимит
+
+### 5.1 Факты из History (проект contracts)
+- `History/llm-analysis/sonnet-upload-from-scratch.md` — гипотеза «POST > 64KB → Ingress рвёт TCP (HTTP 000), 64KB — жёсткий предел платформы». **Гипотеза.**
+- `History/sessions/session-08-upload-saga.md` — реальные корневые причины:
+  1. `original_bytes BYTEA NOT NULL` → PostgreSQL 500 при вставке `original_b64`.
+  2. `base64.b64decode()` + BYTEA INSERT > 30 с → таймаут Ingress → обрыв соединения.
+  3. `session-07`: до 7 отдельных DB-подключений на сборку чанков → медленно.
+- `History/sessions/session-10-lucee-pipeline.md` — **ddos-guard рвёт HTTP/2-стримы на POST > ~50KB** (HTTP/2 PROTOCOL_ERROR) на платформе `services.ngcloud.ru`.
+- `History/features/upload-analysis-v40.md` — даже Redis-очередь (RPUSH → 200 сразу, v1.38-1.39) падала ✗; curl 100KB → случайные HTTP 000.
+
+**Вывод:** «64KB» — порог, после которого обработка на сервере не успевала до таймаута прокси, + ddos-guard рвал крупные POST на `services`. Это не объективный лимит размера тела.
+
+### 5.2 Порядок HTTP-запроса (важно для понимания)
+1. Браузер передаёт тело (сеть). Обработка ещё не идёт.
+2. Тело полностью дошло до сервера.
+3. Вызывается обработчик (декодирование, INSERT, парсинг).
+4. Сервер отвечает.
+
+«Параллельности» обработки с передачей нет. Проблема — **медленный ответ после приёма тела** (`proxy_read_timeout` на Ingress): файл дошёл, а соединение оборвано до ответа → «Сеть»/HTTP 000.
+
+### 5.3 Почему loadtest грузит без проблем
+- Бэкенд тривиальный: `f.read()` → MD5 → JSON. Никакой БД/Redis/декодирования/парсинга → ответ мгновенный → прокси не успевает оборвать.
+- Плюс это dev-платформа (`pythonk8s.dev.nubes.ru`), где нет ddos-guard-обрыва крупных POST, как на `services`.
+
+## 6. Текущее состояние contracts-flask `/upload` (диагноз)
+
+`contracts-flask/site/routes/upload_bp.py`, `/upload` — всё синхронно до ответа:
+1. `data = f.read()`
+2. `content_hash = hashlib.sha256(data)…`
+3. `documents.insert(..., original_bytes=base64.b64encode(data).decode(), ...)` — base64 ВСЕГО файла → БД
+4. `result = parse_file(f.filename, data)` — **синхронный парсинг**
+5. `documents.set_parsed(...)` / `set_error(...)`
+6. `return jsonify(...)`
+
+Прочее:
+- `site/config.py`: `MAX_CONTENT_LENGTH = 200 * 1024 * 1024` (200 МБ) — не причина.
+- `site/app.py`: `app.run(..., threaded=True)`, БД — SQLite (thread-local).
+- Фронт `site/static/files.js:uploadFile` — `fetch` (реального `%` нет, только таймер), v2.0.3.
+
+## 7. Предложенные правки contracts-flask (по приоритету, НЕ ВНЕСЕНЫ)
+
+1. **Вынести парсинг из `/upload`** (главное): `/upload` = принять → сохранить → мгновенный `ok`; `parse_file` — в фоновый `threading.Thread` (паттерн есть в `pipeline_bp.py`) или отдельный endpoint `/parse`.
+2. **Убрать `base64.b64encode(data)`** при вставке — хранить сырые байты (BLOB/BYTEA) или не хранить исходник.
+3. **Клиент: `XMLHttpRequest` + `xhr.upload.onprogress`** — реальный `%` + явный статус «дошёл/не дошёл».
+4. `MAX_CONTENT_LENGTH` 200 МБ — оставить; ограничения ddos-guard/Ingress на `services` — вне кода.
+
+## 8. Открытые вопросы / следующий шаг
+
+- В UI loadtest нужно показать размер выбранного файла с разбивкой по 3 цифры (например `177 853 032`) — **отложено**, «при следующей правке».
+- Правки в `contracts-flask` (раздел 7) — **ожидают команды «делай»** и уточнения объёма (всё 4 пункта или только п.1).
+
+## 9. Полезные команды
+
+```bash
+# локальный запуск
+cd /home/naeel/nubes/contracts/loadtest && python3 site/app.py
+
+# тест загрузки
+curl -s --max-time 180 -F "file=@/tmp/lt_100mb.bin" http://127.0.0.1:5000/upload
+
+# логи пода на платформе
+kubectl -n bb9ed30b-1794-44ff-81a2-6ff2731200c9 logs deploy/pythonk8s --tail=50
+```