데모 상점의 DB 를 모니터링하는 대시보드를 만드는 순서를 따라 합니다. 끝나면 한 화면에 DB 서버의 상태 타일과 기간별 주문 수 같은 업무 지표 타일이 놓이고, 정한 주기로 저절로 다시 조회됩니다. 화면의 버튼과 표시는 대시보드 에서, 타일 하나의 설정은 타일 설정 에서 설명합니다. 만드는 순서와 이유에 집중합니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
준비
- 모니터링할 DB 의 커넥션이 있어야 합니다. 타일은 실제로 조회하므로 DB 접속 정보가 있는 커넥션이어야 합니다.
- 운영 DB 를 모니터링하려면 조회만 하는 DB 계정의 커넥션을 사용하세요. 타일 SQL 은 보지 않는 사이에도 주기마다 되풀이해 실행됩니다. 커넥션을 만드는 순서는 운영 DB 를 안전하게 연결하기 에 있습니다.
- 대시보드는 모니터링 서비스가 아닙니다. 앱이 표시되어 있고 대시보드 탭이 보이는 동안에만 실행되고, 값이 변경되어도 알림을 보내지 않습니다.
- 웹 앱은 NeoSQL 서버에서 접속할 수 있는 DB 만 조회합니다. 사내망 DB 는 데스크톱 앱에서 모니터링하세요(웹과 데스크톱).
대시보드 만들기
- 왼쪽 레일의 버튼을 클릭하고, 패널 머리의 + 버튼을 클릭합니다. 결과: 새 대시보드 창이 열립니다.
- 이름을
매장 현황으로 적고 확인 버튼을 클릭합니다. 결과: 빈 대시보드가 저장되고 탭으로 열립니다. 가운데에 아직 타일이 없습니다 안내가 보입니다.
- 대시보드는 커넥션 트리에 들어가지 않고 대시보드 패널에 모입니다. 타일마다 커넥션을 따로 가지므로 한 대시보드에 여러 DB 의 타일을 섞을 수 있기 때문입니다.
- 커넥션을 새로 만들 때 표시되는 커넥션 대시보드 만들기 창에서 만들어도 됩니다. 그때는 DBMS 의 프리셋이 모두 들어가므로, 운영 DB 라면 여기서처럼 선택한 타일만 넣는 편이 DB 에 보내는 조회가 적습니다.
프리셋으로 DB 상태 타일 넣기
세션 수, 느린 쿼리, 저장 공간처럼 DBMS 마다 같은 질문은 NeoSQL 이 미리 만들어 둔 프리셋으로 넣습니다. SQL 을 작성하지 않아도 되고, DB 계정의 권한으로 실행할 수 있는지 먼저 확인해 줍니다.
- 대시보드 가운데의 프리셋으로 시작 버튼을 클릭합니다. 타일이 있는 대시보드에서는 도구 모음의 프리셋 버튼을 클릭합니다. 결과: 프리셋 갤러리가 열립니다.
- 커넥션 칸(1)과 스키마 칸(2)을 선택합니다. 결과: 선택한 커넥션의 DBMS 에 있는 프리셋만 보이고, 프리셋마다 가벼운 조회를 실제로 보내 사용할 수 있는지 확인합니다. 사용할 수 있는 수가 3 자리에 보입니다.
- 넣을 카드를 클릭합니다. 사용할 수 없는 카드에는 필요한 권한이나 확장이 적혀 있고 눌리지 않습니다. 결과: 선택한 카드에 체크 표시가 붙습니다. 권한을 받은 뒤에는 가용성 재검사 버튼으로 다시 확인합니다.
- 선택 n개 추가 버튼(8)을 클릭합니다. 결과: 타일이 빈 자리에 들어가 한 번 실행됩니다. 프리셋 타일은 자동 실행이 활성화된 채로, 프리셋이 정한 주기로 들어갑니다.
- 사용할 수 없는 이유와 DBMS 마다 있는 프리셋은 프리셋 갤러리 에서 설명합니다.
SQL 로 업무 지표 타일 만들기
프리셋에 없는 질문은 SQL 편집기에서 조회를 다듬은 뒤 타일로 보냅니다. 편집기에서 결과를 확인하며 수정할 수 있어 타일 설정 창에서 처음부터 작성하는 것보다 빠릅니다.
shop-db의 SQL 탭에서 기간 안의 주문 수를 세는 조회를 작성하고 실행해 봅니다. 결과::from,:to는 바인드 파라미터로 보여 값을 넣고 실행해 볼 수 있습니다(바인드 파라미터).- 문장 안에 커서를 두고 도구 모음의 대시보드 버튼을 클릭한 뒤
매장 현황대시보드를 선택합니다. 결과: 타일 설정 창이 문장과 SQL 탭의 커넥션, 스키마로 열립니다. - 타입 칸에서 숫자를 선택하고 데이터 조회 버튼을 클릭합니다. 결과: 지금 조회 기간으로 실제로 조회해 값을 보여 줍니다.
- 자동 실행 스위치를 활성화하고 확인 버튼을 클릭합니다. 결과: 타일이 대시보드의 첫 빈 자리에 들어가고 대시보드 탭이 열립니다. 타일은 넣은 직후에 한 번 실행됩니다. 자동 실행 스위치를 활성화하지 않으면 그 뒤로는 수동으로 남아 직접 클릭해야 실행됩니다.
SELECT COUNT(*) AS order_count
FROM orders
WHERE ordered_at >= :from AND ordered_at < :to
- 타일은
SELECT나WITH로 시작하는 문장 하나만 받습니다. 그 밖의 문장은 보내지 않고 이유를 알립니다. :from,:to를BETWEEN대신 위처럼>=,<로 작성하면 기간의 끝 시각에 걸친 행을 두 번 세지 않습니다.
기간과 새로고침 주기 정하기
- 기간 칸(3)에서 보고 싶은 기간을 선택합니다. 처음 값은 최근 7일입니다. 결과:
:from,:to를 사용하는 타일만 다시 실행되고, 타일들의 지난 값과 추세선은 삭제됩니다. 다른 구간의 값과 비교하지 않기 위해서입니다. - 자동 실행 스위치(4) 옆의 기본 주기를 정합니다. 처음 값은 60초이고 가장 짧게는 30초입니다. 결과: 주기를 따로 정하지 않은 자동 실행 타일이 기본 주기로 실행됩니다. 무거운 집계 타일은 타일 설정에서 주기를 길게 따로 정하세요.
- 편집 버튼(6)을 클릭하고 타일을 드래그해 자리와 크기를 정한 뒤 다시 클릭해 비활성화합니다. 결과: 옮길 때마다 바로 저장됩니다. 자주 볼 지표를 위에 두세요.
- 지금 값을 보고 싶으면 전체 새로고침 버튼(5)을 클릭합니다. 결과: 자동 실행 여부와 상관없이 모든 타일을 지금 실행합니다.
- 다른 작업 탭이나 다른 프로젝트로 옮겨 가면 자동 실행이 멈춥니다. 돌아오면 그사이 주기가 지난 타일만 바로 실행하고, 나머지는 남은 주기를 기다립니다.
- DB 에 부담을 주지 않도록 한 커넥션에서는 한 번에 하나씩 실행합니다. 동시 실행 수와 자동 실행 수의 한도는 대시보드 의 '자동 실행과 새로고침' 에 있습니다.
팀과 나누기
| 로컬 프로젝트 | 계정 프로젝트 | |
|---|---|---|
| 대시보드의 정의(타일, SQL, 배치, 주기) | 기기에만 있습니다 | 프로젝트 멤버가 함께 사용합니다. 멤버 누구나 수정하고 삭제할 수 있습니다 |
| 실행 결과 | 기기에만 남습니다 | 멤버마다 각자의 앱이 각자 조회합니다. 결과는 공유되지 않습니다 |
- 계정 프로젝트에서 대시보드를 꾸린 뒤 팀원에게 알립니다. 결과: 팀원이 프로젝트를 열면 왼쪽 레일의 패널에 같은 대시보드가 보입니다. 이미 열어 둔 팀원은 프로젝트를 다시 열어야 변경된 내용을 봅니다.
- 팀원이 대시보드를 엽니다. 결과: 팀원의 앱이 타일의 커넥션으로 직접 조회합니다. 팀원이 DB 에 접속할 수 있어야 하고, 마스킹된 컬럼은 팀원의 역할에 따라 마스킹됩니다.
- 누구나 수정하고 삭제할 수 있으므로, 팀이 함께 보는 대시보드의 타일을 삭제할 때는 먼저 알려 두세요. 타일 삭제는 되돌릴 수 없습니다.
- 두 사람이 같은 대시보드를 수정하면 나중에 저장한 사람에게 다른 멤버가 먼저 저장했습니다 창이 표시됩니다. 최신본을 불러올지, 내 변경으로 덮어쓸지 선택합니다.
다음에 할 일
- 타일 설정: 차트 타입, 컬럼 지정, 표시 옵션, 타일별 주기와 시간대를 정합니다.
- 프리셋 갤러리: DBMS 마다 있는 프리셋과 필요한 권한을 봅니다.
- 운영 DB 를 안전하게 연결하기: 대시보드에 사용할 조회용 커넥션을 만듭니다.
- 팀과 함께 설계하기: 대시보드를 함께 볼 팀원을 초대합니다.