키바나

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

키바나에서는 수집한 로그를 시각화하고, 대시보드를 구성하는 방법을 안내합니다.

디스커버

디스커버 메뉴를 통해 쿼리를 작성하여 시각화할 로그 데이터를 검색할 수 있습니다.

디스커버 화면

Web App의 키바나 > 디스커버 메뉴의 기본적인 설명은 다음과 같습니다.
elsa2-web-discover_screen_ko

영역	설명
① 메뉴	대시보드의 주요 기능 메뉴 Group: 시스템 메뉴에서 설정한 기본 그룹(기본값: 미설정) 항목을 클릭한 후 팝업 창의 [Manage Group] 버튼을 클릭하면 시스템 설정 화면에서 기본 그룹 설정 가능(시스템 설정 참고) New: 새 디스커버 열기(검색 초기화) Save: 쿼리로 저장 저장된 쿼리는 관리 > 저장된 검색에서 확인할 수 있으며, 키바나 > 대시보드 또는 키바나 > 시각화 메뉴에서 새로운 위젯 추가 시 데이터 소스로 활용 가능(저장된 검색 관리 및 대시보드 참고) Open: 저장된 쿼리(검색) 열기 Share: 검색 결과 페이지 공유 Inspect: 현재 검색 결과에 대한 요약 정보와 요청 및 수신 정보를 확인
② 검색	루씬 쿼리를 입력하여 로그를 검색(Apache Lucene 참고) : 디스커버 내 쿼리로 저장
③ 검색 기간 설정	로그를 검색할 시간 범위 설정 기존에 입력한 쿼리를 수정할 때만 [Update] 버튼 표시
④ Update / Refresh	설정한 검색 항목으로 로그 재검색
⑤ 필터 옵션	필터 추가 및 필터 옵션 설정
⑥ 필드 옵션	선택한 필드가 상세 로그 테이블의 열로 표시
⑦ 히스토그램/상세 로그	쿼리로 검색한 로그를 히스토그램과 상세 로그 목록으로 표시

쿼리 검색

Web App의 키바나 > 디스커버 메뉴에서 Effective Log Search & Analytics 2.0에 수집된 로그를 검색하는 방법은 다음과 같습니다.

Web App에 접속해 주십시오.(Web App 접속 참고)
키바나 > 디스커버 메뉴를 클릭해 주십시오.
검색창에서 검색할 쿼리를 입력한 후 [Enter] 키를 누르거나 [Update] 버튼을 클릭해 주십시오.
검색 결과를 확인해 주십시오.
- 디스커버 메뉴 내 쿼리로 저장하려면 을 클릭하고 [Save current query] 버튼을 클릭한 다음, 쿼리 저장 팝업 창에서 쿼리 이름 및 옵션을 설정하여 저장해 주십시오.
  - 이미 저장되어 있는 쿼리로 검색한 경우에는 해당 쿼리에 변경 사항을 저장하거나 새 이름으로 저장할 수 있습니다.
  - 저장한 쿼리를 삭제하려면 해당 항목의 을 클릭한 후 삭제 확인 팝업 창에서 [Delete] 버튼을 클릭해 주십시오.

쿼리 저장

검색한 쿼리를 저장하여 키바나 > 대시보드 또는 키바나 > 시각화 메뉴에서 새로운 위젯 추가 시 데이터 소스로 활용할 수 있습니다.
Web App의 키바나 > 디스커버 메뉴에서 쿼리를 저장하는 방법은 다음과 같습니다.

참고

디스커버 메뉴 내 쿼리로 저장하는 방법은 쿼리 검색을 참고해 주십시오.

Web App에 접속해 주십시오.(Web App 접속 참고)
키바나 > 디스커버 메뉴를 클릭해 주십시오.
검색창에서 쿼리를 입력한 후 [Enter] 키를 누르거나 [Update] 버튼을 클릭해 주십시오.
화면 상단의 Save를 클릭해 주십시오.
검색 저장 팝업 창에서 검색 제목을 입력한 후 [Save] 버튼을 클릭해 주십시오.
- 저장된 쿼리는 관리 > 저장된 검색에서 확인할 수 있습니다.(저장된 검색 참고)

