toki/iop
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
iop/agent-roadmap/phase/operational-observability-provider-management/milestones/usage-token-log-ops-mvp.md
toki 274ed27375 feat: roadmap update - add new phases and milestones 
- Add operational-observability-provider-management phase with milestones
- Add new milestones for automation-runtime-bridge (CLI agent usage notification, OTO automation scheduler, remote workspace operations)
- Add new milestones for knowledge-tool-optimization-extension (advisor context hook second wave, long-term memory RAG second wave)
- Update existing milestones and phase documents
- Add IOP_ROADMAP_STATUS.md for tracking
2026-06-15 21:59:40 +09:00

3.3 KiB
Raw Blame History

Milestone: 사용량, 토큰, 로그 운영 추적 MVP

위치

  • Roadmap: agent-roadmap/ROADMAP.md
  • Phase: agent-roadmap/phase/operational-observability-provider-management/PHASE.md

목표

사용자 관리, token 관리, API/CLI/local inference 사용량 집계, 로그 관리를 1차 MVP 운영 축으로 스케치한다. 이미 존재하는 runtime usage, CLI usage status, audit/observability 패키지와 Control Plane/Client 운영 표면을 기준으로 삼되, 구체 schema와 저장소 구현은 후속 구체화 전까지 확정하지 않는다.

상태

[스케치]

승격 조건

  • 1차 MVP에서 관리할 사용자/token 범위와 운영 주체를 결정한다.
  • API, CLI, local inference 사용량을 어떤 단위로 집계할지 결정한다.
  • 로그 관리의 최소 범위와 보관/조회 책임 경계를 결정한다.
  • Control Plane, Edge-local CLI, Client 중 어떤 표면을 MVP에 포함할지 결정한다.

구현 잠금

  • 상태: 잠금
  • 결정 필요: 아래 체크리스트
    • 사용자와 token을 개인/Edge/조직 중 어떤 단위로 시작할지 결정한다.
    • 사용량 집계의 MVP 단위를 요청, token, runtime duration, CLI limit status 중 어디까지로 둘지 결정한다.
    • 로그 조회와 export의 MVP 표면을 Control Plane/Client/CLI 중 어디에 둘지 결정한다.

범위

  • 사용자 관리와 token 관리의 1차 운영 경계
  • API, CLI, local inference 사용량 집계의 MVP 산출물 정의
  • Edge/Node/Control Plane 로그 관리의 최소 조회 경계
  • 기존 Usage, CLI usage status, audit/observability 패키지와 연결 가능한 표준선 정리

기능

Epic: [ops-usage] Usage and Log Operations

운영자가 사용량과 로그를 한 곳에서 이해하기 위한 최소 capability를 묶는다.

  • [identity-scope] 사용자와 token 관리의 MVP 책임 경계가 정리되어 있다.
  • [usage-rollup] API, CLI, local inference 사용량 집계 후보와 제외 범위가 정리되어 있다.
  • [log-surface] Edge/Node/Control Plane 로그 조회와 export의 최소 표면 후보가 정리되어 있다.
  • [ops-review] 사용자가 MVP 운영 범위와 후속 구체화 우선순위를 검토했다.

완료 리뷰

  • 상태: 없음
  • 요청일: 없음
  • 완료 근거: 스케치 Milestone이며 기능 Task가 아직 충족되지 않았다.
  • 리뷰 필요:
    • 사용자가 완료 결과를 확인했다
    • archive 이동을 승인했다
  • 리뷰 코멘트: 없음

범위 제외

  • 결제, chargeback, 조직 IAM, 장기 retention 정책의 상세 구현
  • 모든 로그 schema와 audit schema 확정
  • provider routing 또는 inference adapter 구현

작업 컨텍스트

  • 관련 경로: apps/control-plane, apps/client, apps/edge, apps/node, packages/go/audit, packages/go/observability, proto/iop/runtime.proto
  • 표준선(선택): Edge는 로컬 runtime 상태의 원본을 유지하고, Control Plane은 연결 view와 운영 기록을 보기 쉽게 제공한다.
  • 선행 작업: Control Plane과 Client 운영, OpenAI-compatible usage 응답, CLI usage checker
  • 후속 작업: 운영 리포트, audit retention, 품질 기반 routing/fallback 고도화
  • 확인 필요: 사용자/token 단위, 사용량 집계 단위, 로그 관리 표면