대시보드

개요

대시보드는 분석 결과를 시각화하여 실시간으로 모니터링할 수 있는 기능을 제공합니다. 일반적으로 앱을 설치하면 해당 앱이 제공하는 대시보드가 자동으로 추가되며, 사용자가 직접 대시보드를 생성하여 원하는 주제에 따라 위젯을 구성할 수도 있습니다.

대시보드를 사용하려면 다음 권한이 필요합니다.

대시보드 편집: 대시보드를 생성하거나 편집합니다.
대시보드 관리: 대시보드를 게시합니다. 관리자 계정은 별도 권한 없이 사용할 수 있습니다.

대시보드 목록 조회/검색

대시보드에서 대시보드 목록을 조회하거나 검색할 수 있습니다. 대시보드 목록은 카드 뷰와 목록 뷰 두 가지 모드로 조회할 수 있습니다. 목록 상단의 / 버튼을 클릭하여 두 모드를 전환합니다. 선택한 뷰 모드는 계정 설정에 저장되어 다음에 접속할 때도 유지됩니다.

등록된 대시보드가 없는 경우 환영 화면이 표시되며, 이 화면에서 바로 새 대시보드를 생성할 수 있습니다.

카드 뷰

대시보드를 썸네일 카드 형태로 표시합니다. 각 카드에는 대시보드 이름과 썸네일 이미지가 표시되며, 무한 스크롤 방식으로 페이지를 전환합니다. 항목이 선택되지 않은 경우 각 카드에 개별 삭제 버튼이 표시됩니다.

목록 뷰

대시보드를 목록 형태로 표시합니다. 목록에는 다음 항목이 표시됩니다.

이름: 대시보드 이름. 클릭하면 해당 대시보드를 조회합니다.
탭: 대시보드에 포함된 탭 목록 (최대 3개까지 표시)
공유: 대시보드가 공유된 계정 및 그룹
소유자: 대시보드 소유자
수정일: 마지막 수정 날짜 (yyyy-MM-dd HH:mm 형식)

특정 대시보드를 찾으려면 목록 상단의 검색 입력창에 이름을 입력하세요. 입력한 단어가 이름 항목에 포함된 대시보드를 찾아서 보여줍니다.

목록 새로 고침

대시보드 목록을 최신 정보로 조회하려면 을 클릭하세요.

대시보드 열기

대시보드를 열려면, 카드 뷰에서 대시보드 카드를 클릭하거나 목록 뷰에서 이름 열의 대시보드 이름을 클릭하세요.

구성 요소

하나의 대시보드는 여러 개의 탭과 위젯으로 구성되고, 위젯을 임의의 크기로 원하는 위치에 배치할 수 있도록 도킹 레이아웃 기능을 제공합니다. 위젯을 한 번 만들어두면 여러 번 재사용 가능하며, 위젯 속성 변경 시 일괄적으로 모든 대시보드에 반영됩니다.

탭 전환: 탭 제목을 클릭하면 해당 탭으로 전환됩니다.
: 버튼을 클릭하면 대시보드를 관리할 수 있는 메뉴가 나타납니다. 자세한 설명은 관리 메뉴를 참고하세요.
필터: 버튼을 클릭하면 대시보드 전역 또는 동일한 데이터셋을 사용하는 위젯에 필터를 지정할 수 있는 패널이 나타납니다. 자세한 설명은 필터 관리를 참고하세요.
모두 초기화: 적용된 모든 필터와 사용자 정의 변수 값을 초기화합니다. 배지에 현재 활성화된 필터 및 설정된 사용자 정의 변수의 수가 표시됩니다. 필터 패널이 열려 있으면 이 버튼은 숨겨집니다.
위젯 메뉴: 각 위젯의 메뉴 버튼(⋮)을 클릭하면 위젯 정보, 새로 고침, 일시 정지, 쿼리 결과 보기, 확대 등을 수행할 수 있습니다. 자세한 설명은 위젯과 컨테이너를 참고하세요.

대시보드 추가

대시보드를 추가하려면,

화면 우측 상단에서 추가를 클릭하세요.
새 대시보드 대화상자에서 이름을 입력하고 확인을 클릭하세요 (최대 50자).

생성된 대시보드는 빈 탭 하나와 함께 열립니다. 탭 편집 모드에서 위젯을 추가하여 대시보드를 구성하세요.

대시보드 관리

대시보드를 열면 탭 영역 오른쪽 상단에 버튼이 표시됩니다. 이 버튼을 클릭하면 팝오버 메뉴가 표시됩니다. 각 메뉴를 클릭하여 대시보드를 관리할 수 있습니다.