대시보드

대시보드 메뉴에서는 수집한 로그를 기반으로 표, 그래프 등 시각화된 정보를 생성하고, 생성한 시각화를 활용하여 대시보드를 생성할 수 있습니다.

참고

대시보드 메뉴의 기능은 Kibana를 기반으로 제공됩니다. Kibana에 관한 자세한 내용은 Kibana Guide를 참고해 주십시오.

대시보드 생성

Web App의 키바나 > 대시보드 메뉴에서 대시보드를 생성하는 방법은 다음과 같습니다.

Web App에 접속해 주십시오.(Web App 접속 참고)
키바나 > 대시보드 메뉴를 차례대로 클릭해 주십시오.
[Create new dashboard] 버튼을 클릭해 주십시오.
Add를 클릭해 주십시오.
Add panels 화면에서 대시보드에 추가할 쿼리 목록 또는 시각화를 선택해 주십시오.
- 대시보드에 시각화 항목이 위젯 형태로 추가됩니다.
- [Create new] 버튼: 시각화 생성 화면으로 이동(시각화 생성 참고)
추가한 시각화 항목의 크기 조절, 위치 이동, 추가 옵션 등을 설정해 주십시오.
- 위젯 크기 조절: 위젯 오른쪽 하단의 모서리에 마우스 포인터를 올리면 특정 영역이 다른 색상으로 표시됩니다. 이때 마우스 왼쪽 버튼을 클릭한 상태로 마우스 포인터를 움직여 위젯 크기를 조절할 수 있습니다.
- 위젯 위치 이동: 위젯 상단에 마우스 포인터를 올리면 특정 영역이 다른 색상으로 표시됩니다. 이때 마우스 왼쪽 버튼을 클릭한 상태로 마우스 포인터를 움직여 위젯을 이동할 수 있습니다.
- 위젯 설정: 을 클릭해 해당 위젯을 설정할 수 있습니다.
  - Edit search: 위젯 편집
  - Clone panel: 위젯 복제 후 추가
  - Edit panel title: 위젯 제목 수정
  - Inspect: 해당 위젯의 검색 결과 정보
  - Maximize panel/Minimize: 위젯 크기 최대화/최소화
  - Replace panel: 위젯(시각화 항목) 교체
  - Delete from Dashboard: 추가한 위젯을 대시보드에서 삭제
- 상단 메뉴
  - Group: 시스템 메뉴에서 설정한 기본 그룹(기본값: 미설정)
    - 항목을 클릭한 후 팝업 창의 [Manage Group] 버튼을 클릭하면 시스템 설정 화면에서 기본 그룹 설정 가능(시스템 설정 참고)
  - Options: 추가 옵션 설정
    - Use margins between panels: 위젯과 위젯 사이 여백 여부 선택
    - Show panel title: 위젯에 시각화 항목명 표시 여부 선택
  - Share: 대시보드 페이지 공유
  - Add: 시각화 항목 추가
  - Cancel: 편집 취소
  - Save: 현재 편집 상태 저장
- 검색창에서 검색할 쿼리를 입력한 후 [Enter] 키를 누르거나 [Update] 버튼을 클릭해 로그를 검색할 수 있습니다.
  - 시각화 관련 로그 검색에 대한 자세한 내용은 쿼리 검색을 참고해 주십시오.
Save를 클릭해 주십시오.
시각화 저장 팝업 창이 나타나면 대시보드의 제목과 설명을 입력해 주십시오.
- Title: 대시보드 제목 입력
- Description: 대시보드 설명 입력
- Add to Dashboard after saving: 시각화 저장 후 대시보드 추가 여부 선택
[Save and return] 버튼을 클릭해 주십시오.
- 대시보드가 저장되며 키바나 > 대시보드 메뉴 또는 화면 좌측 상단에 표시된 경로의 Dashboard를 클릭하면 추가된 대시보드가 목록으로 표시됩니다.

대시보드 확인

Web App의 키바나 > 대시보드 메뉴에서 대시보드를 확인하는 방법은 다음과 같습니다.

