본문으로 건너뛰기

FlowKat 사용자 매뉴얼 인덱스

개요​

FlowKat은 실시간 성능 메트릭, 트랜잭션 분석, 가용성 모니터링을 통합하여 제공하는 모니터링 대시보드 시스템입니다.

1장: FlowKat 소개​

1.1 FlowKat이란​

  • 정의: FlowKat 시스템의 모니터링 데이터를 웹 기반으로 시각화하는 APM(애플리케이션 성능 관리) 솔루션
  • 주요 기능: 실시간 모니터링, 트랜잭션 분석, 가용성 추적, 통계 분석
  • 아키텍처: Next.js 14 기반, WebWorker 폴링 + STOMP WebSocket + Socket.IO 실시간 데이터 처리

1.2 핵심 개념​

  • 오브젝트(Object): 모니터링의 최소 단위 (SObject 클래스로 표현)
  • 수집 서버(Collector Server): 에이전트로부터 메트릭 데이터를 수집하는 중앙 서버
  • 에이전트(Agent): 모니터링 대상 시스템에 설치되는 데이터 수집 에이전트
  • 서버(Server): FlowKat 인프라 구성 요소 (API, 대시보드, 메트릭 서버)
  • 트랜잭션(Transaction): API 호출 단위의 실행 경로
  • 메트릭(Metrics): 시스템 상태를 나타내는 정량적 지표
  • 사용자(User) & 권한(Role): 접근 제어 및 기능 접근 권한

1.3 기술 스택​

  • 프론트엔드: Next.js 14, TypeScript, MUI v7, Zustand
  • 백엔드: Spring Boot, H2 데이터베이스
  • 실시간 통신: WebSocket, SSE (Server-Sent Events)
  • 데이터 시각화: ECharts, React Flow

1.4 시나리오별 빠른 가이드​

APM 운영 시 자주 사용하는 핵심 시나리오별 페이지 동선 가이드입니다. 상세 내용은 시나리오별 빠른 가이드를 참고하십시오.

시나리오핵심 동선빈도관련 페이지
일상 모니터링대시보드 → 센트리 → 추적 이슈 → 트랜잭션 통계매일02, 06, 07, 09, 08
장애 대응알람 → 대시보드 → 추적 이슈 → 진단 패널 → 드릴다운수시02, 09, 09a, 05
느린 트랜잭션 추적트랜잭션 통계 → XLOG 검색 팝업 → 프로파일 분석주간08, 05, 04
트래픽 이상 탐지트랜잭션 익스플로러 → 브러시 → 트래픽 분석 → 드릴다운수시08a, 08b, 05

2장: FlowKat 사용 방법​

2.1 기본 접속​

  • URL: http://[도메인]/workgroup/[workgroupId]
  • 인증: NextAuth 기반 로그인
  • 초기 화면: 통합 대시보드로 자동 리다이렉션

2.2 핵심 기능 사용법​

2.2.1 모니터링​

  • 실시간 성능 모니터링
  • 시스템 상태 확인
  • 운영 현황 파악
  • 관리자 기능 접근

2.2.2 가용성 모니터링​

  • 센트리: 센트리 및 가용성 현황
  • 파노라마: 전체 시스템 상태 한눈에 보기

2.2.3 트랜잭션 통계​

  • URL별 통계
  • SQL 성능 분석
  • HTTP 호출 패턴
  • 사용자 에이전트 분석
  • 에러 통계
  • 클라이언트 IP 분석
  • 방문자 수 통계

2.2.4 분석 기능​

  • XLOG(트랜잭션 로그): 트랜잭션 로그 조회
  • 성능 조회: 응답 시간 및 처리량 분석
  • 트랜잭션 조회: 세부 트랜잭션 정보

2.2.5 사용자 정의​

  • 내 대시보드 개인 설정
  • 차트 커스터마이징
  • 알림 설정 관리

2.3 설정 관리​

2.3.1 수집 서버 관리​

  • 수집 서버 편집
  • 알람 관리

2.3.2 오브젝트 관리​

  • 관리 오브젝트 목록
  • 오브젝트 속성 설정

