로그 검색 및 시각화

Classic/VPC 환경에서 이용 가능합니다.

로그 검색

Effective Log Search & Analytics는 로그를 검색할 수 있는 별도의 Web App 화면을 제공합니다.

Web App 접속하기

1. 콘솔에 접속하여 Services > Management & Governance​ > Effective Log Search & Analytics 메뉴로 이동합니다.

2. Projects 메뉴를 선택한 후, 프로젝트 목록에서 로그를 확인할 프로젝트의 [Web-APP으로 이동하기] 버튼을 클릭합니다.

3. 새 창으로 Effective Log Search & Analytics Web App이 표시됩니다.

로그 검색 방법

Effective Log Search & Analytics Web App의 검색 메뉴 에서는 기본값으로 현재 시간 기준으로 24간 동안의 로그가 시간대별 로그 수집 개수 그래프와 상세 로그 형태로 표시됩니다.

① 쿼리 필드 검색 부분으로 Lucene Syntax를 사용하여 검색 조건을 정의할 수 있습니다.

② 검색 기간 설정을 설정할 수 있으며, 설정된 기간 동안 수집된 로그를 조회할 수 있습니다.

③ 로그 검색 결과를 막대그래프로 출력합니다. 가로축의 일시 사이에 수집된 로그의 개수가 표시됩니다. 막대를 클릭하여 해당 기간의 로그만 볼 수 있으며, 막대를 더블클릭하면 시간대별 로그를 더 상세하게 확인할 수 있습니다.

④ Effective Log Search & Analytics에서는 빠른 필터를 사용하여 로그를 쉽게 필터링할 수 있습니다.

• 빠른 필터는 각 항목에 해당하는 데이터를 가진 로그가 검색결과에 한 개 이상 있을 때에만 필터 항목에 나타납니다.
  • 예시) logLevel, logSource, projectVersion 값을 가진 로그만 있고 logType 값을 가진 로그가 현재 검색결과에 하나도 없는 경우, logType은 빠른 필터항목에 나오지 않음

⑤ 검색된 로그의 자세한 내용이 출력되는 부분입니다. 출력된 로그의 각 항목을 클릭하여 ①의 쿼리로 입력할 수 있습니다.

로그 시각화

Effective Log Search & Analytics는 로그를 시각화 하여 대시보드를 구성할 수 있는 기능을 제공합니다.
Effective Log Search & Analytics에는 Kibana가 내장되어 있으며, 이를 통해 원하는 Log Data를 Query하여 대시보드를 구성할 수 있습니다.

디스커버

Kibana > 디스커버 메뉴를 통해 Query를 작성하여 시각화 할 Log Data를 검색할 수 있습니다. 디스커버 메뉴를 통해 작성된 Query를 저장하여 대시보드 생성 시, 대시보드를 구성하는 개별 Widget에 포함될 Data 범위로 불러올 수 있습니다.

• Lucene Query를 작성하여 수집된 Log Data를 검색할 수 있습니다. Lucene Query 입력 및 기간 선택 후, [Refresh] 버튼 클릭 시, 해당 Query를 통해 검색된 Lo의 히스토그램과 상세 Log Data를 확인할 수 있습니다.

• 디스커버 메뉴에서는 검색된 Log Data를 테이블 형식으로 확인할 수도 있습니다. 왼쪽 사이드 메뉴에서 테이블에 추가할 필드를 선택하면 Log Data가 테이블 형식으로 표시되며, 선택한 필드가 테이블의 열로 표시됩니다.

• Log Data 확인 후, 상단의 [Save] 버튼을 클릭하여 현재 설정된 조건을 저장할 수 있습니다. 저장된 Query는 Kibana > 쿼리목록 메뉴를 통해 확인할 수 있으며, 대시보드 > 비주얼라이즈 생성 메뉴에서 새로운 Widget 추가 시 데이터 소스로 활용할 수 있습니다.

• [Inspect] 버튼을 클릭하여 현재 검색 결과에 대한 요약 정보와 요청 및 수신정보를 확인할 수 있습니다.

쿼리목록

Kibana > 쿼리목록 메뉴를 통해 디스커버 메뉴에서 저장한 쿼리의 목록을 확인할 수 있습니다.

• 쿼리목록 메뉴에서는 디스커버 메뉴에서 저장한 쿼리들의 목록을 확인하고, 이를 삭제하거나 수정할 수 있습니다.
• [검색 추가] 버튼을 클릭하여 새로운 쿼리를 작성할 수 있으며, 작성된 쿼리를 대시보드 > 비주얼라이즈 생성 메뉴에서 새로운 Widget 추가 시 데이터 소스로 활용할 수 있습니다.

비주얼라이즈 생성

대시보드 > 비주얼라이즈 생성 메뉴를 통해 Log Data를 선택하여 시각화할 수 있습니다.

• Area/Line Chart, Heat Map 등 다양한 방법의 시각화를 지원합니다.

• 시각화할 방법을 선택 후, 데이터 소스를 지정할 수 있습니다. Index Pattern 또는 디스커버 메뉴를 통해 저장한 쿼리목록을 선택하여 데이터 소스를 선택할 수 있습니다.

• Metric Aggregation, Bucket Aggregation을 통해 집계 방법 및 정렬 순서등을 지정하여 Log Data를 다양한 방식으로 시각화할 수 있습니다.

• Metric & axes 메뉴를 통해 각 축의 표시 방법, Label 표시 설정 및 위치 등을 지정할 수 있습니다.

• Panel settings 메뉴를 통해 해당 비주얼라이즈의 범례, 그리드의 표시 방법 등을 상세 설정할 수 있습니다.

• 원하는 방식으로 비주얼라이즈 구성 후, 상단의 [Save] 버튼을 클릭하여 화면상의 결과를 저장할 수 있습니다. 저장된 비주얼라이즈는 비주얼라이즈 관리 메뉴를 통해 목록으로 확인할 수 있으며, 언제든지 편집할 수 있습니다.

대시보드 구성

대시보드 > 새로만들기 메뉴를 통해 새로운 대시보드를 구성할 수 있습니다.

• [Create New] 버튼을 클릭하여 새루운 비주얼라이즈를 생성할 수 있습니다. 또는 [Add] 버튼을 클릭하여 기 생성한 비주얼라이즈를 대시보드에 추가할 수 있습니다.

• 대시보드를 통해 각 비쥬얼라이즈의 크기 및 위치를 자유롭게 수정할 수 있습니다.

• 대시보드의 구성이 완료되면 [Save] 버튼을 클릭하여 대시보드를 저장합니다. 저장된 대시보드는 대시보드 메뉴의 하위에 새로운 메뉴로 추가되며, 추가된 대시보드를 클릭하여 바로 확인할 수 있습니다.