- 인쇄
- PDF
키바나
- 인쇄
- PDF
Classic/VPC 환경에서 이용 가능합니다.
키바나에서는 수집한 로그를 시각화하고, 대시보드를 구성하는 방법을 안내합니다.
디스커버
디스커버 메뉴를 통해 쿼리를 작성하여 시각화할 로그 데이터를 검색할 수 있습니다.
디스커버 화면
Web App의 키바나 > 디스커버 메뉴의 기본적인 설명은 다음과 같습니다.
영역 | 설명 |
---|---|
① 메뉴 | 대시보드의 주요 기능 메뉴
|
② 검색 | 루씬 쿼리를 입력하여 로그를 검색(Apache Lucene 참고)
|
③ 검색 기간 설정 | 로그를 검색할 시간 범위 설정
|
④ Update / Refresh | 설정한 검색 항목으로 로그 재검색 |
⑤ 필터 옵션 | 필터 추가 및 필터 옵션 설정 |
⑥ 필드 옵션 | 선택한 필드가 상세 로그 테이블의 열로 표시 |
⑦ 히스토그램/상세 로그 | 쿼리로 검색한 로그를 히스토그램과 상세 로그 목록으로 표시 |
쿼리 검색
Web App의 키바나 > 디스커버 메뉴에서 Effective Log Search & Analytics 2.0에 수집된 로그를 검색하는 방법은 다음과 같습니다.
- Web App에 접속해 주십시오.(Web App 접속 참고)
- 키바나 > 디스커버 메뉴를 클릭해 주십시오.
- 검색창에서 검색할 쿼리를 입력한 후 [Enter] 키를 누르거나 [Update] 버튼을 클릭해 주십시오.
- 검색 결과를 확인해 주십시오.
- 디스커버 메뉴 내 쿼리로 저장하려면 을 클릭하고 [Save current query] 버튼을 클릭한 다음, 쿼리 저장 팝업 창에서 쿼리 이름 및 옵션을 설정하여 저장해 주십시오.
- 이미 저장되어 있는 쿼리로 검색한 경우에는 해당 쿼리에 변경 사항을 저장하거나 새 이름으로 저장할 수 있습니다.
- 저장한 쿼리를 삭제하려면 해당 항목의 을 클릭한 후 삭제 확인 팝업 창에서 [Delete] 버튼을 클릭해 주십시오.
- 디스커버 메뉴 내 쿼리로 저장하려면 을 클릭하고 [Save current query] 버튼을 클릭한 다음, 쿼리 저장 팝업 창에서 쿼리 이름 및 옵션을 설정하여 저장해 주십시오.
쿼리 저장
검색한 쿼리를 저장하여 키바나 > 대시보드 또는 키바나 > 시각화 메뉴에서 새로운 위젯 추가 시 데이터 소스로 활용할 수 있습니다.
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: 현재 편집 상태 저장
- Group: 시스템 메뉴에서 설정한 기본 그룹(기본값: 미설정)
- 검색창에서 검색할 쿼리를 입력한 후 [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: 대시보드 복제 후 목록에 추가
- Group: 시스템 메뉴에서 설정한 기본 그룹(기본값: 미설정)
- 위젯 옵션
- 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: 시각화 페이지 공유
- Group: 시스템 메뉴에서 설정한 기본 그룹(기본값: 미설정)
- [Save] 버튼을 클릭해 주십시오.
- 시각화 저장 팝업 창이 나타나면 시각화의 제목과 설명을 입력해 주십시오.
- Title: 시각화 제목 입력
- Description: 시각화 설명 입력
- [Save] 버튼을 클릭해 주십시오.
- 시각화 항목이 저장되며 키바나 > 시각화 메뉴 또는 화면 좌측 상단에 표시된 경로의 Visualize를 클릭하면 추가된 시각화 목록으로 표시됩니다.
시각화 항목 확인
Web App의 키바나 > 시각화 메뉴에서 시각화 항목을 확인하는 방법은 다음과 같습니다.
- Web App에 접속해 주십시오.(Web App 접속 참고)
- 키바나 > 시각화 메뉴를 차례대로 클릭해 주십시오.
- 목록에서 확인할 시각화 항목의 제목을 클릭해 주십시오.
- 검색 기능을 활용해 대시보드를 검색할 수 있습니다.
- Title: 시각화 항목 생성 시 입력한 제목 표시
- Type: 시각화 항목 생성 시 선택한 시각화 유형 표시
- Description: 시각화 항목 생성 시 입력한 설명
- Actions: 을 클릭하면 시각화 항목 수정(시각화 항목 수정 참고)
- 시각화 항목을 확인해 주십시오.
시각화 항목 수정
Web App의 키바나 > 시각화 메뉴에서 시각화 항목을 수정하는 방법은 다음과 같습니다.
- Web App에 접속해 주십시오.(Web App 접속 참고)
- 키바나 > 시각화 메뉴를 차례대로 클릭해 주십시오.
- 목록에서 수정할 시각화 항목의 을 클릭해 주십시오.
- 검색 기능을 활용해 시각화 항목을 검색할 수 있습니다.
- 시각화 항목을 수정해 주십시오.
- 시각화 항목 수정에 대한 자세한 내용은 시각화 생성을 참고해 주십시오.
시각화 항목 삭제
Web App의 키바나 > 시각화 메뉴에서 생성한 시각화 항목을 삭제하는 방법은 다음과 같습니다.
시각화 항목 삭제 시 해당 항목에 저장된 모든 내용이 삭제되며 복구할 수 없습니다.
- Web App에 접속해 주십시오.(Web App 접속 참고)
- 키바나 > 시각화 메뉴를 차례대로 클릭해 주십시오.
- 목록에서 삭제할 시각화 항목을 선택해 주십시오.
- 검색 기능을 활용해 시각화 항목을 검색할 수 있습니다.
- [Delete n visualizations] 버튼을 클릭해 주십시오.
- 버튼 내 'n' 부분은 선택된 시각화 항목 개수가 숫자로 표시됩니다.
- 삭제 확인 팝업 창에서 [Delete] 버튼을 클릭해 주십시오.
- 시각화 항목이 삭제되어 목록에서 사라집니다.