2.3.3 센트리 관리​

  • 모니터링 설정
  • 상태 관리

2.3.4 사용자 관리​

  • 사용자 등록 관리
  • 비밀번호 정책 설정
  • 역할 관리

2.3.5 라이선스 관리​

  • 라이선스 정보 조회
  • 사용량 모니터링

3장: 메뉴별 화면 설명​

3.1 대시보드 메뉴​

3.1.1 대시보드 (/monitoring)​

통합 대시보드 (/monitoring/main)​
  • 기능: 모든 모니터링 데이터의 통합된 시각화
  • 주요 화면:
    • 실시간 트랜잭션 그래프
    • 시스템 상태 요약
    • 알림 현황
  • 특징: 메인 대시보드로 초기 진입 시 표시
시스템 대시보드 (/monitoring/system)​
  • 기능: 시스템 전반의 상태 모니터링
  • 주요 화면:
    • CPU/메모리 사용률
    • JVM 상태
    • 스레드 상태
  • 대상: 시스템 관리자
관리자 대시보드 (/monitoring/admin)​
  • 기능: 관리자 전용 고급 기능
  • 주요 화면:
    • 사용자 활동 로그
    • 시스템 설정
    • 백업 관리
  • 대상: 시스템 관리자
운영 대시보드 (/monitoring/operation)​
  • 기능: 운영팀을 위한 모니터링
  • 주요 화면:
    • 서비스 가용성
    • 성능 지표
    • 이슈 추적
  • 대상: 운영팀

3.1.2 조회 (/analysis)​

XLOG (/monitoring/xlog)​
  • 기능: 트랜잭션 로그 상세 조회
  • 주요 화면:
    • 로그 목록
    • 상세 분석
    • 필터링 및 검색
  • 특징: 실시간 로그 스트리밍
성능 조회 (/analysis/performance)​
  • 기능: 애플리케이션 성능 분석
  • 주요 화면:
    • 응답 시간 분포
    • 처리량 통계
    • 성능 병목 현상
  • 특징: 성능 개선 지원
트랜잭션 조회 (/analysis/transaction)​
  • 기능: 개별 트랜잭션 상세 정보
  • 주요 화면:
    • 트랜잭션 타임라인
    • 호출 체인
    • 오류 분석
  • 특징: 디버깅에 활용

3.1.3 워치타워 (/availability)​

센트리 (/availability/uptime)​
  • 기능: 센트리 및 가용성 모니터링
  • 주요 화면:
    • Uptime 그래프
    • 장애 이력
    • 상세 보고서
  • 특징: SLA(서비스 수준 협약) 모니터링
파노라마 (/availability/panorama)​
  • 기능: 전체 시스템의 상태를 한눈에
  • 주요 화면:
    • 시스템 토폴로지 맵
    • 서비스 상태 색상 표시
    • 상세 정보 팝업
  • 특징: 운영 전체 파악

3.1.4 트랜잭션 통계 (/tx-stats)​

  • 기능: 다양한 기준의 통계 분석
  • 세부 메뉴:
    • URL 통계: API별 호출 현황
    • SQL 통계: 쿼리 성능 분석
    • HTTP 호출 통계: 외부 API 호출 현황
    • 사용자 에이전트 통계: 브라우저/OS별 분석
    • 에러 통계: 오류 발생 패턴
    • 클라이언트 IP 통계: 지역별 접속 현황
    • 방문자 수 통계: 트래픽 패턴 분석

3.1.5 트랜잭션 익스플로러 (/tx-mining)​

  • 기능: 트랜잭션 데이터 심층 분석 및 패턴 발견
  • 접근 경로: /tx-mining/log
  • 주요 탭:
    • 디스커버리 탭: 트랜잭션 로그 분석
      • 시간 기반 히스토그램
      • 필드별 통계
      • 상세 문서 조회
      • 브러시(brush) 기반 시간 범위 재검색
    • 트래픽 분석 탭: 트래픽 패턴 분석
      • TopN 집계 분석
      • 이상 탐지 (Anomaly Detection)
      • IP 플러드 감지
      • 사용자 에이전트 분포

