로그 뷰어

로그 뷰어는 서버에서 수집된 시스템 로그를 대시보드에서 바로 확인할 수 있는 기능입니다. 서버에 직접 접속하지 않고도 오류 메시지, 시스템 이벤트, 서비스 로그를 검색하고 분석할 수 있습니다.

로그 수집 에이전트 필요

로그 뷰어를 사용하려면 대상 서버에 로그 수집 에이전트(Fluent Bit)가 설치되어 있어야 합니다. 설치 여부는 관리자에게 문의하세요.

---

로그 뷰어 열기

로그 뷰어에 접근하는 방법은 두 가지입니다.

방법 1: 사이드바에서 접근

1. 왼쪽 사이드바에서 시스템 로그를 클릭합니다.
2. 로그 뷰어 화면이 열립니다.

방법 2: 위젯에서 접근

1. 대시보드의 로그 관련 위젯에서 자세히 보기를 클릭합니다.
2. 해당 서버의 로그가 필터링된 상태로 로그 뷰어가 열립니다.

---

로그 검색하기

시간 범위 선택

로그 뷰어 상단에서 조회할 시간 범위를 지정합니다.

기간 옵션	용도
15분	방금 발생한 오류 확인
1시간	최근 이벤트 확인
6시간	오전/오후 중 이벤트 추적
24시간	하루 전체 로그 확인
직접 입력	특정 날짜·시간 범위 지정

키워드 필터

검색창에 키워드를 입력하여 원하는 로그만 필터링합니다.

• AND 검색 — 키워드를 공백으로 구분 (예: error disk → error와 disk가 모두 포함된 로그)
• OR 검색 — 키워드 사이에 OR 입력 (예: error OR warning → 둘 중 하나라도 포함된 로그)

서버 필터

특정 서버의 로그만 보고 싶을 때 서버 필터를 사용합니다.

1. 서버 선택 드롭다운을 클릭합니다.
2. 서버 이름 또는 IP로 검색합니다.
3. 원하는 서버를 선택합니다 (복수 선택 가능).

로그 레벨 필터

특정 심각도의 로그만 표시하려면 레벨 필터를 사용합니다.

1. 레벨 드롭다운을 클릭합니다.
2. 확인하고 싶은 레벨을 선택합니다 (복수 선택 가능).

---

로그 레벨 의미

레벨	색상	의미	대응
ERROR	빨간색	서비스 오류가 발생한 상태입니다	즉시 확인하고 원인을 파악하세요
WARN	노란색	주의가 필요한 상태입니다	반복되면 조치가 필요합니다
INFO	파란색	정상적인 동작 정보입니다	참고용으로 확인합니다

ERROR 로그 우선 확인

로그 레벨 필터에서 ERROR만 선택하면 문제가 된 이벤트만 빠르게 찾을 수 있습니다. 오류 발생 전후 맥락이 필요하면 INFO도 함께 표시하세요.

---

이런 상황에서 확인하세요

상황	어디를 보면 되나요	확인 포인트
"서버가 갑자기 느려졌어"	해당 서버 + ERROR/WARN 필터	디스크 I/O 오류, OOM(메모리 부족) 메시지 확인
"서비스가 중단됐어"	해당 서버 + 중단 시점 시간 범위	systemd 서비스 stop/fail 로그 확인
"어젯밤에 뭔 일이 있었는지 모르겠어"	전체 서버 + 24시간 + ERROR	야간에 발생한 오류 이벤트 일괄 확인
"특정 프로세스 로그만 보고 싶어"	키워드 필터에 프로세스명 입력	해당 프로세스의 동작 이력만 추출
"GPU 오류 관련 로그를 찾고 싶어"	키워드: xid 또는 gpu	GPU 하드웨어 오류 관련 커널 로그 확인

---

로그가 보이지 않을 때

로그 뷰어에서 데이터가 표시되지 않는 경우 아래 항목을 확인하세요.

증상	원인	해결 방법
특정 서버 로그가 없음	Fluent Bit(로그 수집기)가 설치되지 않음	관리자에게 로그 수집 에이전트 설치 요청
모든 서버 로그가 없음	로그 수집 서비스가 중단됨	관리자에게 수집 서비스 상태 확인 요청
최근 로그만 없음	에이전트가 중지되었거나 네트워크 문제	에이전트 실행 상태 확인, 네트워크 연결 점검
검색 결과가 없음	시간 범위가 너무 좁거나 키워드 불일치	시간 범위를 넓히거나 키워드를 수정

로그 보관 기간

로그는 기본 30일간 보관됩니다. 30일이 지난 로그는 자동으로 삭제되므로, 중요한 로그는 내보내기 기능으로 저장해두세요.