트랜잭션 통계
트랜잭션 통계 페이지에서는 수집된 트랜잭션 데이터를 다양한 기준으로 집계하여 성능 패턴과 병목 구간을 분석할 수 있습니다.
1. 페이지 개요
1.1 기능 설명
| 기능 | 설명 |
|---|---|
| URL 통계 | 서비스 URL별 호출 수, 응답시간, 에러율 |
| SQL 통계 | SQL 쿼리별 실행 횟수, 수행 시간 |
| HTTP 호출 통계 | 외부 API 호출 현황 및 응답시간 |
| 사용자 에이전트 통계 | 브라우저/OS별 요청 분포 + OS·브라우저 파이 차트 |
| 에러 통계 | 에러/메시지 복합 기준, 서비스별, 건수 집계 |
| 클라이언트 IP 통계 | 접속 클라이언트 IP별 요청 수 |
| 방문자 수 통계 | 일별 차트·시간별 차트·KPI 카드·최고/최저 |
1.2 접근 경로
URL: /workgroup/[workgroupId]/tx-stats/[stats]
메뉴: 대시보드 > 트랜잭션 통계
로그인한 사용자면 누구나 접근할 수 있습니다. SQL Viewer 기능은 ALLOW_SQL_VIEW 권한이 부여된 역할만 표시됩니다.
2. 화면 구성
2.1 공통 레이아웃
| 영역 | 설명 |
|---|---|
| 검색 영역 | 날짜 범위, 서버/오브젝트 선택 |
| 요약 카드 영역 | MStatCard — 총 호출수·에러수·평균 응답시간·에러율 |
| 차트 영역 | 일별/시간별 추이 차트 |
| 상세 데이터 테이블 | 상세 데이터 테이블 (가상 스크롤, 10만 건 이상 지원) |
상세 데이터 테이블은 react-window 기반의 가상 스크롤을 사용합니다. 10만 건 이상의 데이터도 빠르게 렌더링합니다.
2.2 전체 화면
2.3 하위 메뉴
| 메뉴 | 설명 |
|---|---|
| URL | 서비스 URL 패턴별 통계 |
| SQL | SQL 쿼리별 통계 |
| HTTP 호출 | 외부 API 호출 통계 |
| 사용자 에이전트 | 브라우저/OS별 통계 |
| 에러 | 에러 유형별 통계 |
| 클라이언트 IP | 클라이언트 IP별 통계 |
| 방문자 수 | 방문자 수 추이 |
3. 사용 방법
3.1 기본 동작
- 날짜 범위 설정: 조회할 기간을 선택하십시오. (기본: 7일 전 ~ 오늘)
- 서버/오브젝트 선택: 분석할 서버와 오브젝트를 선택하십시오.
- 검색 실행: 검색 버튼을 클릭하여 데이터를 조회합니다.
- 차트 확인: 일별 추이 차트에서 패턴을 파악합니다.
- 상세 확인: 테이블에서 세부 데이터를 확인합니다.
테이블 행을 클릭하면 XLogSearchDialog 팝업창이 열려 해당 항목의 상세 XLOG 데이터를 조회할 수 있습니다.
3.2 통계 항목별 상세
TPS 설명
TPS(초당 트랜잭션 수)는 초당 트랜잭션 처리 건수를 나타냅니다.
XLOG 설명
XLOG는 트랜잭션 로그를 의미합니다.
URL 통계
| 항목 | 설명 |
|---|---|
| URL | URL 패턴 |
| 호출 수 | 총 요청 횟수 |
| 에러 수 | 에러 발생 횟수 |
| 평균 응답시간 | 평균 처리 시간 (ms) |
| 에러율 | 에러 비율 (%) |
SQL 통계
| 항목 | 설명 |
|---|---|
| SQL | 실행된 SQL 쿼리 |
| 호출 수 | 총 실행 횟수 |
| 에러 수 | 에러 발생 횟수 |
| 평균 응답시간 | 평균 실행 시간 (ms) |
| 에러율 | 에러 비율 (%) |
ALLOW_SQL_VIEW 권한이 있는 역할에게만 SQL 상세 내용을 확인하는 SQL Viewer 팝업창이 표시됩니다. 권한이 없는 경우 SQL 텍스트 셀을 클릭해도 팝업창이 열리지 않습니다.
에러 통계
에러 통계는 아래 3개 컬럼으로 구성됩니다.
| 항목 | 설명 |
|---|---|
| 에러/메시지 | 에러 코드와 메시지를 복합하여 표시 |
| 서비스 | 해당 에러가 발생한 서비스(URL) |
| 건수 | 에러 발생 횟수 |
클라이언트 IP 통계
클라이언트 IP 통계는 아래 2개 컬럼으로 구성됩니다.
| 항목 | 설명 |
|---|---|
| IP | 클라이언트 IP 주소 |
| 건수 | 해당 IP의 요청 횟수 |
사용자 에이전트 통계
사용자 에이전트 통계는 아래 2개 컬럼의 상세 테이블과 별도의 파이 차트를 제공합니다.
| 항목 | 설명 |
|---|---|
| 사용자 에이전트 | 사용자 에이전트 문자열 |
| 건수 | 해당 사용자 에이전트의 요청 횟수 |
테이블 우측에는 OS별 파이 차트와 브라우저별 파이 차트가 별도로 제공되어 운영체제·브라우저 분포를 한눈에 파악할 수 있습니다.
방문자 수 통계
방문자 수 통계는 단순 테이블이 아닌 복합 레이아웃으로 구성됩니다.
| 영역 | 설명 |
|---|---|
| 일별 차트 | 날짜별 방문자 수 추이 막대/라인 차트 |
| 시간별 차트 | 시간대별 방문자 수 분포 차트 |
| KPI 카드 | 총 방문자·일 평균·최대·최소 등 주요 지표 |
| 최고/최저 구간 | 방문자 수가 가장 높거나 낮은 날짜·시간대 표시 |
4. 필터 및 검색
4.1 공통 필터
| 필터 항목 | 설명 | 사용 예시 |
|---|---|---|
| 날짜 범위 | 조회 기간 | 2026-02-06 ~ 2026-02-13 |
| 서버 선택 | 수집 서버 | "flowkat-was" |
| 오브젝트 선택 | 모니터링 대상 | "tomcat-main" |
4.2 항목별 필터
각 통계 항목별로 추가 필터가 제공됩니다. 예를 들어 SQL 통계에서는 특정 SQL 패턴을 검색할 수 있습니다.
4.3 CSV 다운로드
모든 상세 데이터 테이블 우측 상단에 CSV 다운로드 버튼이 제공됩니다. 현재 조회된 전체 데이터를 CSV 파일로 내려받을 수 있습니다.
다운로드된 CSV 파일은 Excel 등 외부 도구에서 추가 분석에 활용할 수 있습니다.
5. 데이터 갱신
5.1 데이터 로딩
- 로딩 방식: 요청 시점 데이터 조회
- 기본 조회 기간: 7일
5.2 수동 갱신
검색 조건을 변경 후 검색 버튼을 클릭하십시오.
6. 문제 해결
6.1 자주 발생하는 문제
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 데이터가 없습니다 | 선택한 기간에 데이터 없음 | 기간 확장 |
| 차트가 표시되지 않음 | 데이터량 부족 | 조회 기간 연장 |
| 느린 조회 | 데이터량 과다 | 기간 단축 또는 필터 사용 |
| SQL Viewer가 표시되지 않음 | ALLOW_SQL_VIEW 권한 없음 | 관리자에게 권한 요청 |
조회 기간이 길고 데이터량이 많을 경우 응답 시간이 길어질 수 있습니다. 필요한 기간만 조회하십시오.