XLOG (트랜잭션 로그)
XLOG 페이지는 트랜잭션 로그를 조회하고 다양한 기준으로 그룹핑하여 분석할 수 있는 기능을 제공합니다. 서비스 응답 패턴과 성능 병목을 식별하십시오.
권한별 화면 차이
역할 설정에서 조회 > XLOG 메뉴 접근 권한이 필요합니다. 권한이 없으면 메뉴가 표시되지 않습니다.
1. 페이지 개요
1.1 기능 설명
| 기능 | 설명 |
|---|---|
| XLOG 검색/분석 | 시간 범위 기반 트랜잭션 로그 검색 및 그룹핑 분석 |
| 고급 검색 | 조건 기반 상세 검색 (TXID, URL, 클라이언트 IP 등) |
| 통계 요약 | 그룹별 응답시간/처리량 통계 |
| Profile search | 프로파일 내용 기반 트랜잭션 검색 |
1.2 접근 경로
XLOG 기능은 두 가지 경로로 접근할 수 있습니다.
| 구분 | URL | 설명 |
|---|---|---|
| XLOG 검색/분석 | /workgroup/[workgroupId]/analysis/transaction | 시간 범위 기반 트랜잭션 검색 및 그룹핑 분석 (본 문서의 주요 기능) |
| 실시간 XLOG 위젯 | 대시보드 위젯 (/monitoring/xlog) | 대시보드에 추가 가능한 실시간 트랜잭션 표시 위젯 |
실시간 XLOG와 검색 페이지 구분
- 실시간 XLOG (XLogRealtimeWidget): 대시보드에 배치하는 위젯으로, 수집 서버에서 트랜잭션이 발생하는 즉시 표시합니다. 검색/필터 기능은 제한적입니다.
- XLOG 검색/분석 (
**/analysis/transaction**): 특정 시간 범위를 지정하여 트랜잭션을 검색하고, 다양한 기준으로 그룹핑 분석합니다. 본 문서에서 설명하는 주요 기능입니다.
2. 화면 구성
2.1 주요 영역
| 영역 | 설명 |
|---|---|
| 검색 조건 영역 | 서버 선택, 시간 범위, 검색 조건 |
| 오브젝트 목록 영역 | 모니터링 대상 오브젝트 목록 |
| 탭 영역 | 그룹핑 탭 (트랜잭션, URL 요약, 클라이언트 IP 요약 등) |
| 데이터 테이블 영역 | 트랜잭션 목록 및 상세 정보 |
2.2 전체 화면
2.3 UI 구성도
3. 사용 방법
3.1 기본 동작
- 서버 선택: 검색 조건 영역에서 수집 서버를 선택하십시오.
- 오브젝트 선택: 분석할 오브젝트를 선택 상자로 선택합니다.
- 시간 범위 설정: 조회할 시간 구간을 지정합니다.
- 검색 실행: 검색 버튼을 클릭하여 데이터를 조회합니다.
- 탭 전환: 원하는 그룹핑 기준으로 탭을 전환합니다.
3.2 그룹핑 탭
| 탭 | 설명 | 활용 |
|---|---|---|
| 트랜잭션 | 트랜잭션별 상세 정보 | 개별 요청 분석 |
| URL 요약 | URL 패턴별 통계 | API별 성능 분석 |
| 클라이언트 IP 요약 | 클라이언트 IP별 분석 | 지역별 트래픽 파악 |
| 사용자 에이전트 요약 | 브라우저/OS별 분석 | 클라이언트 환경 파악 |
| 이전 URL 요약 | 유입 경로별 분석 | 트래픽 소스 파악 |
3.3 고급 검색
고급 검색 버튼을 클릭하면 상세 검색 조건을 설정할 수 있습니다.
| 조건 | 설명 |
|---|---|
| TXID | 특정 트랜잭션 ID로 검색 |
| URL (application_name) | 특정 URL 또는 서비스명으로 필터 |
| 클라이언트 IP | 특정 접속 IP로 필터 |
| User ID | 특정 사용자 ID로 필터 |
| 사용자 에이전트 | 브라우저/클라이언트 정보로 필터 |
| 이전 URL (referrer) | 유입 경로 URL로 필터 |
| GXID | 글로벌 트랜잭션 ID로 연관 트랜잭션 검색 |
| Profile search | 프로파일 내용(SQL, 메서드명 등)으로 검색 |
Profile search 탭
고급 검색의 Profile search 탭에서는 트랜잭션 프로파일 내용을 기준으로 검색할 수 있습니다.
| 항목 | 설명 |
|---|---|
| 검색어 | 프로파일에 포함된 SQL 구문, 메서드명, 외부 호출 URL 등 |
| 검색 범위 | 선택된 시간 범위 내 모든 트랜잭션의 프로파일을 검색 |
Profile search 활용
특정 SQL이나 메서드를 실행한 트랜잭션을 찾고 싶을 때 유용합니다. 예: "SELECT * FROM orders" 를 실행한 트랜잭션을 빠르게 찾을 수 있습니다.
3.4 검색 취소
검색이 진행 중인 경우 검색 취소 버튼을 클릭하여 진행 중인 검색을 중단(abort)할 수 있습니다.
| 동작 | 설명 |
|---|---|
| 검색 취소 버튼 클릭 | 진행 중인 검색 요청을 즉시 중단합니다 |
| 취소 후 상태 | 취소 이전까지 수신된 데이터가 표시됩니다 |
검색 취소 활용
시간 범위가 넓거나 데이터 양이 많아 검색이 오래 걸릴 때, 검색을 취소하고 시간 범위를 좁혀 다시 검색하면 빠른 결과를 얻을 수 있습니다.
4. 검색 결과 분석
4.1 데이터 테이블 컬럼
| 컬럼 | 설명 |
|---|---|
| 서비스명 | API/서비스 명칭 |
| 응답시간 | 평균/최소/최대 응답시간 |
| 호출 수 | 트랜잭션 발생 횟수 |
| 에러 수 | 실패 트랜잭션 수 |
| 에러율 | 실패 비율 (%) |
4.2 검색 소요 시간 표시
검색이 완료되면 결과 상단에 검색 소요 시간이 표시됩니다. 이를 통해 검색 성능을 파악하고 시간 범위나 조건을 조정할 수 있습니다.
| 표시 위치 | 설명 |
|---|---|
| 결과 상단 | 검색 시작부터 완료까지의 총 소요 시간 (예: 검색 완료: 1.2초) |
4.3 상세 정보
트랜잭션 행을 클릭하면 상세 정보를 확인할 수 있습니다.
| 항목 | 설명 |
|---|---|
| 타임라인 | 트랜잭션 실행 경로 시각화 |
| 호출 체인 | 메소드 호출 순서 |
| SQL 목록 | 실행된 쿼리 목록 |
| HTTP 호출 | 외부 API 호출 현황 |
5. 액션 메뉴 (헤더 더보기)
우측 상단의 더보기(⋮) 버튼을 클릭하면 다양한 액션 메뉴가 표시됩니다.
5.1 메뉴 구성
| 메뉴 | 아이콘 | 설명 | 권한 | 표시 조건 |
|---|---|---|---|---|
| 시작 페이지 설정 | 홈 | 현재 페이지를 로그인 후 시작 페이지로 설정 | 전체 | 항상 |
| 녹화 시작/중지 | 원 | 화면 녹화 전환 (빨간색 = 녹화 중) | 전체 | 항상 |
| 이슈 추적 | 벌레 | 이슈 추적 페이지로 이동 | 조회 | /tracking 접근 권한 필요 |
| 이슈 캡처 | 플러스 | 현재 화면 캡처 후 이슈 자동 생성 | 쓰기 | tracking 쓰기 권한 필요 |
| PDF 캡처 | 현재 화면을 PDF로 저장 | 전체 | 항상 | |
| PNG 캡처 | 이미지 | 현재 화면을 이미지로 저장 | 전체 | 항상 |
메뉴 표시 조건
- 이슈 추적/이슈 캡처: tracking 도메인 접근 권한이 없으면 메뉴 자체가 표시되지 않습니다.
- 캡처 메뉴: 캡처 진행 중에는 다른 캡처 관련 메뉴가 비활성화됩니다.
성능 분석 캡처
성능 이슈 발견 시 XLOG 화면을 캡처하여 이슈로 등록하면 원인 파악에 도움이 됩니다.
6. 데이터 갱신
6.1 검색 방식
- 데이터 조회: 지정된 시간 범위의 히스토리 데이터 검색
- 워커 처리: Web Worker를 통한 대량 데이터 처리
- 실시간 XLOG 위젯: 대시보드의 XLogRealtimeWidget을 통해 실시간 트랜잭션 표시 — 검색 페이지(
/analysis/transaction)와는 별도로 동작합니다
6.2 검색 상태
| 상태 | 표시 | 설명 |
|---|---|---|
| 검색 중 | 로딩 바 | 데이터 조회 진행 중 |
| 검색 완료 | 데이터 테이블 표시 + 소요 시간 | 결과 데이터 및 검색 소요 시간 표시 |
| 검색 취소 | 중단 버튼 클릭 | 진행 중인 검색 요청 중단(abort) |
7. 문제 해결
7.1 자주 발생하는 문제
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 데이터가 표시되지 않음 | 시간 범위 오류 | 시간 범위 재설정 |
| 검색이 느림 | 데이터 과다 | 시간 범위 축소 후 검색 취소 버튼 활용 |
| 그룹핑되지 않음 | 탭 미선택 | 원하는 탭 선택 |
| 탭 전환이 안 됨 | 검색 진행 중 | 검색 완료 후 전환 |