3.1.6 모니터링 추적 (/tracking)​

  • 기능: 모니터링 장애 추적 및 이슈 관리
  • 접근 경로: /tracking
  • 주요 기능:
    • 이슈 목록: 필터링 및 정렬
    • 이슈 상세: 상세 정보 조회
    • 이슈 수정: 제목, 내용, 우선순위, 상태 변경
    • 댓글 시스템: 이슈별 댓글 및 대댓글
    • 라벨 관리: 이슈 분류용 라벨
    • 관련 이슈: 이슈 간 연결 관계
    • 첨부파일: 파일 업로드 및 관리
    • 자동 이슈 생성: 성능 알람 기반 자동 이슈 생성
    • 자동 규칙 설정: 자동 이슈 생성 조건 관리
    • 진단 보고서: 시스템 진단 정보 수집 및 표시

3.1.7 사용자 정의 (/customized)​

  • 기능: 개인화된 대시보드
  • 주요 기능:
    • 내 대시보드 생성
    • 위젯 배치
    • 개인 설정 저장

3.2 설정 메뉴​

3.2.1 내 계정 (/setting/profile/me)​

  • 기능: 개인 정보 관리
  • 주요 화면:
    • 프로필 수정
    • 비밀번호 변경
    • 알림 설정

3.2.2 수집 서버 관리 (/setting/collectors)​

  • 기능: 데이터 수집 서버 관리
  • 세부 메뉴:
    • 수집 서버 편집: 서버 등록 및 편집
    • 알람 관리: 알람 규칙 및 알람 연동 통합 관리

3.2.3 오브젝트 관리 (/setting/objects)​

  • 기능: 모니터링 오브젝트 관리
  • 세부 메뉴:
    • 오브젝트 목록: 등록된 오브젝트
    • 오브젝트 설정: 속성 및 모니터링 설정

3.2.4 센트리 관리 (/setting/uptime)​

  • 기능: 센트리 모니터링 설정
  • 세부 메뉴:
    • 센트리 설정: 모니터링 조건
    • 센트리 상태: 실시간 상태

3.2.5 트랜잭션 익스플로러 관리 (/setting/tx-mining)​

  • 기능: 트랜잭션 익스플로러 데이터베이스 관리
  • 접근 경로: /setting/tx-mining/{schema,partition,cache}
  • 세부 메뉴:
    • 스키마 (schema): 테이블 구조 확인 및 관리
    • 파티션 (partition): 날짜별 파티션 관리
    • 캐시 (cache): 차원 캐시 관리
    • 스냅샷 (~~snapshot~~): 데이터 스냅샷 관리 (deprecated: 메뉴 제거됨)
트랜잭션 익스플로러 관리 예외

트랜잭션 익스플로러 관리 메뉴는 관리자 역할의 설정 메뉴 잠금 규칙 예외로 자유롭게 수정할 수 있습니다.

3.2.6 사용자 관리 (/setting/users)​

  • 기능: 사용자 계정 및 권한 관리
  • 세부 메뉴:
    • 사용자 등록 관리: 사용자 등록 및 정보 관리
    • 비밀번호 정책: 복잡성(최소 길이, 대소문자, 숫자, 특수문자, 연속문자 제한) 및 갱신 주기 설정, 로그인 규칙(세션 관리, 계정 잠금) 포함
    • 역할 관리: 접근 권한 할당, 시스템 역할(Admin, Guest) 삭제 보호
    • 가이드 팝업창: 역할 관리, 로그인 규칙 가이드 지원

3.2.7 라이선스 관리 (/setting/license)​

  • 기능: 라이선스 정보 관리
  • 주요 화면:
    • 라이선스 목록: 사용중인 라이선스
    • 만료일 모니터링

3.2.8 정보 (/setting/info)​

  • 기능: 시스템 정보 조회
  • 세부 메뉴:
    • 버전 정보: FlowKat 버전 정보
    • 오픈 소스 라이선스: 라이선스 내역

4장: 데이터 수집 및 이해​

