- evidence for replay, conflict, replay through a new API process and after restarting API and storages, keys table, key race, X-Instance-Id in responses and logs, explicit and invalid instance_id and key TTL, test runs - stand evidence: make wipe_data leaves the lab 2 volume intact, build from a fresh git clone passes smoke, bench restore stage sends with Idempotency-Key - REPORT.md: X-Instance-Id, idempotency design, IDEMPOTENCY_TTL_SECONDS mapping, limitations and evidence rows - tasks.md: mark the change tasks done, add follow-ups from verify Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.8 KiB
X-Instance-Id и instance_id в журнале
| Спеки | service-configuration «Hostname по умолчанию»; service-logging «Поиск по реплике», «Повтор с ключом»; api-conventions «Одно значение на процесс» |
| Change | instance-id-idempotency, задача 9.1 |
| Дата | 2026-10-08 16:44:53–16:44:59 UTC |
| Commit | af4bca0 |
| Стенд | make run_docker: проект mtusi-lab3, один контейнер api (образ из af4bca0), 127.0.0.1:8080, без балансировщика; instance_id в .env, config.toml и compose не задан |
| Хост | Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7,7 GiB RAM; лимиты контейнерам не задавались |
Значение — hostname контейнера
$ docker compose ps -q api | cut -c1-12
7956d7741a15
$ curl -sD - -o /dev/null http://localhost:8080/health/live | grep -i x-instance
x-instance-id: 7956d7741a15
docker compose restart api — тот же контейнер, новый процесс:
| Контейнер | StartedAt |
X-Instance-Id |
|
|---|---|---|---|
| до | 7956d7741a15 |
2026-10-08T16:44:10.628095468Z | 7956d7741a15 |
| после restart | 7956d7741a15 |
2026-10-08T16:44:54.716801044Z | 7956d7741a15 |
Hostname у перезапущенного контейнера прежний, поэтому и значение
прежнее. Новый контейнер — новое значение (replay-after-restart.md:
9b306176dcf4). stop-one.sh (change replicas-lb) по этому значению
найдёт контейнер без таблицы соответствия.
Журнал: instance_id в каждой записи
docker compose logs api --no-log-prefix после отправок из replay.md
и docker compose restart api: 85 JSON-записей, без instance_id — 0,
значений instance_id — одно: 7956d7741a15. Первые записи каждого
вида (поля сокращены):
{"event": "Started API", "instance_id": "7956d7741a15"}
{"event": "HTTP request completed", "instance_id": "7956d7741a15", "request_id": "1f65121ccd6d42679bd6c33a6582e44e", "method": "POST", "path": "/api/v1/users", "status": 201}
{"event": "Created message", "instance_id": "7956d7741a15", "request_id": "1060e6ab3e614eb08e9865e169ac9574", "message_id": "e046a2b6-bae7-4a69-8a74-f5cfa3ec7b04", "replayed": false, "method": "send_message"}
{"event": "Replayed message", "instance_id": "7956d7741a15", "request_id": "813240a323604d5a86f1e39ae5a4d465", "message_id": "e046a2b6-bae7-4a69-8a74-f5cfa3ec7b04", "replayed": true, "method": "send_message"}
{"event": "Shutting down", "instance_id": "7956d7741a15"}
{"event": "Waiting for application shutdown.", "instance_id": "7956d7741a15"}
{"event": "Stopped API", "instance_id": "7956d7741a15"}
{"event": "Finished server process [1]", "instance_id": "7956d7741a15"}
Created message / Replayed message здесь — от публичного smoke
(make test) перед сбором: повтор того же сообщения виден по
replayed: true и тому же message_id. Строки uvicorn о shutdown тоже
несут instance_id: в общем журнале нескольких реплик видно, какая
остановилась.
Чего в журнале нет:
отправленные значения Idempotency-Key (replay.md): найдено 0
текст сообщения «Привет из evidence»: найдено 0
Сервис migrate пишет свой instance_id — короткий ID своего
контейнера (0b3e5b92d7a6 при первом make run_docker этого change).