Files
mtusi2026lab3/evidence/idempotency/instance-id.md
T
ricoromaandClaude Opus 5.5 c5840bfaa8 docs: add idempotency and X-Instance-Id evidence to the report
- 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>
2026-10-10 17:08:47 +03:00

66 lines
3.8 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.
# `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).