4.1 수집 데이터 종류​

4.1.1 트랜잭션 데이터​

  • X-View 데이터: 트랜잭션 실행 경로
  • 프로파일 데이터: 성능 프로파일링 정보
  • 호출 체인: API 호출 연결 관계

4.1.2 메트릭 (Metrics)​

  • 정의: 시스템 상태를 나타내는 정량적 지표
  • 수집 단위: 초, 분, 시간별
  • 상세 설명:
    • JVM(Java 가상 머신) 메트릭: 힙 메모리(Heap), 가비지 컬렉션(GC), 스레드(Thread)
    • 애플리케이션 메트릭: 요청 수, 응답 시간
    • 네트워크 메트릭: TCP(전송 제어 프로토콜) 연결 수

4.1.3 에러 (ERROR)​

  • 유형: Runtime Error, Exception, Error Code
  • 설명: 에러 발생 원인 및 스택 트레이스

4.1.4 이벤트 (EVENT)​

  • 정의: 시스템 내 발생하는 주요 사건
  • 종류: 이벤트 로그, 알림, 경고

4.2 데이터 구조​

4.2.1 트랜잭션 데이터 모델​

  • 트랜잭션 ID: 고유 식별자
  • 시작 시간: 트랜잭션 시작 타임스탬프
  • 종료 시간: 트랜잭션 종료 타임스탬프
  • 응답 시간: 총 처리 시간
  • 호출 경로: 메소드 호출 체인
  • 매개변수: 입력/출력 데이터

4.2.2 메트릭 데이터 모델​

  • 메트릭 ID: 고유 식별자
  • 타임스탬프: 수집 시간
  • 값: 메트릭 값
  • 단위: 측정 단위(ms, count, % 등)
  • 태그: 메트릭 구분 정보

4.3 실시간 데이터 처리​

FlowKat은 기능별로 최적화된 실시간 데이터 수신 방식을 사용합니다:

4.3.1 WebWorker 기반 스케줄링 폴링​

  • 용도: 대시보드 성능 카운터, XLOG 실시간, 트랜잭션 분석
  • 특징: Web Worker가 백그라운드에서 2초 간격 HTTP API 폴링 스케줄링
  • 탭 비활성화: 자동 중단, 활성화 시 복구

4.3.2 STOMP WebSocket (SockJS)​

  • 용도: 역할/권한 변경 실시간 동기화, 모니터링 추적 자동 이슈 알림
  • 특징: 단일 STOMP 연결을 다수 도메인이 공유, JWT 인증, 5초 하트비트
  • 프로토콜: STOMP over SockJS, JSON 메시지

4.3.3 Socket.IO​

  • 용도: 센트리(Uptime) 실시간 상태 모니터링
  • 특징: UptimeKat 전용, 탭 비활성화 시 자동 disconnect/재연결, 3초 재시도
  • 프로토콜: Socket.IO (WebSocket + HTTP long-polling 폴백)

4.3.4 SSE (Server-Sent Events)​

  • 용도: 센트리 서버 → 클라이언트 단방향 이벤트 스트리밍
  • 특징: 자동 재연결, 이벤트 기반

부록: 고급 기능 및 미래 계획​

부록 A: 메트릭 데이터 수집 및 저장 구조 (일반 사용자용)​

  • 상세 문서: appendix-a-metrics-collection.md
  • 내용:
    • 데이터 수집의 3계층 구조 (에이전트 → 전송 → 저장)
    • 에이전트 수집 메커니즘 (@Counter 애노테이션, CounterExecutingManager 1초 스케줄링)
    • 데이터 수집의 신뢰성 (왜 1초마다 수집할까요?)
    • 트랜잭션 수집 (ASM 바이트코드 인스트루멘테이션, HttpTrace/TraceSQL0 시작점)
    • V3 TCP 전송 과정, Collector Server 파이프라인 (ProtocolDetectionHandler → NetDataProcessor → PerfCountCore)
    • 파일 DB 저장 구조 (RealtimeCounterDB, DailyCounterDB, CounterCache)
    • 수집 메트릭 요약 (Host Agent, Java Agent, Interaction)
    • 주요 개념 설명 (TPS, 응답 시간, Heap, GC)
    • 실무자를 위한 분석 가이드
    • TimeTypeEnum별 저장 전략 (REALTIME, ONE_MIN, FIVE_MIN, TEN_MIN, HOUR, DAY)
    • 성능 지표 기술용어 사전 (Percentile, STW, Heap 영역 등)