Web App에 접속해 주십시오.(Web App 접속 참고)
키바나 > 대시보드 메뉴를 차례대로 클릭해 주십시오.
목록에서 확인할 대시보드의 제목을 클릭해 주십시오.
- 검색 기능을 활용해 대시보드를 검색할 수 있습니다.
- Title: 대시보드 생성 시 입력한 제목 표시
- Description: 대시보드 생성 시 입력한 설명 표시
- Actions: 을 클릭하면 대시보드 수정 화면으로 이동(대시보드 수정 참고)
대시보드를 확인해 주십시오.
- 상단 메뉴
  - Group: 시스템 메뉴에서 설정한 기본 그룹(기본값: 미설정)
    - 항목을 클릭한 후 팝업 창의 [Manage Group] 버튼을 클릭하면 시스템 설정 화면에서 기본 그룹 설정 가능(시스템 설정 참고)
  - Full Screen: 대시보드를 전체화면으로 표시
    - 기본 화면으로 되돌리려면 화면 하단의 [Exit full screen] 버튼 클릭
  - Share: 대시보드 페이지 공유
  - Clone: 대시보드 복제 후 목록에 추가
- 위젯 옵션
  - Inspect: 해당 위젯의 검색 결과 정보
  - Maximize panel/Minimize: 위젯 크기 최대화/최소화
- 검색창에서 검색할 쿼리를 입력한 후 [Enter] 키를 누르거나 [Update] 버튼을 클릭해 로그를 검색할 수 있습니다.
  - 시각화 관련 로그 검색에 대한 자세한 내용은 쿼리 검색을 참고해 주십시오.

대시보드 수정

Web App의 키바나 > 대시보드 메뉴에서 대시보드를 수정하는 방법은 다음과 같습니다.

Web App에 접속해 주십시오.(Web App 접속 참고)
키바나 > 대시보드 메뉴를 차례대로 클릭해 주십시오.
목록에서 수정할 대시보드의 을 클릭해 주십시오.
- 또는 대시보드 제목을 클릭한 후 대시보드 화면에서 [Edit] 버튼을 클릭해 주십시오.
- 검색 기능을 활용해 대시보드를 검색할 수 있습니다.
대시보드를 수정해 주십시오.
- 대시보드 수정 항목에 대한 자세한 내용은 대시보드 생성을 참고해 주십시오.

대시보드 삭제

Web App의 키바나 > 대시보드 메뉴에서 생성한 대시보드를 삭제하는 방법은 다음과 같습니다.

주의

대시보드 삭제 시 대시보드에 저장된 모든 내용이 삭제되며 복구할 수 없습니다.

Web App에 접속해 주십시오.(Web App 접속 참고)
키바나 > 대시보드 메뉴를 차례대로 클릭해 주십시오.
목록에서 삭제할 대시보드를 선택해 주십시오.
- 검색 기능을 활용해 대시보드를 검색할 수 있습니다.
[Delete n dashboard] 버튼을 클릭해 주십시오.
- 버튼 내 'n' 부분은 선택된 대시보드 개수가 숫자로 표시됩니다.
삭제 확인 팝업 창에서 [Delete] 버튼을 클릭해 주십시오.
- 대시보드가 삭제되어 목록에서 사라집니다.

시각화

키바나 > 시각화 메뉴를 통해 로그 데이터를 선택하여 시각화할 수 있습니다.

시각화 생성

Web App의 키바나 > 대시보드 메뉴에서 시각화 항목을 생성하는 방법은 다음과 같습니다.

Web App에 접속해 주십시오.(Web App 접속 참고)
키바나 > 시각화 메뉴를 차례대로 클릭해 주십시오.
[Create new visualization] 버튼을 클릭해 주십시오.
신규 추가 팝업 창에서 원하는 시각화 유형을 클릭해 주십시오.
목록에서 시각화할 데이터를 선택해 주십시오.
- 쿼리 저장을 통해 저장한 쿼리가 표시됩니다.
- *:log-*: 기본으로 제공되는 데이터 소스로, 전체 로그 데이터
생성 화면에서 옵션을 설정해 데이터를 시각화해 주십시오.
- 시각화 유형에 따라 다르게 표시될 수 있습니다.
- 상단 메뉴
  - Group: 시스템 메뉴에서 설정한 기본 그룹(기본값: 미설정)
    - 항목을 클릭한 후 팝업 창의 [Manage Group] 버튼을 클릭하면 시스템 설정 화면에서 기본 그룹 설정 가능(시스템 설정 참고)
  - Inspect: 해당 시각화 항목의 검색 결과 정보
  - Share: 시각화 페이지 공유