관리 메뉴

팝오버 메뉴에서 사용할 수 있는 관리 기능은 다음과 같습니다.

편집모드 전환

대시보드에 위젯이나 컨테이너를 추가, 삭제하거나 위젯의 크기, 위치를 변경할 수 있는 모드로 전환합니다. 자세한 설명은 탭 편집을 참고하세요.

위젯 관리

위젯을 생성, 편집, 삭제할 수 있는 관리 화면으로 이동합니다. 자세한 내용은 위젯을 참고하세요.

썸네일 이미지 등록

대시보드 카드 뷰에 표시되는 썸네일 이미지를 설정합니다. 이미지 파일(jpg, jpeg, png)을 업로드하거나 클립보드에서 이미지를 붙여넣을 수 있습니다. 이미지 파일의 최대 크기는 1MB입니다. 기존 썸네일이 있는 경우 기본값으로 되돌릴 수 있습니다.

대시보드 공유

계정 및 그룹을 선택하여 대시보드를 공유할 수 있습니다. 공유 대상에게 읽기 또는 쓰기 권한을 부여할 수 있습니다. 쓰기 권한을 부여하면 공유받은 대시보드를 편집하거나 삭제할 수 있습니다.

공유 대상을 선택하고 저장하면 대시보드에서 사용 중인 위젯과 데이터소스에 대한 공유 여부를 검사합니다. 대시보드에 대한 접근 권한만 있고 위젯이나 데이터소스에 대한 권한이 없다면 위젯이 정상적으로 표시되지 않기 때문에 공유받는 계정의 위젯과 데이터소스에 대한 권한이 없는 항목의 목록을 제공합니다.

대시보드 게시

대시보드를 읽기 전용으로 외부에 게시합니다. 이 메뉴는 대시보드 관리 권한이 있는 관리자에게만 표시됩니다.

대시보드를 게시하려면 다음 절차를 따릅니다.

계정 드롭다운에서 대시보드 뷰어 역할을 가진 계정을 선택합니다. 계정은 이름/로그인 형식으로 표시됩니다.
선택한 계정에 API 키가 없으면 경고가 표시됩니다. API 키 생성을 클릭하여 해당 계정의 API 키를 생성합니다.
"대시보드를 게시할 수 있는 계정입니다." 메시지가 표시되면 다음을 클릭하세요. 대시보드가 해당 계정과 공유되고 접근 URL이 생성됩니다.
생성된 URL을 클립보드에 복사를 클릭하여 복사합니다.
대시보드에서 사용 중인 일부 위젯이나 데이터소스에 대한 접근 권한이 없는 경우 경고가 표시됩니다. 승인을 클릭하면 해당 리소스에도 접근 권한을 부여합니다.

대시보드 이름 변경

대시보드의 이름을 변경합니다 (최대 50자).

새 탭

대시보드에 탭을 추가합니다. 탭의 이름을 입력하고 확인을 클릭하세요 (최대 255자).

탭 설정

대시보드 탭의 이름과 순서를 변경하거나 탭을 삭제합니다. 드래그 앤 드롭으로 탭의 순서를 변경할 수 있습니다. 탭이 하나만 남은 경우에는 해당 탭을 삭제하거나 순서를 변경할 수 없습니다. 수정을 마친 후에는 확인 버튼을 눌러 수정사항을 저장합니다.

전체 화면 표시

소나의 상단 메뉴를 제거하여 대시보드를 전체 화면으로 표시합니다. 전체 화면 상태에서 다시 클릭하면 전체 화면 끄기로 표시되며 원래 화면으로 돌아옵니다.

/ 위젯 제목 숨김/표시

위젯의 제목 표시 여부를 전환합니다. 제목이 표시된 상태에서는 위젯 제목 숨김, 숨겨진 상태에서는 위젯 제목 표시로 메뉴 항목이 표시됩니다. 컨테이너의 제목은 이 옵션과 관계없이 항상 표시됩니다. 위젯 제목의 기본 상태는 표시입니다.

/ 위젯 메뉴 숨김/표시

각 위젯의 메뉴 버튼(⋮) 표시 여부를 전환합니다. 메뉴 버튼이 표시된 상태에서는 위젯 메뉴 숨김, 숨겨진 상태에서는 위젯 메뉴 표시로 메뉴 항목이 표시됩니다. 위젯 메뉴의 기본 상태는 표시이지만, 컨테이너의 메뉴 버튼은 이 옵션과 관계없이 항상 표시됩니다.

탭 편집

