태블로 로그 분석 방법 - TLV 활용

 

태블로 로그를 분석할 때는 문제 해결과 성능 최적화라는 두 가지 주요 목적이 있습니다.
로그를 확인하는 방법과 주요 체크 포인트를 알려드릴게요.

1. 태블로 로그 파일 위치

태블로는 다양한 로그 파일을 생성하며, 사용하는 제품(Tabloe Desktop, Server, Cloud)에 따라 위치가 다릅니다.

(1) 태블로 데스크톱 로그 위치

• Windows:

C:\Users\<사용자이름>\Documents\My Tableau Repository\Logs

• Mac:

~/Documents/My Tableau Repository/Logs

(2) 태블로 서버 로그 위치

• Windows (기본 경로):

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs

• Linux (기본 경로):

/var/opt/tableau/tableau_server/data/tabsvc/logs

• 태블로 서버에서 로그를 압축하여 가져오려면:

tsm maintenance ziplogs -o <출력경로>

실행 후 압축된 로그 파일을 분석하면 됩니다.

 

2. 주요 로그 파일 종류 및 분석 방법

태블로 로그는 여러 종류가 있으며, 목적에 따라 확인해야 할 로그가 다릅니다.

(1) 태블로 데스크톱 로그

로그 파일 설명 분석 포인트

- log.txt 태블로 데스크톱의 일반적인 활동 기록 오류 발생 시 검색 (ERROR 또는 Exception)
- tabprotosrv.txt 데이터 쿼리 및 추출 관련 로그 쿼리 실행 시간 및 오류 확인
- hyperd.log Hyper 추출 엔진 관련 로그 추출 생성/로드 오류 및 성능 이슈

🔍 태블로 데스크톱 로그 분석 방법

1. log.txt에서 "ERROR" 또는 "Exception" 키워드 검색
2. tabprotosrv.txt에서 "Query execution" 검색하여 성능 이슈 확인
3. hyperd.log에서 "Failed" 또는 "Warning" 확인

(2) 태블로 서버 로그

로그 파일 설명 분석 포인트

vizqlserver.log 대시보드 렌더링 및 사용자 활동 성능 문제 분석 (BootstrapSession 또는 Session End)
backgrounder.log 추출 새로고침 및 예약 작업 추출 실패 및 성능 문제 (Job failed 검색)
hyperd.log 데이터 추출 및 쿼리 실행 쿼리 실행 오류 및 성능 문제
wgserver.log 웹 요청 관련 로그 태블로 서버 로그인 및 사용자 요청
tsm.log Tableau Services Manager(TSM) 로그 서버 시작/중지 문제

🔍 태블로 서버 로그 분석 방법

1. vizqlserver.log에서 "Session End" 키워드 검색 → 대시보드 로드 시간 확인
2. backgrounder.log에서 "Job failed" 검색 → 추출 새로고침 실패 확인
3. hyperd.log에서 "Failed" 검색 → 쿼리 오류 확인
4. 서버 성능 문제 시 tsm status -v 명령어 실행하여 서버 상태 점검

3. 태블로 로그 분석 툴 활용

태블로 로그는 JSON 또는 CSV 형식으로 정리하여 분석할 수 있습니다.

• Tableau Log Viewer (TLV) 사용

• 무료 오픈소스 툴: https://github.com/tableau/tableau-log-viewer
• 시각적으로 로그를 분석할 수 있음

GitHub - tableau/tableau-log-viewer: Tableau Log Viewer is a cross-platform tool for quickly glancing over Tableau log files

 

• Python 또는 Tableau 활용

• pandas를 사용해 로그 분석 가능

import pandas as pd



log_file = "log.txt"

df = pd.read_csv(log_file, delimiter="\t", error_bad_lines=False)

print(df.head())

•Tableau에서 CSV 파일로 불러와 시각적으로 분석 가능

4. 성능 최적화를 위한 로그 분석 체크리스트

문제 유형 확인할 로그 분석 포인트

- 대시보드 로딩 느림 : vizqlserver.log "Session End"을 확인하여 로딩 시간 분석
- 데이터 쿼리 느림 : tabprotosrv.txt 또는 hyperd.log "Query execution" 시간 분석
- 추출 새로고침 실패 : backgrounder.log "Job failed" 확인
- 서버 다운 또는 장애 : tsm.log 및 wgserver.log "ERROR" 또는 "Exception" 확인

결론

1. 어떤 문제인지 먼저 파악 (성능 이슈 vs 오류 발생)
2. 해당 문제에 맞는 로그 파일을 찾고, 키워드로 검색 (ERROR, Exception, Failed 등)
3. Tableau Log Viewer 또는 Python을 활용하여 분석
4. 성능 이슈라면 실행 시간과 세션 종료 로그를 확인

태블로 로그를 효과적으로 분석하면 문제 해결뿐만 아니라 성능 최적화도 가능합니다.
도움이 되셨다면 공감과 댓글 부탁 드려요! 😊