exemONE Dashboard

1. 개요

메뉴 경로: Dashboard

exemONE Dashboard는 사용자가 직접 위젯을 구성하여 모니터링 대시보드를 생성·관리하는 기능입니다. 기본 제공 대시보드(Featured Dashboard)와 사용자가 직접 만드는 커스텀 대시보드(Custom Dashboard)를 모두 지원합니다.

대시보드 유형:

유형	설명
Custom Dashboard	사용자가 위젯을 직접 구성하여 생성하는 대시보드
exemONE Featured Dashboard	exemONE에서 기본 제공하는 대시보드

2. 대시보드 목록

2-1. 커스텀 대시보드 목록 (Custom Dashboard List)

메뉴 경로: Dashboard > Dashboard List > Custom Dashboard

그룹에서 선택된 대시보드 목록을 보여주는 화면입니다.

순번	항목	설명
1	Search by	대시보드 검색 조건을 선택합니다. (OR / AND). 대시보드 이름을 검색합니다.
2	Move/Share/Delete Dashboard	대시보드 선택 시 활성화됩니다. Move Dashboard Group: 대시보드를 이동할 그룹으로 이동 / Share Dashboard: 사용자에게 공유 / Delete: 삭제
3	Dashboard List Option	Export to Excel / Reset user data / Import Dashboard (.json) / Import Viewpack (.json) / Column List
4	Checkbox	체크박스 선택 시 이동·공유·삭제 버튼 활성화
5	Name	Favorite 설정/해제(★/☆) / Dashboard Menu / Analysis Board Menu / Start Screen / Sharing 여부 표시. 이름 선택 시 대시보드 화면으로 이동
6	Dashboard Group	대시보드가 속한 그룹명 ('All' 그룹 선택 시만 표시)
7	Dashboard by Menu	대시보드 메뉴로 설정된 화면 표시
8	Analysis Board by Menu	분석 메뉴로 설정된 화면 표시
9	Dashboard Option	마우스 오버 시 메뉴 아이콘 표시. 아래 세부 옵션 참고

Dashboard Option 상세:

옵션	설명
Set as Start Screen	선택한 대시보드를 시작화면으로 설정합니다.
Set Report	대시보드가 리포트로 설정됩니다.
Set Favorite Dashboard	즐겨찾기로 설정합니다.
Share dashboard	대시보드 공유 팝업창이 열립니다.
Export Dashboard	대시보드를 json 파일로 추출합니다.
Set up dashboard by menu	대시보드를 메뉴로 설정합니다.
Set up analysis board by menu	대시보드를 분석 메뉴로 설정합니다.
Duplicate Dashboard	대시보드 복제 팝업창이 열립니다.
Edit Name	대시보드 이름 편집 팝업창이 열립니다.
Edit Dashboard	대시보드 편집 화면으로 이동합니다.
Move Dashboard Group	대시보드 그룹을 이동합니다.
Delete	대시보드를 삭제합니다.

2-2. 기본 제공 대시보드 (exemONE Featured Dashboard)

메뉴 경로: Dashboard > Dashboard List > exemONE Featured Dashboard

exemONE에서 기본 제공하는 대시보드 목록 화면입니다.

순번	항목	설명
1	Filter	대시보드 유형과 플랫폼별로 목록을 필터링합니다.
2	Hide	대시보드 체크 후 [Hide] 버튼을 통해 숨겨진 대시보드 목록을 출력합니다.
3	Search	대시보드 이름 또는 설명을 검색합니다.
4	Change View	목록 뷰 / 카드 뷰를 제공합니다. 목록 뷰 선택 시 우측에 대시보드 미리보기가 제공됩니다.
5	List	기본 제공 대시보드 목록을 제공합니다.

2-3. 대시보드 목록 추가 기능 (Dashboard List)

메뉴 경로: Dashboard > Dashboard List

사용자 대시보드 목록 화면입니다.

순번	항목	설명
1	Add Dashboard	대시보드 설정(Dashboard Setting) 팝업창이 열립니다. 대시보드 그룹 선택 / 이름(Name) / 설명(Description) 입력
2	Add Group	대시보드 그룹 이름 입력 칸이 생성됩니다. 그룹 이름 입력 후 엔터 또는 입력창 외 화면 클릭 시 자동 저장됩니다.