부록 B: 메트릭 상세 분석 (심화 학습)​

  • 상세 문서: appendix-b-metrics-deep-dive.md
  • 대상: APM 엔지니어, DevOps 엔지니어, 시스템 성능 튜닝 담당자
  • 내용:
    • Host Agent 메트릭 상세 (CPU, 메모리, 스왑, 네트워크, 디스크 I/O)
      • 모든 메트릭의 정의, 데이터 원본, 계산 방법
      • /proc/stat, /proc/meminfo, /proc/net/snmp, /proc/diskstats 분석
      • 엔지니어 해석 가이드 (진단 기준, 확인 방법, 해결 방법)
    • Java Agent 메트릭 상세 (Service, Heap, GC, Process)
      • MeterService 내부 구조, TPS/응답 시간 계산
      • P90 응답 시간 상세 설명 (왜 평균 대신 P90인가? 계산 방법, 해석 가이드)
      • JMX MBean 기반 데이터 수집 (HeapMemoryUsage, GarbageCollector)
      • GC 튜닝 가이드라인, 메모리 누수 진단
    • Interaction 메트릭 상세 (API, DB, Redis, Kafka 등)
      • 서비스간 호출 추적 원리
      • 상관 분석 활용, 네트워크 계층 구조 추론
    • 메트릭별 연관 분석 가이드
      • 성능 문제 진단 트리
      • 메트릭 연관 매트릭스 (CPU 병목, 메모리 부족, GC 과도 등)

부록 C: 수학적 기초 (심화 학습)​

  • 상세 문서: appendix-c-mathematical-foundations.md
  • 대상: 수학적 배경지식이 있는 엔지니어, 데이터 과학자
  • 내용:
    • 표본화 이론 (Sampling Theory)
      • Nyquist-Shannon 표본화 정리
      • 시스템 메트릭의 주파수 특성 분석
      • 표본화 오차 분석 및 완화 전략 (최대-최소 유지, 이동 평균, 보간)
    • 단조 증가 카운터의 유효성
      • 단조 증가 함수 정의, 델타 계산의 순서 독립성 증명
      • 비동기 전송 환경에서의 정확성 보장
    • CounterBasket 집계의 결합성
      • 결합 법칙 정의 및 증명
      • @Counter 메서드 병렬 실행 시 정합성 보장
    • 시간 윈도우의 무결성
      • TimeCounterKey 구조, 데이터 무결성 보장 (시간 역전 불가, 갱신 손실 방지, 시계열 일관성)
    • 포아송 과정과 TPS 모델링
      • 포아송 과정 정의, TPS의 통계적 특성
      • 신뢰 구간 계산 (95% CI)
    • 대기행렬 이론 (Queueing Theory)
      • M/M/1 대기행렬 모델, 리틀의 법칙
      • FlowKat 메트릭과의 매핑, 병목 현상 분석
    • 측도론 (Measure Theory) 기초
      • 확률 공간, 시그마 대수, 확률 측도 정의
      • 메트릭 수집의 확률 모델
    • 정보 이론 (Information Theory) 기초
      • 엔트로피, 상호 정보량, 데이터 압축 이론
      • FlowKat 데이터 압축 적용
    • 통계적 품질 관리
      • 관리도 (Control Chart), 공정 능력 (Process Capability)
      • 메트릭 모니터링 적용, 목표 설정

부록 G: 개발 중인 기능​

B.1 트랜잭션 익스플로러 (부분 구현됨)​

  • 로그 분석 (/tx-mining/log): ✅ 구현 완료
    • 디스커버리 탭: 히스토그램, 문서 조회, 필드별 통계
    • 트래픽 분석 탭: TopN 분석, 이상 탐지
  • 통계 (/tx-mining/stats): 🚧 개발 중
  • 배치 (/tx-mining/batch): 🚧 개발 중
  • 스토리지 관리 (/tx-mining/storage): 🚧 개발 중