[Save] 버튼을 클릭해 주십시오.
시각화 저장 팝업 창이 나타나면 시각화의 제목과 설명을 입력해 주십시오.
- Title: 시각화 제목 입력
- Description: 시각화 설명 입력
[Save] 버튼을 클릭해 주십시오.
- 시각화 항목이 저장되며 키바나 > 시각화 메뉴 또는 화면 좌측 상단에 표시된 경로의 Visualize를 클릭하면 추가된 시각화 목록으로 표시됩니다.

시각화 항목 확인

Web App의 키바나 > 시각화 메뉴에서 시각화 항목을 확인하는 방법은 다음과 같습니다.

Web App에 접속해 주십시오.(Web App 접속 참고)
키바나 > 시각화 메뉴를 차례대로 클릭해 주십시오.
목록에서 확인할 시각화 항목의 제목을 클릭해 주십시오.
- 검색 기능을 활용해 대시보드를 검색할 수 있습니다.
- Title: 시각화 항목 생성 시 입력한 제목 표시
- Type: 시각화 항목 생성 시 선택한 시각화 유형 표시
- Description: 시각화 항목 생성 시 입력한 설명
- Actions: 을 클릭하면 시각화 항목 수정(시각화 항목 수정 참고)
시각화 항목을 확인해 주십시오.
- 상단 메뉴
  - Group: 시스템 메뉴에서 설정한 기본 그룹(기본값: 미설정)
    - 항목을 클릭한 후 팝업 창의 [Manage Group] 버튼을 클릭하면 시스템 설정 화면에서 기본 그룹 설정 가능(시스템 설정 참고)
  - Inspect: 해당 시각화 항목의 검색 결과 정보
  - Share: 시각화 페이지 공유
- 검색창에서 검색할 쿼리를 입력한 후 [Enter] 키를 누르거나 [Update] 버튼을 클릭해 로그를 검색할 수 있습니다.
  - 시각화 관련 로그 검색에 대한 자세한 내용은 쿼리 검색을 참고해 주십시오.

시각화 항목 수정

Web App의 키바나 > 시각화 메뉴에서 시각화 항목을 수정하는 방법은 다음과 같습니다.

Web App에 접속해 주십시오.(Web App 접속 참고)
키바나 > 시각화 메뉴를 차례대로 클릭해 주십시오.
목록에서 수정할 시각화 항목의 을 클릭해 주십시오.
- 검색 기능을 활용해 시각화 항목을 검색할 수 있습니다.
시각화 항목을 수정해 주십시오.
- 시각화 항목 수정에 대한 자세한 내용은 시각화 생성을 참고해 주십시오.

시각화 항목 삭제

Web App의 키바나 > 시각화 메뉴에서 생성한 시각화 항목을 삭제하는 방법은 다음과 같습니다.

주의

시각화 항목 삭제 시 해당 항목에 저장된 모든 내용이 삭제되며 복구할 수 없습니다.

Web App에 접속해 주십시오.(Web App 접속 참고)
키바나 > 시각화 메뉴를 차례대로 클릭해 주십시오.
목록에서 삭제할 시각화 항목을 선택해 주십시오.
- 검색 기능을 활용해 시각화 항목을 검색할 수 있습니다.
[Delete n visualizations] 버튼을 클릭해 주십시오.
- 버튼 내 'n' 부분은 선택된 시각화 항목 개수가 숫자로 표시됩니다.
삭제 확인 팝업 창에서 [Delete] 버튼을 클릭해 주십시오.
- 시각화 항목이 삭제되어 목록에서 사라집니다.