3. 커스텀 대시보드 화면 (Custom Dashboard)

3-1. 기본 뷰 화면 설명

메뉴 경로: Dashboard > (대시보드 이름 선택)

사용자 대시보드 화면입니다.

순번	항목	설명
1	Dashboard Name	대시보드 이름입니다. 이름 선택 시 대시보드 목록을 보여줍니다. Search / Favorite 설정·해제(★/☆) / Favorite Dashboard 목록 / Dashboard List 제공
2	Edit	대시보드 편집 화면으로 이동합니다.
3	Filter Variables	필터할 모니터링 대상을 선택합니다. Preset Filter 기능 포함
4	Global Time	대시보드 모니터링 시간을 선택합니다.
5	Alert	Alert 화면으로 이동합니다.
6	Dashboard menu	Filter Variables 접기/펼치기 / Only Target Name / Export to Excel / Collapse all group widgets / Expand all group widgets / Disable Alert

Dashboard menu 상세:

메뉴 항목	설명
Filter Variables	필터 변수를 접거나 펼칩니다.
Only Target Name	타겟 이름만 볼지 여부를 설정합니다.
Export to Excel	대시보드를 엑셀 파일로 다운로드합니다.
Collapse all group widgets	모든 그룹 위젯을 접습니다.
Expand all group widgets	모든 그룹 위젯을 펼칩니다.
Disable Alert	알람 활성화 여부를 설정합니다.

3-2. 프리셋 (Preset Filter)

메뉴 경로: Dashboard > (대시보드) > Filter Variables > Preset Filter

Filter Variables에서 선택한 변수 값을 프리셋으로 저장하여 재사용할 수 있습니다.

Filter Variables 화면:

Preset Filter 화면:

4. 대시보드 편집 (Edit Dashboard)

4-1. 편집 화면 구성

메뉴 경로: Dashboard > (대시보드) > Edit

대시보드 설정 화면입니다.

순번	항목	설명
1	Dashboard Group	대시보드 그룹을 선택합니다. 사용자 대시보드 그룹 목록을 보여줍니다.
2	Dashboard Name	대시보드 이름을 입력합니다.
3	Filter Variables	변수 편집 팝업창이 열립니다.
4	Global Time	대시보드 시간을 설정합니다.
5	Widgets	위젯 리스트가 나타납니다. 위젯 클릭 시 위젯 설정 팝업이 나타납니다.
6	View Pack	뷰팩 리스트가 나타납니다. 뷰팩 클릭 시 대시보드에 추가할 수 있습니다.
7	Dashboard	대시보드 리스트가 나타납니다. 대시보드 이름 클릭 시 대시보드에 추가할 수 있습니다.
8	Button	Cancel: 대시보드 편집 취소 / Save: 대시보드 저장

4-2. 변수 편집 (Filter Variables)

메뉴 경로: Dashboard > Edit > Filter Variables

대시보드 편집 화면에서 [Filter Variables]를 클릭하면 변수 편집 팝업창이 열립니다.

Custom Stat 지표를 사용하는 경우, 변수 설정 방법은 3가지로 제공됩니다:

방법	설명
글로벌 변수 설정	쿼리 매니저 구문에 target_id 변수를 설정하고, 대시보드 > 글로벌 변수 설정에서 변수를 지정합니다.
필터 위젯 적용	필터 위젯을 설정하고, 연계될 위젯의 참조 변수 설정에 필터 위젯의 변수를 설정합니다.
다른 위젯 연계	위젯을 설정하고, 연계할 위젯에 변수를 설정합니다. 클릭 또는 드래그 시 해당 조건으로 데이터가 조회됩니다.

글로벌 변수 설정 예시:

target_id in ($_get_targets_from_tags('pod', targetIds))

'pod': 해당 Target의 tag 값
targetIds: 지표 변수 이름

필터 위젯 적용 이미지:

위젯 간 연계 이미지:

4-3. 프리셋 저장 (Save selection as preset)

메뉴 경로: Dashboard > Edit > Filter Variables > Save selection as preset

