FlowKat 사용자 가이드에서 사용되는 핵심 개념과 기술 용어를 카테고리별로 정리하였습니다. 처음 FlowKat을 사용하시는 분께서는 이 문서를 먼저 읽으시면 각 기능을 더 빠르게 이해하실 수 있습니다.
1. 핵심 개념
FlowKat의 기본 구조를 이해하는 데 필요한 핵심 용어입니다.
오브젝트 (Object)
| 항목 | 내용 |
|---|
| 한글명 | 오브젝트 |
| 영문명 | Object |
| 정의 | FlowKat 모니터링의 최소 단위입니다. 에이전트가 설치된 애플리케이션 인스턴스 하나를 의미하며, 내부적으로 SObject 클래스로 표현됩니다. |
| 관련 화면 | 통합 대시보드, 오브젝트 관리 (/setting/objects) |
| 참고 | 오브젝트 관리 |
수집 서버 (Collector Server)
| 항목 | 내용 |
|---|
| 한글명 | 수집 서버 |
| 영문명 | Collector Server |
| 정의 | 에이전트로부터 성능 메트릭과 트랜잭션 데이터를 수집하는 중앙 서버입니다. 에이전트와의 TCP 통신을 처리하며, 수집된 데이터를 파일 DB에 저장합니다. |
| 관련 화면 | 수집 서버 관리 (/setting/collectors) |
| 참고 | 수집 서버 관리 |
에이전트 (Agent)
| 항목 | 내용 |
|---|
| 한글명 | 에이전트 |
| 영문명 | Agent |
| 정의 | 모니터링 대상 시스템(애플리케이션 서버, 호스트)에 설치되어 성능 데이터를 수집하고 수집 서버로 전송하는 소프트웨어 모듈입니다. Java 에이전트, Host 에이전트 등 유형에 따라 수집하는 메트릭이 다릅니다. |
| 관련 화면 | 통합 대시보드, 오브젝트 관리 |
| 참고 | 메트릭 데이터 수집 구조 |
트랜잭션 (Transaction)
| 항목 | 내용 |
|---|
| 한글명 | 트랜잭션 |
| 영문명 | Transaction |
| 정의 | HTTP 요청 하나가 서버에서 처리되는 전체 실행 경로를 의미합니다. 시작부터 종료까지의 응답시간, 호출된 SQL, 외부 API 호출 등 모든 단계를 포함합니다. |
| 관련 화면 | 트랜잭션 조회 (/analysis/transaction), XLOG (/monitoring/xlog) |
| 참고 | 트랜잭션 조회 |
메트릭 (Metrics)
| 항목 | 내용 |
|---|
| 한글명 | 메트릭 |
| 영문명 | Metrics |
| 정의 | 시스템의 상태를 나타내는 정량적 지표입니다. TPS, 응답시간, Heap 사용량, GC 횟수 등이 포함되며, 초·분·시간 단위로 수집됩니다. |
| 관련 화면 | 통합 대시보드, 성능 조회 (/analysis/performance) |
| 참고 | 메트릭 데이터 수집 구조 |
2. 데이터 유형
FlowKat이 수집하고 표시하는 데이터의 종류입니다.
TPS (Transactions Per Second)
| 항목 | 내용 |
|---|
| 한글명 | 초당 트랜잭션 수 |
| 영문명 | TPS (Transactions Per Second) |
| 정의 | 1초 동안 처리된 트랜잭션의 수입니다. 서비스의 처리량(Throughput)을 나타내는 핵심 지표로, TPS가 급격히 감소하면 서비스 장애의 신호일 수 있습니다. |
| 관련 화면 | 통합 대시보드, 성능 조회 |
| 참고 | 메트릭 상세 분석 |
응답시간 (Response Time)
| 항목 | 내용 |
|---|
| 한글명 | 응답시간 |
| 영문명 | Response Time |
| 정의 | HTTP 요청이 서버에 도달한 시점부터 응답이 완료될 때까지 걸리는 시간(밀리초 단위)입니다. P90 응답시간은 전체 요청의 90%가 이 값 이내에 처리된다는 의미로, 단순 평균보다 실제 사용자 경험을 더 잘 반영합니다. |
| 관련 화면 | XLOG, 트랜잭션 통계, 성능 조회 |
| 참고 | 메트릭 상세 분석 |
P90 응답시간
| 항목 | 내용 |
|---|
| 한글명 | P90 응답시간 |
| 영문명 | P90 Response Time (90th Percentile) |
| 정의 | 전체 트랜잭션 응답시간을 작은 순서로 나열했을 때 90번째 백분위수에 해당하는 값입니다. 극단적으로 느린 요청의 영향을 최소화하면서 대다수 사용자의 체감 성능을 측정하는 데 사용합니다. |
| 관련 화면 | 성능 조회, 트랜잭션 통계 |
| 참고 | 메트릭 상세 분석 |
XLOG
| 항목 | 내용 |
|---|
| 한글명 | XLOG (트랜잭션 로그) |
| 영문명 | X-Log |
| 정의 | 개별 트랜잭션의 실행 기록입니다. 종료 시각과 응답시간을 기준으로 산점도 형태로 시각화되며, 각 점을 클릭하면 해당 트랜잭션의 프로파일 상세 정보를 확인할 수 있습니다. |
| 관련 화면 | XLOG 개요 (/monitoring/xlog), XLOG 프로파일 분석 팝업 |
| 참고 | XLOG 개요 |
프로파일 (Profile)
| 항목 | 내용 |
|---|
| 한글명 | 프로파일 |
| 영문명 | Profile |
| 정의 | 트랜잭션 내에서 실행된 각 단계(메서드 호출, SQL 실행, 외부 API 호출 등)의 상세 수행 시간 기록입니다. 어느 단계에서 시간이 지연되는지 파악하는 데 사용합니다. |
| 관련 화면 | XLOG 프로파일 분석 팝업 |
| 참고 | XLOG 프로파일 분석 |
Heap (힙 메모리)
| 항목 | 내용 |
|---|
| 한글명 | 힙 메모리 |
| 영문명 | Heap Memory |
| 정의 | Java 가상 머신(JVM)이 객체를 저장하는 메모리 영역입니다. 힙 사용량이 최대치에 가까워지면 가비지 컬렉션(GC)이 빈번하게 발생하여 애플리케이션 응답이 느려질 수 있습니다. |
| 관련 화면 | 시스템 대시보드, 성능 조회 |
| 참고 | 메트릭 상세 분석 |
GC (가비지 컬렉션)
| 항목 | 내용 |
|---|
| 한글명 | 가비지 컬렉션 |
| 영문명 | GC (Garbage Collection) |
| 정의 | JVM이 더 이상 사용되지 않는 메모리 객체를 자동으로 회수하는 과정입니다. GC 실행 중에는 애플리케이션이 일시 정지(STW: Stop-The-World)될 수 있어, GC 빈도와 소요 시간은 성능 지표로 중요하게 모니터링합니다. |
| 관련 화면 | 시스템 대시보드, 성능 조회 |
| 참고 | 메트릭 상세 분석 |
Thread (스레드)
| 항목 | 내용 |
|---|
| 한글명 | 스레드 |
| 영문명 | Thread |
| 정의 | 애플리케이션 서버가 HTTP 요청을 처리하는 실행 단위입니다. 활성 스레드 수가 최대치에 도달하면 신규 요청이 대기 상태가 되어 응답시간이 급증합니다. |
| 관련 화면 | 시스템 대시보드, 성능 조회 |
| 참고 | 메트릭 상세 분석 |
비동기 트랜잭션 (Async Transaction)
| 항목 | 내용 |
|---|
| 한글명 | 비동기 트랜잭션 |
| 영문명 | Async Transaction |
| 정의 | HTTP 요청 스레드와 별도의 스레드에서 비동기로 처리되는 트랜잭션입니다. 원본 트랜잭션과 연결된 호출 체인으로 추적하며, XLOG 프로파일에서 비동기 구간을 구분하여 확인할 수 있습니다. |
| 관련 화면 | XLOG 프로파일 분석 팝업 |
| 참고 | XLOG 프로파일 분석 |
External Call (외부 호출)
| 항목 | 내용 |
|---|
| 한글명 | 외부 호출 |
| 영문명 | External Call |
| 정의 | 트랜잭션 처리 중 외부 시스템(타 서비스의 HTTP API, 메시지 큐 등)을 호출하는 구간입니다. 외부 호출 지연이 트랜잭션 전체 응답시간을 늘리는 원인이 되는 경우가 많습니다. |
| 관련 화면 | 트랜잭션 통계 HTTP 호출, XLOG 프로파일 분석 팝업 |
| 참고 | 트랜잭션 통계 |
호출 체인 (Call Chain)
| 항목 | 내용 |
|---|
| 한글명 | 호출 체인 |
| 영문명 | Call Chain |
| 정의 | 트랜잭션이 여러 서비스나 컴포넌트를 연쇄적으로 호출하는 경로입니다. FlowKat은 분산 환경에서 최초 요청부터 최종 처리까지 이어지는 전체 호출 경로를 추적합니다. |
| 관련 화면 | 트랜잭션 조회 (/analysis/transaction), XLOG 프로파일 분석 팝업 |
| 참고 | 트랜잭션 조회 |
3. 시스템 구성
FlowKat의 주요 화면 및 기능 모듈을 설명합니다.
센트리 (Sentry / Uptime)
| 항목 | 내용 |
|---|
| 한글명 | 센트리 |
| 영문명 | Sentry (Uptime Monitoring) |
| 정의 | 서비스의 가용성(Uptime)을 주기적으로 점검하는 모니터링 기능입니다. 지정된 URL에 주기적으로 요청을 보내 응답 여부와 응답시간을 기록하며, 장애 발생 시 알람을 발송합니다. |
| 관련 화면 | 센트리 (/availability/uptime), 센트리 관리 (/setting/uptime) |
| 참고 | 센트리 |
파노라마 (Panorama)
| 항목 | 내용 |
|---|
| 한글명 | 파노라마 |
| 영문명 | Panorama |
| 정의 | 전체 시스템의 상태를 한눈에 파악할 수 있는 토폴로지 맵 화면입니다. 오브젝트와 서비스 간의 연결 관계를 시각화하고, 각 노드의 현재 상태를 색상으로 표시합니다. |
| 관련 화면 | 파노라마 (/availability/panorama) |
| 참고 | 파노라마 |
토폴로지 (Topology)
| 항목 | 내용 |
|---|
| 한글명 | 토폴로지 |
| 영문명 | Topology |
| 정의 | 서비스와 서비스, 서비스와 데이터베이스 사이의 호출 관계를 그래프 형태로 나타낸 구조도입니다. 파노라마 화면에서 시스템 전체의 연결 구조를 파악하는 데 활용합니다. |
| 관련 화면 | 파노라마 (/availability/panorama) |
| 참고 | 파노라마 |
트랜잭션 익스플로러 (Tx Explorer)
| 항목 | 내용 |
|---|
| 한글명 | 트랜잭션 익스플로러 |
| 영문명 | Transaction Explorer (Tx Mining) |
| 정의 | 수집된 트랜잭션 로그 데이터를 심층 분석하는 전용 화면입니다. 히스토그램, TopN 집계, 이상 탐지 기능을 통해 트래픽 패턴과 이상 징후를 발견할 수 있습니다. |
| 관련 화면 | 트랜잭션 익스플로러 (/tx-mining/log) |
| 참고 | 트랜잭션 익스플로러 개요 |
4. 차트 및 시각화
FlowKat의 데이터 시각화 요소에 대한 설명입니다.
히스토그램 (Histogram)
| 항목 | 내용 |
|---|
| 한글명 | 히스토그램 |
| 영문명 | Histogram |
| 정의 | 일정 시간 구간별 트랜잭션 수를 막대그래프로 표시하는 차트입니다. 트랜잭션 익스플로러의 디스커버리 탭에서 제공되며, 시간 범위를 좁혀가며 이상 구간을 탐색하는 데 활용합니다. |
| 관련 화면 | 트랜잭션 익스플로러 (/tx-mining/log) |
| 참고 | 트랜잭션 익스플로러 로그 |
브러시 (Brush)
| 항목 | 내용 |
|---|
| 한글명 | 브러시 |
| 영문명 | Brush (Range Selection) |
| 정의 | 히스토그램 또는 XLOG 산점도에서 특정 시간 범위나 응답시간 구간을 드래그하여 선택하는 기능입니다. 선택한 범위의 데이터만 재검색하거나 상세 분석할 수 있습니다. |
| 관련 화면 | XLOG (/monitoring/xlog), 트랜잭션 익스플로러 |
| 참고 | XLOG 개요 |
TopN 분석
| 항목 | 내용 |
|---|
| 한글명 | TopN 분석 |
| 영문명 | TopN Analysis |
| 정의 | 특정 필드(URL, IP, 사용자 에이전트 등)를 기준으로 트랜잭션 건수나 응답시간의 상위 N개 항목을 집계하여 표시하는 분석 기능입니다. 트래픽을 가장 많이 유발하는 원인을 빠르게 파악할 수 있습니다. |
| 관련 화면 | 트랜잭션 익스플로러 트래픽 분석 탭 |
| 참고 | 트랜잭션 익스플로러 로그 |
이상 탐지 (Anomaly Detection)
| 항목 | 내용 |
|---|
| 한글명 | 이상 탐지 |
| 영문명 | Anomaly Detection |
| 정의 | 트래픽 패턴에서 평소와 다른 비정상적인 변화를 자동으로 감지하는 기능입니다. IP 플러드, 특정 사용자 에이전트의 급증 등 이상 징후를 시각적으로 표시합니다. |
| 관련 화면 | 트랜잭션 익스플로러 트래픽 분석 탭 |
| 참고 | 트랜잭션 익스플로러 개요 |
5. 설정 및 관리
알람, 권한, 역할 관련 용어를 정리합니다.
알람 규칙 (Alarm Rule)
| 항목 | 내용 |
|---|
| 한글명 | 알람 규칙 |
| 영문명 | Alarm Rule |
| 정의 | 특정 메트릭 값이 설정된 임계값을 초과할 때 알람을 발생시키는 조건을 정의한 규칙입니다. 메트릭 종류, 임계값, 우선순위, 연동할 알람 채널 등을 설정합니다. |
| 관련 화면 | 수집 서버 관리 > 알람 관리 (/setting/collectors) |
| 참고 | 수집 서버 관리 |
알람 연동 (Alarm Integration)
| 항목 | 내용 |
|---|
| 한글명 | 알람 연동 |
| 영문명 | Alarm Integration |
| 정의 | 알람 발생 시 외부 알림 채널(이메일, Slack, Telegram, Mattermost 등)로 메시지를 전송하는 연동 설정입니다. 알람 규칙과 연동 채널을 연결하여 담당자에게 즉시 알림을 보낼 수 있습니다. |
| 관련 화면 | 수집 서버 관리 > 알람 관리 (/setting/collectors) |
| 참고 | 수집 서버 관리 |
임계값 (Threshold)
| 항목 | 내용 |
|---|
| 한글명 | 임계값 |
| 영문명 | Threshold |
| 정의 | 알람 규칙에서 알람을 발생시키는 기준 수치입니다. 예를 들어 "응답시간 2,000ms 초과" 또는 "TPS 0 이하"와 같이 수치 조건으로 설정합니다. |
| 관련 화면 | 수집 서버 관리 > 알람 관리 |
| 참고 | 수집 서버 관리 |
우선순위 (Priority)
| 항목 | 내용 |
|---|
| 한글명 | 우선순위 |
| 영문명 | Priority |
| 정의 | 알람의 심각도를 나타내는 등급입니다. FlowKat은 4단계 우선순위를 사용합니다. info는 참고 정보, warning은 주의 필요, error는 오류 발생, critical은 즉각 대응이 필요한 심각한 상태를 의미합니다. |
| 관련 화면 | 수집 서버 관리 > 알람 관리, 이슈 추적 |
| 참고 | 수집 서버 관리 |
역할 (Role)
| 항목 | 내용 |
|---|
| 한글명 | 역할 |
| 영문명 | Role |
| 정의 | 사용자에게 부여되는 접근 권한의 집합입니다. FlowKat에서는 역할에 따라 접근 가능한 메뉴와 수행 가능한 작업이 결정됩니다. Admin(관리자)과 Guest(게스트)는 기본 제공 역할로 삭제할 수 없습니다. |
| 관련 화면 | 사용자 관리 > 역할 관리 (/setting/users) |
| 참고 | 사용자 관리 |
권한 (Permission)
| 항목 | 내용 |
|---|
| 한글명 | 권한 |
| 영문명 | Permission |
| 정의 | 역할에 포함된 개별 기능 접근 허가 항목입니다. 설정 메뉴 접근, 데이터 수정, 사용자 관리 등 기능별로 세분화되어 있으며, 역할 설정 화면에서 체크박스 형태로 관리합니다. |
| 관련 화면 | 사용자 관리 > 역할 관리 (/setting/users) |
| 참고 | 사용자 관리 |
읽기 전용 (Read-Only)
| 항목 | 내용 |
|---|
| 한글명 | 읽기 전용 |
| 영문명 | Read-Only |
| 정의 | 데이터를 조회만 할 수 있고 생성, 수정, 삭제는 불가능한 접근 수준입니다. 권한이 제한된 사용자는 일부 버튼이나 입력 필드가 비활성화되거나 표시되지 않습니다. |
| 관련 화면 | 사용자 관리 > 역할 관리 |
| 참고 | 사용자 관리 |
메뉴 접근 권한
| 항목 | 내용 |
|---|
| 한글명 | 메뉴 접근 권한 |
| 영문명 | Menu Access Permission |
| 정의 | 특정 메뉴 또는 페이지에 접근할 수 있는 권한입니다. 역할에 메뉴 접근 권한이 없으면 해당 메뉴 항목 자체가 표시되지 않습니다. |
| 관련 화면 | 사용자 관리 > 역할 관리 |
| 참고 | 사용자 관리 |
6. 실시간 통신
FlowKat의 실시간 데이터 수신 방식에 관한 용어입니다.
WebSocket
| 항목 | 내용 |
|---|
| 한글명 | 웹소켓 |
| 영문명 | WebSocket |
| 정의 | 서버와 브라우저 사이에 양방향 실시간 통신 채널을 유지하는 프로토콜입니다. FlowKat은 STOMP over SockJS 방식으로 역할/권한 변경 동기화와 이슈 추적 알림에 사용합니다. |
| 관련 화면 | 전체 화면 (백그라운드 연결) |
| 참고 | 메트릭 데이터 수집 구조 |
폴링 (Polling)
| 항목 | 내용 |
|---|
| 한글명 | 폴링 |
| 영문명 | Polling |
| 정의 | 브라우저가 일정 주기로 서버에 HTTP 요청을 보내 최신 데이터를 가져오는 방식입니다. FlowKat은 Web Worker를 활용하여 대시보드 성능 카운터와 XLOG 데이터를 2초 간격으로 폴링합니다. 탭이 비활성화되면 자동으로 중단됩니다. |
| 관련 화면 | 통합 대시보드, XLOG |
| 참고 | 메트릭 데이터 수집 구조 |
SSE (서버 전송 이벤트)
| 항목 | 내용 |
|---|
| 한글명 | 서버 전송 이벤트 |
| 영문명 | SSE (Server-Sent Events) |
| 정의 | 서버에서 브라우저 방향으로만 데이터를 스트리밍하는 단방향 통신 방식입니다. FlowKat에서는 센트리 서버의 상태 변경 이벤트를 브라우저에 실시간으로 전달하는 데 사용합니다. |
| 관련 화면 | 센트리 (/availability/uptime) |
| 참고 | 센트리 |
7. 찾아보기 (가나다순)
자주 찾는 용어를 가나다 순서로 빠르게 찾을 수 있습니다.