버튼을 클릭한 다음 팝오버 메뉴에서 편집모드 전환을 클릭하면 다음 그림과 같이 대시보드가 위젯과 컨테이너를 추가, 삭제하거나 위젯의 크기, 위치를 변경할 수 있는 상태로 진입합니다.

위젯: 위젯 버튼을 클릭하면 대시보드에 위젯을 추가합니다. 위젯 목록에서 추가할 위젯을 선택하고, 배치할 방향(상/하/좌/우)을 지정하세요.
컨테이너: 컨테이너 버튼을 클릭하면 서로 다른 위젯을 묶어 하나의 위젯처럼 사용할 수 있는 컨테이너를 추가합니다. 컨테이너 이름을 입력하고 배치할 방향(상/하/좌/우)을 지정하세요.
위젯 재배치: 위젯 위쪽에 표시되는 핸들을 드래그 앤 드롭하는 방식으로 위젯이나 대시보드의 상하좌우 또는 컨테이너 내부로 위젯을 이동시킬 수 있습니다. 드래그 중에는 방향 표시기가 나타나 배치할 위치를 안내합니다.
스플리터 조정: 탭 화면에서 위젯 사이의 점선을 드래그하여 위젯의 크기를 조정할 수 있습니다.
저장: 편집 버튼을 클릭하면 편집한 내용을 저장하고 편집 모드를 종료합니다.
취소: 취소 버튼을 클릭하면 편집한 내용을 저장하지 않고 편집 모드를 종료합니다.

위젯과 컨테이너

위젯의 종류로는 쿼리 위젯, 외부 사이트 위젯, 입력 컨트롤이 있고, 컨테이너는 서로 다른 위젯을 하나의 위젯처럼 묶어서 사용할 수 있는 기능입니다.

쿼리 위젯

쿼리 위젯은 수집한 로그를 시각화하여 보안관제 담당자가 대시보드에서 이상 지표를 즉시 파악할 수 있도록 합니다. 차트나 그리드에서 특정 값·구간을 클릭·드래그하면 다른 위젯에 필터를 전달하거나 연관 쿼리를 실행할 수 있어, 여러 위젯이 연동되는 인터랙티브 대시보드를 구성할 수 있습니다. 자세한 설명은 쿼리 위젯을 참고하세요.

외부 사이트 위젯

외부 사이트 위젯은 URL을 이용하여 외부 웹페이지를 표시하는 위젯입니다. 자세한 설명은 외부 사이트 위젯를 참고하세요.

입력 컨트롤

입력 컨트롤은 사용자의 입력을 받아 동적 필터를 적용하는 위젯입니다. 입력 방식에 따라 날짜, 목록, 텍스트 입력 컨트롤로 설정할 수 있습니다. 입력 컨트롤에 대한 설명은 입력 컨트롤, 동적 필터 적용에 대한 설명은 동적 필터를 참고하세요.

컨테이너

컨테이너는 서로 다른 위젯을 하나의 위젯처럼 사용할 수 있는 기능입니다. 대시보드 편집 모드에서 컨테이너를 추가하고 컨테이너 내부에 원하는 위젯을 위치시켜 사용할 수 있습니다. 여러 위젯의 위치 이동, 크기 변경, 확대, 삭제 동작을 컨테이너 하나를 조작하는 것으로 손쉽게 할 수 있습니다.

컨테이너의 메뉴 버튼(⋮)을 클릭하면 컨테이너를 전체 화면으로 확대하거나 원래 크기로 축소할 수 있습니다. 편집 모드에서는 컨테이너 이름을 변경하거나 컨테이너를 삭제할 수 있습니다.

필터 관리

필터를 지정하면 위젯의 쿼리에 조건 명령어가 자동으로 추가되어 해당 조건에 맞는 데이터만 표시됩니다. 필터 범위에 따라 세 가지로 구분됩니다.

시간 필터: 모든 위젯의 쿼리 앞에 set $_from=<시작 시각>, set $_to=<종료 시각> 명령어를 삽입합니다. 시간 범위를 제한하는 데 사용합니다.
전역 필터: 모든 위젯의 쿼리에 search <조건식> 명령어를 삽입합니다.
데이터셋 필터: 동일한 데이터셋을 기반으로 생성된 위젯에만 search <조건식> 명령어를 삽입합니다.

대시보드 우측 상단의 필터 버튼을 클릭하면 필터를 추가, 삭제, 활성화/비활성화할 수 있는 패널이 나타납니다.

필터 패널

필터 패널은 사용자 정의 변수, 대시보드 필터, 데이터셋 필터 세 개의 섹션으로 구성됩니다.

사용자 정의 변수