순번	항목	설명
1	Select variable	프리셋으로 저장할 변수를 선택합니다.
2	Save selection as preset	Save Preset 팝업이 나타납니다.
3	Save Preset Popup	Preset Name을 입력합니다. 저장 완료 시 프리셋 필터에 추가됩니다.

Save Preset 팝업 이미지:

5. 위젯 구성

5-1. 위젯 종류 개요

대시보드 편집 화면에서 추가할 수 있는 위젯 종류입니다.

위젯 카테고리	위젯 종류
Graphs (그래프)	Timeseries (Line / Area / Bar / Stacked Area / Stacked Bar), Scatter
List	Table, Top List
Group	Group 위젯
Text	Text 위젯
Image	Image 위젯
Gauge	Gauge 위젯
Action View	Action View 위젯
Heat map	Heat map 위젯
Daily Comparison	Daily Comparison 위젯
Architecture	Architecture 내 모든 Chart Type
Business	Business 내 모든 Chart Type

메뉴 경로: Dashboard > Edit > Widgets > Timeseries Widget

시계열 데이터를 차트 형태로 시각화하는 위젯입니다.

지원 차트 형태:

차트 형태	이미지
Line
Area
Bar
Stacked Area
Stacked Bar

Timeseries Widget Setting:

순번	항목	설명
1	Display Style	차트 형태를 선택합니다. (Line / Area / Bar / Stacked Area / Stacked Bar)
2	Show max value at the chart	차트에 최댓값이 표시됩니다. 지표 개수와 상관없이 1개의 최댓값만 표시됩니다.
3	Mark by Selected Metrics	디스플레이 스타일이 Area일 때 표시됩니다. Stat, Target, Aggregation을 설정한 데이터의 Current Value, Percentage Change를 선택합니다.
4	Thresholds	차트 데이터의 임계치를 설정합니다.
5	Decimals	차트 데이터의 소수점 자리수를 설정합니다.

5-3. 엑셀 추출 지원 위젯

대시보드 Export to Excel 기능 시 엑셀 추출을 지원하는 위젯 목록입니다.

위젯 종류	지원 여부
Timeseries - Line / Area / Bar / Stacked Area / Stacked Bar	지원
Scatter	지원
Table	지원
Top List	지원
Group	지원
Text	지원
Image	지원
그 외 위젯	미지원 ("not supported yet" 메시지 발생)

5-4. 쿼리 매니저로 사용할 수 없는 위젯

쿼리 매니저로 커스텀 대시보드를 구성할 때 사용 불가한 위젯 목록입니다.

그래프 위젯:

아키텍처 위젯:

비즈니스 위젯:

5-5. Custom Stat 지표 위젯 활용

메뉴 경로: Dashboard > 위젯 > 지표 설정

Custom Stat으로 생성한 사용자 지표를 대시보드 위젯에서 사용할 수 있습니다.

커스텀 지표 미지원 위젯:

위젯	지원 여부
Gauge	미지원
Action View	미지원
Heat map	미지원
Daily Comparison	미지원
Architecture 내 모든 Chart Type	미지원
Business 내 모든 Chart Type	미지원

커스텀 지표 사용 방법 (쿼리 정의 지표):

순서	방법
1	'쿼리 정의 지표 사용' 옵션 적용
2	지표 설정 클릭
3	카테고리 하단의 `[Custom] Custom Stat_{사용자 지표 타입}` 에서 지표 선택

일반 지표로 사용 방법:

순서	방법
1	지표 설정 클릭
2	카테고리 하단의 `[Custom] Custom Stat_{사용자 지표 타입}` 에서 지표 선택
3	사용자 지표 타입(DB, OS 타입)에 따라 스케줄에서 적용한 타겟 또는 동일한 플랫폼의 타겟을 선택

메뉴 경로: Dashboard > Dashboard List > Share Dashboard

순번	항목	설명
1	Dashboard to Share	공유할 대시보드 목록입니다.
2	User Group List	대시보드를 공유받을 사용자 그룹 목록입니다.
3	User List	대시보드를 공유받을 사용자 목록입니다.
4	Selected	대시보드를 공유할 사용자 리스트입니다. '사용자 그룹 \| 사용자 명' 형태로 제공됩니다.

7. 대시보드 가져오기 / 내보내기

7-1. Export Dashboard (대시보드 내보내기)

