5.3. 로그 뷰어
모든 애플리케이션의 로그를 통합 검색하고 다양한 필터로 분석합니다.
개요
로그 뷰어 화면에서는 모든 애플리케이션(Application)의 로그(Log)를 한곳에서 검색하고 조회할 수 있습니다. 로그(Log)는 애플리케이션에서 발생한 이벤트를 기록한 데이터입니다.
키워드 검색, 레벨 필터, 소스 필터, 속성 필터를 조합하여 원하는 로그를 빠르게 찾을 수 있으며, 로그 메시지 패턴 추세 차트를 통해 시간대별 로그 발생량 변화를 파악할 수 있습니다.
개별 애플리케이션 상세 페이지의 로그 탭과 달리, 여러 애플리케이션의 로그를 동시에 조회하거나 전체 애플리케이션에서 특정 오류 메시지를 검색할 때 유용합니다.
좌측 사이드바에서 로그 뷰어 메뉴를 클릭하면 진입할 수 있습니다.
로그 수집 소스
로그는 두 가지 소스에서 수집됩니다.
| 소스 | 설명 |
|---|---|
| OTEL | OpenTelemetry SDK를 통해 애플리케이션이 직접 전송하는 로그 |
| 컨테이너(Container) | 컨테이너 런타임에서 자동으로 수집되는 표준 출력/표준 에러 로그 |
화면 구성
로그 뷰어 화면은 크게 세 영역으로 구성됩니다.
| 영역 | 설명 |
|---|---|
| 상단 헤더 | 페이지 제목과 애플리케이션 필터 |
| 좌측 속성 필터 패널 | 로그 속성 기반 세부 필터 설정 |
| 메인 콘텐츠 영역 | 검색 바, 필터 컨트롤, 추세 차트, 로그 메시지 목록 |
상단 헤더
화면 상단에는 애플리케이션 필터가 있어 조회할 애플리케이션의 범위를 설정합니다. 네임스페이스(Namespace), 카테고리, 또는 애플리케이션 이름으로 조회 범위를 지정할 수 있습니다. 필터를 설정하지 않으면 모든 애플리케이션 로그가 조회됩니다.
좌측 속성 필터 패널
로그에 포함된 속성을 기준으로 세부 필터를 설정할 수 있습니다. 패널 상단의 닫기 버튼을 클릭하면 패널을 접어 로그 목록을 더 넓게 볼 수 있습니다.
패널에서 제공하는 기능은 다음과 같습니다.
- 필터 속성 선택: 사용할 필터 속성을 선택하거나 해제합니다. 각 속성 옆에 사용 가능한 값의 수가 표시됩 니다.
- 속성별 값 필터링: 선택한 속성에서 특정 값만 골라 필터링합니다. 각 속성 섹션 내 검색 필드로 값을 검색할 수 있습니다.
- 전체 선택/해제: 속성 단위 또는 전체 필터를 일괄 선택하거나 해제합니다.
참고: 필터 패널의 표시 상태는 브라우저에 저장되어 다음 접속 시에도 유지됩니다.
메인 콘텐츠 영역
메인 콘텐츠 영역에는 다음 요소가 순서대로 표시됩니다.
- 검색 및 옵션 바: 키워드 검색, 레벨 필터, 소스 필터, 정렬, 보기 방식, 표시 건수 설정
- 로그 메시지 패턴 추세 차트: 시간대별 로그 발생 추세를 시각화
- 로그 메시지 목록: 조건에 맞는 로그 결과 표시. 머리글에 불러온 메시지 필터 입력 필드와 통계 정보가 있음
주요 기능
검색 쿼리 입력
검색 기능을 사용하면 특정 키워드나 오류 메시지가 포함된 로그를 빠르게 찾을 수 있습니다.
- 화면 상단의 메시지 검색 (Enter 로 조회) 입력 필드에 검색할 키워드 또는 오류 메시지를 입력합니다.
- 조회 버튼을 클릭하거나 Enter 키를 눌러 검색을 실행합니다.
- 메시지에 키워드가 들어 있는 로그만 목록에 표시됩니다. 메시지 보기에서는 메시지 가운데 키워드와 일치하는 부분이 색으로 강조됩니다. Raw 보기는 강조하지 않습니다.
- 검색어를 지우려면 입력 필드의 지우기(X) 버튼을 클릭합니다. 검색어가 지워지고 목록을 다시 조회합니다.
참고: 검색어를 입력하는 동안에는 조회하지 않습니다. Enter 키, 조회 버튼, 지우기(X) 버튼을 사용할 때만 서버에서 로그를 다시 조회합니다. 상단 검색은 로그의 메시지만 검색합니다.
팁: 오류 코드, 예외 클래스명, 특정 사용자 ID 등 다양한 키워드로 검색할 수 있습니다.
불러온 메시지 필터
이미 불러온 로그 안에서 다시 찾으려면 로그 메시지 목록 머리글의 불러온 메시지 필터 입력 필드를 사용합니다. 이 필터는 서버에서 다시 조회하지 않습니다.
| 구분 | 메시지 검색 (상단) | 불러온 메시지 필터 |
|---|---|---|
| 검색 대상 | 조회 조건에 맞는 모든 로그의 메시지 | 이미 불러온 로그에서 화면에 보이는 모든 칸 (로그 시간, 레벨, 소스, 애플리케이션, 네임스페이스, 메시지) |
| 실행 시점 | Enter 키, 조회 버튼, 지우기(X) 버튼 | 입력하는 즉시 |
| 일치 부분 강조 | 메시지 칸 | 애플리케이션 칸(애플리케이션, 네임스페이스)과 메시지 칸 |
- 불러온 메시지 필터는 대소문자를 구분하지 않습니다.
- 두 검색어의 일치 부분은 서로 다른 색으로 강조됩니다.
- 상단 검색을 다시 실행해도 불러온 메시지 필터의 입력은 지워지지 않습니다.
- 메시지 보기에서 불러온 로그 중 필터와 일치하는 로그가 없으면 필터와 일치하는 메시지가 없습니다 안내와 필터 해제 버튼이 표시됩니다. 필터 해제 버튼을 클릭하면 필터 입력이 지워집니다.
팁: 두 검색을 이어서 쓰면 범위를 두 단계로 좁힐 수 있습니다. 예를 들어 상단 검색으로
error가 들어 있는 로그를 불러온 뒤, 불러온 메시지 필터에 애플리케이션 이름을 입력합니다.
필터 패널
로그 뷰어에서는 여러 종류의 필터를 조합하여 원하는 로그를 정밀하게 찾을 수 있습니다.
레벨 필터
레벨(Level) 필터 그룹에서 표시할 로그 레벨을 체크박스로 선택합니다. 여러 레벨을 동시에 선택할 수 있습니다.
| 레벨 | 설명 |
|---|---|
| ERROR | 오류가 발생한 로그 |
| WARN | 주의가 필요한 경고 로그 |
| INFO | 일반 정보 로그 |
| DEBUG | 디버그 목적의 상세 로그 |
| TRACE | 가장 상세한 수준의 추적 로그 |
| UNKNOWN | 레벨이 지정되지 않은 로그 |
팁: 기본적으로 ERROR, WARN, INFO 레벨이 선택되어 있습니다. 문제 상황을 조사할 때는 ERROR만 선택하면 오류 로그에 집중할 수 있습니다.
소스 필터
소스(Source) 필터 그룹에서 로그 수집 소스를 선택합니다.
- OTEL: OpenTelemetry SDK를 통해 전송된 로그
- 컨테이너(Container): 컨테이너 런타임에서 수집된 로그
기본적으로 두 소스가 모두 선택되어 있습니다.
속성 필터 패널 사용
좌측 속성 필터 패널에서는 로그에 포함된 다양한 속성을 기준으로 필터링할 수 있습니다.
- 좌측 패널 상단의 필터 속성 선택 섹션을 펼칩니다.
- 필터링에 사용할 속성을 선택합니다. 각 속성명 옆에 해당 속성의 고유값 수가 표시됩니다.
- 선택한 속성이 아래에 개별 섹션으로 표시됩니다.
- 각 속성 섹션에서 원하는 값을 클릭하여 필터를 적용합니다. 검색 필드를 사용하면 값 목록에서 빠르게 찾을 수 있습니다.
- 활성화된 필터가 있으면 속성명 옆에 선택된 값의 수가 배지로 표시됩니다.
팁: 패널 상단의 전체 해제 버튼을 클릭하면 모든 속성 필터를 한번에 초기화할 수 있습니다.
필터 패널 표시/숨기기
- 필터 패널 상단의 닫기 버튼을 클릭하면 패널이 접힙니다.
- 화면 좌측 가장자리에 표시되는 필터 아이콘을 클릭하면 패널이 다시 펼쳐집니다.
- 활성화된 필터가 있을 때는 접힌 필터 바에 시각적 표시가 나타납니다.
정렬 및 표시 옵션
- 정렬: 최신 순 또는 오래된 순으로 정렬합니다. 기본값은 최신 순입니다.
- 보기(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 분석을 활용합니다.
특정 애플리케이션 로그 추적
특정 애플리케이션에서 발생한 로그만 추적하려면 다음과 같이 합니다.
- 상단 헤더의 애플리케이션 필터에서 대상 애플리케이션을 선택합니다.
- 좌측 속성 필터 패널에서 필요한 속성(네임스페이스 등)을 추가로 지정합니다.
- 레벨 필터와 소스 필터를 조합하여 범위를 좁힙니다.
- 검색 필드에 관련 키워드를 입력하고 Enter 키를 눌러 원하는 로그를 찾습니다.