현재 설정된 사용자 정의 변수의 이름과 값을 표시합니다. 입력 컨트롤에 값을 입력하면 이 목록에 반영됩니다. 각 변수 행의 삭제 버튼을 클릭하면 해당 변수의 값을 초기화합니다.

대시보드 필터

시간 필터와 전역 필터 두 개의 항목으로 구성됩니다. 각 필터 항목에는 활성화/비활성화 토글과 삭제 버튼이 있습니다. 직접 추가한 필터는 편집 버튼으로 조건식을 수정할 수 있으며, 위젯 이벤트로 추가된 필터는 편집이 불가합니다.

시간 필터

빠른 선택 버튼이나 날짜 직접 입력으로 조회 시간 범위를 지정합니다. 빠른 선택에서 원하는 기간을 선택하거나, 사용자 정의를 눌러 시작/종료 날짜를 직접 입력합니다. 숨김 버튼을 클릭하면 시간 필터 영역을 최소화합니다.

전역 필터

모든 위젯에 적용되는 search 조건식 목록입니다. ⋯ 버튼을 클릭하면 다음 작업을 수행할 수 있습니다.

필터 추가: 새 필터 조건식을 추가합니다.
필터 목록 숨김 / 필터 목록 표시: 필터 목록 영역을 접거나 펼칩니다.
전체 필터 비활성화 / 전체 필터 활성화: 전역 필터 전체를 한 번에 끄거나 켭니다.
전체 필터 삭제: 전역 필터 전체를 삭제합니다.

데이터셋 필터

특정 데이터셋을 기반으로 생성된 위젯에만 적용되는 필터 목록입니다. 데이터셋이 여러 개인 경우 검색 입력창으로 원하는 데이터셋을 찾을 수 있습니다. 각 데이터셋 필터는 전역 필터와 동일한 방식으로 관리합니다.

패널 상단의 모두 초기화 버튼을 클릭하면 모든 필터와 사용자 정의 변수 값이 초기화됩니다.

필터 추가

필터는 다음 두 가지 방법으로 추가할 수 있습니다.

방법 1 — 위젯 이벤트 동작

필터 이벤트가 설정된 위젯에서 클릭이나 드래그 이벤트가 발생하면 지정한 조건식으로 필터가 자동으로 추가됩니다. 위젯 이벤트 설정은 쿼리 위젯의 이벤트 항목을 참고하세요.

방법 2 — 직접 추가

필터 패널에서 전역 필터 또는 데이터셋 필터의 ⋯ 버튼을 클릭한 다음 필터 항목 추가를 클릭합니다.

필터 유형은 다음 세 가지 중에서 선택합니다.

단일 값 (비교 필터): 대상 필드, 데이터 유형, 조건(같음/다름/포함 등), 비교 값을 지정합니다. 지정한 내용은 search <필드> <연산자> <값> 형태의 명령어로 변환됩니다.
범위 값 (범위 필터): 대상 필드, 데이터 유형, 최솟값, 최댓값을 지정합니다. search <필드> >= <최솟값> and <필드> <= <최댓값> 형태의 명령어로 변환됩니다.
사용자 정의 (쿼리 필터): 로그프레소 쿼리 명령어를 직접 입력합니다. 입력한 쿼리가 그대로 위젯 쿼리에 삽입됩니다.

동적 필터

동적 필터는 사용자 정의 변수와 입력 컨트롤을 조합하여 필터 조건을 실시간으로 변경하는 기능입니다. 필터가 활성화될 때 변수 값이 set <변수명> = <값> 명령어로 쿼리에 주입됩니다.

설정 방법

변수 추가를 참고하여 사용자 정의 변수를 생성하세요.
위젯의 입력 필터에서 생성한 변수를 값 변수로 지정하여 동적 필터를 추가하세요.
해당 변수를 매개변수로 사용하는 입력 컨트롤을 생성하세요.
대시보드에 동적 필터가 적용된 위젯과 입력 컨트롤을 함께 배치하세요.
입력 컨트롤에 값을 입력하면 사용자 정의 변수에 할당됩니다.
동적 필터를 적용하세요.

대시보드 삭제

대시보드를 삭제하려면,

대시보드 목록에서 삭제할 대시보드 행의 체크박스를 선택하세요.
삭제를 클릭하세요.
대시보드 삭제 대화상자에서 삭제할 대시보드 목록을 확인한 후 삭제를 클릭하세요.

카드 뷰에서는 항목이 선택되지 않은 경우 각 카드에 표시되는 삭제 버튼을 클릭하여 개별 대시보드를 삭제할 수 있습니다.