5.3. 로그 뷰어
모든 애플리케이션의 로그를 통합 검색하고 다양한 필터로 분석합니다.
개요
로그 뷰어 화면에서는 모든 애플리케이션(Application)의 로그(Log)를 한곳에서 검색하고 조회할 수 있습니다. 로그(Log)는 애플리케이션에서 발생한 이벤트를 기록한 데이터입니다.
키워드 검색, 레벨 필터, 소스 필터, 속성 필터를 조합하여 원하는 로그를 빠르게 찾을 수 있으며, 로그 메시지 패턴 추세 차트를 통해 시간대별 로그 발생량 변화를 파악할 수 있습니다.
개별 애플리케이션 상세 페이지의 로그 탭과 달리, 여러 애플리케이션의 로그를 동시에 조회하거나 전체 애플리케이션에서 특정 오류 메시지를 검색할 때 유용합니다.
좌측 사이드바에서 로그 뷰어 메뉴를 클릭하면 진입할 수 있습니다.
로그 수집 소스
로그는 두 가지 소스에서 수집됩니다.
| 소스 | 설명 |
|---|---|
| OTEL | OpenTelemetry SDK를 통해 애플리케이션이 직접 전송하는 로그 |
| 컨테이너(Container) | 컨테이너 런타임에서 자동으로 수집되는 표준 출력/표준 에러 로그 |
화면 구성
로그 뷰어 화면은 크게 세 영역으로 구성됩니다.
| 영역 | 설명 |
|---|---|
| 상단 헤더 | 페이지 제목과 애플리케이션 필터 |
| 좌측 속성 필터 패널 | 로그 속성 기반 세부 필터 설정 |
| 메인 콘텐츠 영역 | 검색 바, 필터 컨트롤, 추세 차트, 로그 메시지 목록 |
상단 헤더
화면 상단에는 애플리케이션 필터가 있어 조회할 애플리케이션의 범위를 설정합니다. 네임스페이스(Namespace), 카테고리, 또는 애플리케이션 이름으로 조회 범위를 지정할 수 있습니다. 필터를 설정하지 않으면 모든 애플리케이션 로그가 조회됩니다.
좌측 속성 필터 패널
로그에 포함된 속성을 기준으로 세부 필터를 설정할 수 있습니다. 패널 상단의 닫기 버튼을 클릭하면 패널을 접어 로그 목록을 더 넓게 볼 수 있습니다.
패널에서 제공하는 기능은 다음과 같습니다.
- 필터 속성 선택: 사용할 필터 속성을 선택하거나 해제합니다. 각 속성 옆에 사용 가능한 값의 수가 표시됩니다.
- 속성별 값 필터링: 선택한 속성에서 특정 값만 골라 필터링합니다. 각 속성 섹션 내 검색 필드로 값을 검색할 수 있습니다.
- 전체 선택/해제: 속성 단위 또는 전체 필터를 일괄 선택하거나 해제합니다.
참고: 필터 패널의 표시 상태는 브라우저에 저장되어 다음 접속 시에도 유지됩니다.
메인 콘텐츠 영역
메인 콘텐츠 영역에는 다음 요소가 순서대로 표시됩니다.
- 검색 및 옵션 바: 키워드 검색, 레벨 필터, 소스 필터, 정렬, 보기 방식, 표시 건수 설정
- 로그 메시지 패턴 추세 차트: 시간대별 로그 발생 추세를 시각화
- 로그 메시지 목록: 조건에 맞는 로그 결과 표시
주요 기능
검색 쿼리 입력
검색 기능을 사용하면 특정 키워드나 오류 메시지가 포함된 로그를 빠르게 찾을 수 있습니다.
- 화면 상단의 로그 필터링 입력 필드에 검색할 키워드 또는 오류 메시지를 입력합니다.
- 조회 버튼을 클릭하거나 Enter 키를 눌러 검색을 실행합니다.
- 입력한 키워드를 포함하는 로그 메시지만 목록에 표시됩니다.
- 입력 필드의 지우기(X) 버튼을 클릭하면 검색어를 초기화할 수 있습니다.
팁: 오류 코드, 예외 클래스명, 특정 사용자 ID 등 다양한 키워드로 검색할 수 있습니다.
필터 패널
로그 뷰어에서는 여러 종류의 필터를 조합하여 원하는 로그를 정밀하게 찾을 수 있습니다.
레벨 필터
레벨(Level) 필터 그룹에서 표시할 로그 레벨을 체크박스로 선택합니다. 여러 레벨을 동시에 선택할 수 있습니다.
| 레벨 | 설명 |
|---|---|
| ERROR | 오류가 발생한 로그 |
| WARN | 주의가 필요한 경고 로그 |
| INFO | 일반 정보 로그 |
| DEBUG | 디버그 목적의 상세 로그 |
| TRACE | 가장 상세한 수준의 추적 로그 |
| UNKNOWN | 레벨이 지정되지 않은 로그 |
팁: 기본적으로 ERROR, WARN, INFO 레벨이 선택되어 있습니다. 문제 상황을 조사할 때는 ERROR만 선택하면 오류 로그에 집중할 수 있습니다.
소스 필터
소스(Source) 필터 그룹에서 로그 수집 소스를 선택합니다.
- OTEL: OpenTelemetry SDK를 통해 전송된 로그
- 컨테이너(Container): 컨테이너 런타임에서 수집된 로그
기본적으로 두 소스가 모두 선택되어 있습니다.
속성 필터 패널 사용
좌측 속성 필터 패널에서는 로그에 포함된 다양한 속성을 기준으로 필터링할 수 있습니다.
- 좌측 패널 상단의 필터 속성 선택 섹션을 펼칩니다.
- 필터링에 사용할 속성을 선택합니다. 각 속성명 옆에 해당 속성의 고유값 수가 표시됩니다.
- 선택한 속성이 아래에 개별 섹션으로 표시됩니다.
- 각 속성 섹션에서 원하는 값을 클릭하여 필터를 적용합니다. 검색 필드를 사용하면 값 목록에서 빠르게 찾을 수 있습니다.
- 활성화된 필터가 있으면 속성명 옆에 선택된 값의 수가 배지로 표시됩니다.
팁: 패널 상단의 전체 해제 버튼을 클릭하면 모든 속성 필터를 한번에 초기화할 수 있습니다.
필터 패널 표시/숨기기
- 필터 패널 상단의 닫기 버튼을 클릭하면 패널이 접힙니다.
- 화면 좌측 가장자리에 표시되는 필터 아이콘을 클릭하면 패널이 다시 펼쳐집니다.
- 활성화된 필터가 있을 때는 접힌 필터 바에 시각적 표시가 나타납니다.
정렬 및 표시 옵션
- 정렬(Sort): 최신 순 또는 오래된 순으로 정렬합니다. 기본값은 최신 순입니다.
- 보기(View): 메시지 보기는 테이블 형식으로, Raw 보기는 로그 원본 텍스트 형식으로 표시합니다.
- 제한(Limit): 한 번에 표시할 최대 로그 수를 25 / 50 / 100 / 200 / 500 중에서 선택합니다.
로그 메시지 패턴 추세 차트
로그 목록 위에 선택된 시간 범위 내의 로그 메시지 패턴 추세가 차트로 표시됩니다. 시간대별 로그 발생량을 레벨별 색상으로 구분하여 보여주므로, 특정 시간대에 오류가 급증하는 패턴을 한눈에 파악할 수 있습니다.
차트 영역을 드래그하면 해당 시간 구간으로 확대하여 조회할 수 있습니다.
팁: 오류가 갑자기 증가한 시간대를 차트에서 확인하고, 해당 구간을 선택하여 원인 로그를 빠르게 찾을 수 있습니다.
로그 결과 읽기
로그 메시지 목록
로그 메시지 목록은 다음 컬럼으로 구성됩니다.
| 컬럼 | 설명 |
|---|---|
| 로그 시간 | 로그가 기록된 정확한 시각. 좌측에 레벨별 색상 마커가 표시됩니다 |
| 레벨 | 로그 심각도(Severity)의 첫 글 자 (E, W, I, D, T 등) |
| 소스 | 로그 수집 출처 (OTEL 또는 Container) |
| 애플리케이션 | 로그를 생성한 애플리케이션 이름과 네임스페이스 |
| 메시지 | 로그 내용. 긴 메시지는 잘려서 표시되며, 행을 클릭하면 상세 대화상자에서 전체 메시지를 확인할 수 있습니다 |
| 액션 | 복사 버튼 및 CogentAI 분석 버튼 |
통계 정보
목록 상단에는 다음 통계 정보가 표시됩니다.
| 항목 | 설명 |
|---|---|
| 표시 | 현재 화면에 표시된 로그 건수 |
| 필터됨 | 필터 조건에 맞는 전체 로그 건수 |
| 전체 | 조회 기간 내 전체 로그 건수 |
이 통계를 통해 현재 보고 있는 로그가 전체 로그 중 어느 정도의 비중인지 파악할 수 있습니다.
참고: 표시 건수가 설정한 제한 값과 같다면, 실제로 더 많은 로그가 존재할 수 있습니다. 이 경우 필터를 더 좁히거나 제한 값을 늘려 확인하세요.
로그 상세 확인
로그 목록에서 특정 행을 클릭하면 상세 정보 대화상자가 열립니다.
| 항목 | 설명 |
|---|---|
| 로그 시간 | 로그 발생 시각과 레벨 배지 |
| 메시지 | 전체 로그 내용. 펼치기/접기 버튼으로 긴 메시지를 확장하거나 축소할 수 있습니다 |
| 속성 상세 | 타임스탬프, 레벨, 애플리케이션, 네임스페이스 등 로그에 포함된 모든 속성 목록. 추가 메타데이터가 있는 경우 함께 표시됩니다 |
팁: JSON 형식의 로그 메시지는 자동으로 구문 강조(하이라이트)되어 표시됩니다.
로그 복사
로그 행 우측의 복사 버튼을 클릭하면 해당 로그 내용이 클립보드에 복사됩니다. 복사한 내용을 다른 도구에 붙여넣어 추가 분석에 활용할 수 있습니다.
CogentAI 로그 분석
CogentAI는 OPENMARU Observability에 통합된 AI 기반 분석 플랫폼입니다. CogentAI가 활성화된 환경에서는 두 가지 방법으로 로그에 대한 AI 분석을 수행할 수 있습니 다.
방법 1: 로그 목록에서 바로 분석
로그 메시지 테이블의 각 행 우측 액션 영역에 CogentAI 아이콘 버튼이 표시됩니다. 이 버튼을 클릭하면 해당 로그 메시지를 CogentAI에 전달하여 AI 분석을 요청합니다.
방법 2: 로그 상세 대화상자에서 분석
- 로그 목록에서 행을 클릭하여 상세 대화상자를 엽니다.
- 메시지 영역 아래에 있는 CogentAI 인사이트 버튼을 클릭합니다.
- 화면 우하단에 CogentAI 위젯이 열리며 해당 로그 메시지에 대한 AI 분석 결과가 표시됩니다.
팁: CogentAI 분석은 오류 로그의 원인을 빠르게 파악하거나, 복잡한 로그 메시지의 의미를 이해하는 데 유용합니다.
새로고침
새로고침 버튼을 클릭하면 현재 필터 조건을 유지한 채 최신 로그 데이터를 다시 조회합니다.
시간 범위 조정
화면 상단의 시간 범위 선택기에서 조회할 시간 범위를 변경하면 해당 기간의 로그가 표시됩니다. 특정 문제 발생 시점 전후의 로그를 좁혀서 분석할 때 유용합니다.
참고: 시간 범위가 넓을수록 조회되는 로그 양이 많아지며, 이 경우 제한 옵션을 활용하여 표시 건수를 조절하는 것이 좋습니다.
활용 예시
오류 로그 집중 분석
특정 시간대에 오류가 급증한 경우 다음 순서로 분석합니다.
- 로그 메시지 패턴 추세 차트에서 로그가 급증한 시간대를 확인합니다.
- 차트 영역을 드래그하여 해당 시간 구간으로 확대합니다.
- 레벨 필터에서 ERROR만 선택합니다.
- 오류 메시지를 확인하고, 필요시 키워드 검색으로 특정 오류 유형을 걸러냅니다.
- 로그 행을 클릭하여 상세 속성을 확인하거나, CogentAI 버튼을 클릭하여 AI 분석을 활용합니다.
특정 애플리케이션 로그 추적
특정 애플리케이션에서 발생한 로그만 추적하려면 다음과 같이 합니다.
- 상단 헤더의 애플리케이션 필터에서 대상 애플리케이 션을 선택합니다.
- 좌측 속성 필터 패널에서 필요한 속성(네임스페이스 등)을 추가로 지정합니다.
- 레벨 필터와 소스 필터를 조합하여 범위를 좁힙니다.
- 검색 필드에 관련 키워드를 입력하여 원하는 로그를 찾습니다.