- 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>
66 lines
3.8 KiB
Markdown
66 lines
3.8 KiB
Markdown
# `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 контейнера
|
||
|
||
```text
|
||
$ 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`. Первые записи каждого
|
||
вида (поля сокращены):
|
||
|
||
```json
|
||
{"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`: в общем журнале нескольких реплик видно, какая
|
||
остановилась.
|
||
|
||
Чего в журнале нет:
|
||
|
||
```text
|
||
отправленные значения Idempotency-Key (replay.md): найдено 0
|
||
текст сообщения «Привет из evidence»: найдено 0
|
||
```
|
||
|
||
Сервис `migrate` пишет свой `instance_id` — короткий ID своего
|
||
контейнера (`0b3e5b92d7a6` при первом `make run_docker` этого change).
|