시스템 리소스 지표

MINARA_SYSTEM_METRICS_DISABLED

제어 대상: gateway가 프로세스 + 시스템 리소스 사용량(CPU, 메모리, 디스크 여유 공간, sandbox 폴더 크기, 네트워크 처리량, 토큰 처리량)을 샘플링하고 /v1/system-metrics 엔드포인트를 라이브 데이터와 함께 노출할지 여부입니다. 엔드포인트는 어느 경우든 등록된 상태로 유지되며, 비활성화되면 { disabled: true }를 반환하고 웹 UI는 해당 행을 숨깁니다.
사용처: src/metrics/index.ts start().
설정 시점: 리소스가 제한된 운영자 호스트, 테스트 실행, 또는 5s 샘플링 tick + sandbox 디렉터리 순회가 실행되면 안 되는 모든 환경을 위한 것입니다.
기본값: 비어 있음(collector 활성화).
형식: 1이면 비활성화합니다. 그 외 값(미설정 포함)은 collector를 활성화 상태로 둡니다.
MINARA_SYSTEM_METRICS_DISABLED=1
설정 위치: 사용자 대상 설정 아님

SYSTEM_METRICS_TOKEN_SESSION_WINDOW

제어 대상: "Tokens/sec" 대표 수치에 반영되는 가장 최근 활성 채팅 세션의 개수입니다. collector는 세션별로 입력/출력 토큰 + 벽시계 시간의 집계를 유지하며, 스냅샷마다 가장 최근에 활성화된 상위 N개 세션을 함께 평균 내므로 유휴 상태 에이전트의 수치가 오래된 유휴 세션으로 희석된 평생 평균이 아니라 현재 성능을 반영합니다.
사용처: src/metrics/token-collector.ts snapshot().
설정 시점: 더 즉각적인 "지금" 수치를 원하면 낮추고(예: 3), 단일 세션 이상치에 덜 민감한 더 부드러운 수치를 원하면 높이세요(예: 10).
기본값: 5.
형식: 양의 정수.
SYSTEM_METRICS_TOKEN_SESSION_WINDOW=5
설정 위치: 사용자 대상 설정 아님