B.2 모니터링 추적 (구현됨)​

  • 이슈 추적 (/tracking): ✅ 구현 완료
    • 이슈 목록, 상세, 수정
    • 댓글 시스템, 라벨 관리
    • 관련 이슈 연결, 첨부파일

B.3 고급 분석 기능 - 지원 않음​

  • 성능 브라우저: 상세 성능 분석 도구
  • Metrics 회귀분석: 성능 변화 추적
  • 이상 탐지: 자동 이상 감지 시스템

B.4 모니터링 강화 - 지원 않음​

  • 다이나믹 메소드 프로파일: 동적 메소드 분석
  • 사용자 ID 모니터링: 사용자별 성능 추적
  • 부하량 제어 (PLC): 트래픽 제어 시스템

B.5 통합 기능 - 지원 않음​

  • K8s 모니터링: 쿠버네티스 환경 모니터링
  • Batch Job 모니터링: 배치 작업 관리
  • Frontend 모니터링: 프론트엔드 성능 모니터링

부록 H: 설치 및 배포​

C.1 시스템 요구사항​

  • 하드웨어: CPU 8코어 이상, RAM 16GB 이상
  • 소프트웨어: JDK 17+, Node.js 18+
  • 네트워크: 지속적인 인터넷 연결 (10Mbps 이상 권장)

C.2 설치 절차​

  1. 사전 준비: 의존성 설치
  2. 설치 실행: 설치 스크립트 실행
  3. 환경 설정: 설정 파일 수정
  4. 서비스 시작: 서비스 시작 및 확인

C.3 배포 가이드​

  • 배포 절차: 버전 업그레이드 방법
  • 백업 및 복구: 데이터 백업 방법
  • 모니터링: 배포 후 확인 사항

부록 D: 문제 해결​

D.1 자주 발생하는 문제​

  • 접속 문제: 인증 오류, 권한 문제
  • 성능 문제: 응답 지연, 데이터 정합성
  • 모니터링 문제: 데이터 수집 오류

D.2 오류 코드​

  • 4001: 계정 강제 잠금
  • 4002: 세션 초과
  • -1: 일반 실패

D.3 해결 방안​

  • 로그 확인: 로그 파일 분석 방법
  • 캐시 초기화: 캐시 삭제 및 재생성
  • 서비스 재시작: 서비스 재시작 방법

부록 E: API 참조​

E.1 RESTful API​

  • 인증: Bearer Token 방식
  • 응답 형식: JSON
  • 에러 처리: HTTP 상태 코드 + resultCode

E.2 WebSocket API​

  • 연결: wss://[도메인]/ws
  • 메시지 형식: JSON
  • 이벤트 타입: message, error, close

부록 F: 모범 사례​

F.1 모니터링 설정​

  • 적절한 수집 주기: 1초 ~ 1분
  • 필터링 설정: 불필요한 데이터 필터링
  • 알림 설정: 적절한 알림 임계값

F.2 성능 최적화​

  • 인덱싱: 데이터베이스 인덱스 최적화
  • 캐싱: 자주 사용되는 데이터 캐싱
  • 비동기 처리: I/O 작업 비동기화

F.3 보안 가이드​

  • 접근 제어: 최소 권한 원칙 적용
  • 데이터 암호화: 중요 데이터 암호화
  • 정기 점검: 보안 취약점 정기 점검

문서 목차​

기반 문서​

파일명설명
00.DISCREPANCY-ANALYSIS.md인덱스와 코드베이스 간 불일치 분석
CHECKLIST.md문서 작성 현황 및 작업 체크리스트
_templates/00.guide-to-write.md문서 작성 가이드
_templates/01.page-template.md마스터 문서 템플릿
_templates/02.dashboard-template.md대시보드 페이지 템플릿
_templates/03.setting-template.md설정 페이지 템플릿

상세 문서​