메뉴 경로: Dashboard > Dashboard List > Dashboard Option > Export Dashboard

대시보드를 json 파일로 추출합니다.

7-2. Import Dashboard (대시보드 가져오기)

메뉴 경로: Dashboard > Dashboard List > Dashboard List Option > Import Dashboard

.json 형식으로 저장된 파일을 불러옵니다.

7-3. 화면에서 Import가 불가능한 경우 (Swagger 활용)

화면에서 대시보드 import가 불가능한 경우 Swagger를 통해 import할 수 있습니다.

전제 조건: swagger 사용을 위해 8081 포트(기본 포트)가 열려 있어야 합니다.

Step 1. 대시보드 추출

Step 2. 추출한 대시보드 json 파일 수정

2-1. 아래 순서로 텍스트 수정:
 1. \  →  \\ 로 바꾸기
 2. "  →  \" 로 바꾸기

또는 사이트(https://jsontostring.com/)에서 자동 변환 가능합니다.

Step 3. Swagger 접속 후 인증

exemone IP:8081 접속 → Authorize 인증 (exemONE header authorization 값 입력)

Step 4. API 실행

select definition: dashboard > /api/v7/dashboards/dashboard/import → jsonList에 수정한 json 텍스트를 입력 후 실행

Step 5. Dashboard 목록 > 전체에서 추가 확인

Swagger 미사용 시 curl 명령어:

curl -X POST "http://ip:8081/api/v7/dashboards/dashboard/import?isFeatrued=false&userId=1" \
  -H "accept: */*" \
  -H "Authorization: {인증정보}" \
  -H "Content-Type: application/json" \
  -d "[json텍스트]"

8. 주의사항 / 참고

항목	내용
Featured Dashboard 미출력 시	`icon_id`가 null값인 경우 발생할 수 있으며, `xm_dashboard` 테이블에서 해당 대시보드의 `icon_id`를 수동으로 추가해야 합니다.
커스텀 대시보드 → 기본 제공 대시보드 변경	`xm_dashboard` 테이블에서 해당 대시보드의 `preset` 값을 `true`로 변경합니다.
엑셀 추출 미지원 위젯	"not supported yet" 메시지가 발생하는 위젯은 지원하지 않는 위젯입니다.
쿼리 매니저 미지원 위젯	Gauge, Action View, Heat map, Daily Comparison, Architecture/Business 내 위젯은 쿼리 매니저로 사용 불가합니다.
Custom Stat 지표 단위	지표는 숫자(Number) 만 수집 가능하며, 문자열은 지원되지 않습니다.
Import 파일 형식	Dashboard 및 Viewpack 모두 `.json` 형식 파일만 지원합니다.
swagger import 포트	swagger를 통한 import 시 기본 포트인 8081 포트가 열려 있어야 합니다.
변수 설정 방법	변수 목록은 쿼리 매니저 결과에 따라 다르게 출력됩니다.

참고 문서:

exemONE Dashboard

1. 개요​

2. 대시보드 목록​

2-1. 커스텀 대시보드 목록 (Custom Dashboard List)​

2-2. 기본 제공 대시보드 (exemONE Featured Dashboard)​

2-3. 대시보드 목록 추가 기능 (Dashboard List)​

3. 커스텀 대시보드 화면 (Custom Dashboard)​

3-1. 기본 뷰 화면 설명​

3-2. 프리셋 (Preset Filter)​

4. 대시보드 편집 (Edit Dashboard)​

4-1. 편집 화면 구성​

4-2. 변수 편집 (Filter Variables)​

4-3. 프리셋 저장 (Save selection as preset)​

5. 위젯 구성​

5-1. 위젯 종류 개요​

5-2. Timeseries Widget (그래프 위젯)​

5-3. 엑셀 추출 지원 위젯​

5-4. 쿼리 매니저로 사용할 수 없는 위젯​

5-5. Custom Stat 지표 위젯 활용​

6. 대시보드 공유 (Share Dashboard)​

7. 대시보드 가져오기 / 내보내기​

7-1. Export Dashboard (대시보드 내보내기)​

7-2. Import Dashboard (대시보드 가져오기)​

7-3. 화면에서 Import가 불가능한 경우 (Swagger 활용)​

8. 주의사항 / 참고​