Files
trex-core/docs/batches/bat-045_20260616_observability-logging-foundation/implementation.md
T
genichinandClaude Opus 4.8 d8d9021260 feat(execution,obs): 호가단위 스냅(dcy-030/#28) + 운영 관측성(dcy-029/#29) + REL-007 환류
dcy-030 (issue #28, P0 체결 복구):
- REQ-083 KRX 호가단위(tick) 순수 유틸 (domain/pricing.py)
- REQ-070 CHG: 슬리피지 실효가 호가단위 스냅 — 상한 준수(매수 floor/매도 ceil)
  + band<1tick 하한/상한 보장 + 부동소수 epsilon 가드. 147700→148400/54500→54700.
- BAT-044 release-candidate

dcy-029 (issue #29, 운영 관측성):
- REQ-084 구조화 로깅 기반 (runtime/logging_setup.py): ISO8601 KST·레벨·Loki JSON
  ·correlation id(slot_id)
- REQ-085 주문 결과 로깅 (event=order_submit|fill|reject)
- REQ-087 거부 ERROR 가시성 (조용한 롤백 제거)
- REQ-086 청산 reason+actor 동반 노출 (안전망/전략 구분, 신규 필드 없음)
- REQ-088 운영 조회 CLI report (application/operator_report.py, 보유·오늘 체결
  ·실현 PnL net·대기, direct-DB)
- REQ-089 운영자 런북 docs/operations.md
- REQ-090 baseline 정합 (runtime-flows·project-structure·interface-contract)
- BAT-045(P0)·BAT-046(P1) release-candidate

REL-007: confirmed → feedback-captured (운영 인스턴스 라이브 검증 + #28/#29 환류
정규화). BAT-037~041 released.

검증: 537 passed, 47 skipped, 회귀 0, ruff clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-16 13:19:31 +09:00

1.9 KiB

BAT-045 Implementation

  • Status: completed
  • Batch: BAT-045

Plan Summary

  • 구조화 로깅 기반(REQ-084) + 주문 결과 로깅(REQ-085) + 거부 ERROR(REQ-087) 구현.

Changed Files

  • trex_core/runtime/logging_setup.py (신규) — _correlation_id contextvar, set_correlation_id/get_correlation_id/correlation_id cm, _CorrelationFilter, TextFormatter/JsonFormatter(KST ISO8601), configure_logging(idempotent root 핸들러).
  • trex_core/runtime/daemon.py — main()에서 logging.basicConfig → configure_logging.
  • trex_core/runtime/reset.py — 동일 교체.
  • trex_core/application/execution.py — import set_correlation_id; _dispatch에서 슬롯별 cid 설정 + event=order_submit INFO + event=order_reject ERROR; _poll 슬롯별 cid + terminal_reject ERROR; _on_filled event=order_fill(price/qty/fee/tax).
  • tests/runtime/test_logging_setup.py (신규) — text/json 포맷·KST·cid·idempotent.
  • tests/application/test_execution_policy.py — TestOrderResultLogging(submit/fill event 키 + cid=slot_id, 거부 ERROR, 정상 무ERROR).

Execution Log

  1. logging_setup.py 작성 → 단위 테스트 green.
  2. 엔트리포인트 configure_logging 교체(daemon/reset).
  3. execution 주문 결과 로깅 + correlation id + 거부 ERROR.
  4. 테스트 추가/실행, 전체 회귀.

Validation

  • pytest tests/runtime/test_logging_setup.py tests/application/test_execution_policy.py → 35 passed.
  • 전체 pytest -q → 529 passed, 47 skipped(실 DB/RabbitMQ 게이트 skip), 회귀 0.
  • ruff check(logging_setup/execution/daemon/reset/테스트) → All checks passed.

Remaining Risks

  • correlation id는 slot_id 기반(단일 키). intent_id 전체 전파는 후속(스키마 변경 필요 시).
  • Loki 실제 적재는 배포측 수집기 설정(코드는 JSON stdout). 실 환경 검증은 release 운영 위임.