대시보드 메뉴​

ID문서명파일경로상태
dashboard-main통합 대시보드02.dashboard-main.md/monitoring/[layout]✅ 완료
dashboard-system시스템 대시보드03.dashboard-system.md/monitoring/system✅ 완료
dashboard-admin관리자 대시보드03a.dashboard-admin.md/monitoring/admin✅ 완료
dashboard-operation운영 대시보드03b.dashboard-operation.md/monitoring/operation✅ 완료
analysis-performance성능 조회04.analysis-performance.md/analysis/performance✅ 완료
active-service-detail액티브 서비스 상세 조회04a.active-service-detail.md대시보드 팝업✅ 완료
analysis-transaction트랜잭션 조회05.analysis-transaction.md/analysis/transaction✅ 완료
availability-uptime센트리06.availability-uptime.md/availability/uptime✅ 완료
xlog-overviewXLOG 개요06a.xlog-overview.md/monitoring/xlog✅ 완료
xlog-profile-detailXLOG 프로파일 분석06b.xlog-profile-detail.mdXLOG 차트 팝업✅ 완료
availability-panorama파노라마07.availability-panorama.md/availability/panorama✅ 완료
tx-stats-overview트랜잭션 통계08.tx-stats-overview.md/tx-stats/[stats]✅ 완료
tx-mining-overview트랜잭션 익스플로러08a.tx-mining-overview.md/tx-mining/log✅ 완료
tx-mining-log트랜잭션 익스플로러 로그08b.tx-mining-log.md/tx-mining/log✅ 완료
tracking-overview모니터링 추적09.tracking-overview.md/tracking✅ 완료
tracking-issue이슈 추적09a.tracking-issue.md/tracking✅ 완료
customized-overview사용자정의09b.customized-overview.md/customized✅ 완료

설정 메뉴​

ID문서명파일경로상태
setting-collectors수집 서버 관리10.setting-collectors.md/setting/collectors/[mgmt]✅ 완료
setting-objects오브젝트 관리10a.setting-objects.md/setting/objects/[mgmt]✅ 완료
setting-users사용자 관리10b.setting-users.md/setting/users/[mgmt]✅ 완료
setting-profile내 계정11.setting-profile.md/setting/profile/[userId]✅ 완료
setting-uptime센트리 관리12.setting-uptime.md/setting/uptime/[...slug]✅ 완료
setting-license라이선스 관리13.setting-license.md/setting/license/[mgnt]✅ 완료
setting-info-license라이선스 정보14.setting-info-license.md/setting/info/license✅ 완료
setting-info-version버전 정보15.setting-info-version.md/setting/info/version✅ 완료
setting-tx-mining-schema트랜잭션 익스플로러 스키마16a.setting-tx-mining-schema.md/setting/tx-mining/schema✅ 완료
setting-tx-mining-partition트랜잭션 익스플로러 파티션16b.setting-tx-mining-partition.md/setting/tx-mining/partition✅ 완료
setting-tx-mining-cache트랜잭션 익스플로러 캐시16c.setting-tx-mining-cache.md/setting/tx-mining/cache✅ 완료
setting-tx-mining-snapshot트랜잭션 익스플로러 스냅샷16d.setting-tx-mining-snapshot.md/setting/tx-mining/snapshot⚠️ deprecated

부록 문서​

파일명설명상태
appendix-a-metrics-collection.md메트릭 데이터 수집 및 저장 구조 (일반 사용자용)✅ 완료
appendix-b-metrics-deep-dive.md메트릭 상세 분석 (심화 학습)✅ 완료
appendix-c-mathematical-foundations.md수학적 기초 (심화 학습)✅ 완료
appendix-chart-patterns.md차트 패턴 해석 가이드 (XLOG 산점도, 시계열, 히스토그램)✅ 완료
appendix-widget-reference.md차트 위젯 참조 가이드 (위젯별 읽는 법, 색상, 인터랙션)✅ 완료
appendix-glossary.md용어집 (핵심 개념 A-Z)미작성
appendix-faq.mdFAQ (자주 묻는 질문)미작성