프리셋 갤러리는 NeoSQL 이 DB 를 모니터링하려고 미리 만들어 둔 타일을 선택해 대시보드에 넣는 창입니다. 세션과 락, 느린 쿼리, 저장 공간, 가동 시간 같은 지표를 DBMS 마다 맞는 SQL 로 준비해 두었습니다. 선택한 프리셋은 복사되어 내 타일이 되므로 타일 설정 에서 마음대로 수정할 수 있습니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 커넥션 칸 | 프리셋을 조회할 커넥션입니다. 대시보드가 이미 사용하는 커넥션이 있으면 먼저 선택되어 있습니다. 커넥션의 DBMS 에 있는 프리셋만 보입니다. |
| 2 | 스키마 칸 | 프리셋을 조회할 데이터베이스와 스키마입니다. 넣은 타일이 선택한 데이터베이스와 스키마를 갖습니다. |
| 3 | 바로 적용 가능 n / m 표시 | 보이는 프리셋 가운데 지금 선택한 커넥션에서 실행할 수 있는 수입니다. |
| 4 | 가용성 재검사 버튼 | 가용성을 다시 확인합니다. DB 에 권한을 주거나 확장을 설치한 뒤에 클릭하세요. |
| 5 | 분류 | 세션 · 연결, 성능, 저장 공간, 건전성, 스키마 품질 분류 순서로 카드를 묶습니다. 선택한 커넥션의 DBMS 에 프리셋이 없는 분류는 보이지 않습니다. |
| 6 | 세트 카드 | 세트 표시가 붙은 카드입니다. 조회 한 번의 결과를 여러 타일이 나눠 사용합니다(아래 '세트'). |
| 7 | 프리셋 카드 | 이름, 타입, 기본 크기, 기본 주기와 설명입니다. 주기가 수동 표시이면 자동으로 실행되지 않습니다. 무거운 조회에는 heavy 표시가 붙습니다. |
| 8 | 선택 n개 추가 버튼 | 선택한 카드를 타일로 넣습니다. 옆에 선택한 프리셋은 복사되어 내 타일이 됩니다 — 앱 업데이트가 수정을 덮어쓰지 않습니다. 안내가 있습니다. |
- 커넥션의 DBMS 에 프리셋이 하나도 없으면 카드 대신 … 용 프리셋이 아직 없습니다. 안내가 보입니다.
프리셋으로 타일 넣기
- 대시보드 도구 모음의 프리셋 버튼을 클릭합니다. 빈 대시보드에서는 가운데의 프리셋으로 시작 버튼을 클릭해도 됩니다.
- 커넥션 칸과 스키마 칸을 선택합니다. 선택하면 선택한 커넥션과 스키마로 가용성 확인이 실행됩니다.
- 넣을 카드를 클릭합니다. 선택한 카드에는 체크 표시가 붙고, 다시 클릭하면 해제됩니다. 사용할 수 없는 카드는 눌리지 않습니다.
- 선택 n개 추가 버튼을 클릭합니다. 타일이 대시보드의 빈 자리에 들어가고 한 번 실행됩니다.
- 프리셋 타일은 자동 실행이 활성화된 채로, 프리셋이 정한 주기로 들어갑니다. 주기가 수동인 프리셋만 비활성화된 채로 들어갑니다. 무거운 프리셋은 10분보다 짧은 주기로 들어가지 않고, 기본은 6시간입니다.
- 커넥션이나 스키마를 변경하면 선택한 카드가 모두 해제됩니다.
가용성 확인
세션 목록이나 성능 통계는 DB 계정의 권한, 확장, 서버 설정이 있어야 읽을 수 있습니다. 권한과 확장, 서버 설정은 메타데이터로 알 수 없어서, 갤러리가 열릴 때와 커넥션, 스키마를 변경할 때 프리셋마다 가벼운 한 행짜리 조회를 실제로 보내 봅니다.
- 확인은 한 번에 하나씩 차례로 보냅니다. 갤러리를 여는 것만으로 커넥션 풀이 흔들리지 않게 하기 위해서입니다.
- 한 번 실행할 수 있다고 확인된 프리셋은 앱이 표시되어 있는 동안 다시 묻지 않습니다. 실행할 수 없던 것은 갤러리를 다시 열 때 다시 묻습니다. 가용성 재검사 버튼은 모두 다시 묻습니다.
사용할 수 없는 카드에 적히는 대표 사유입니다.
| DBMS | 필요한 것 |
|---|---|
| PostgreSQL | 느린 쿼리, 호출 횟수는 pg_stat_statements 확장, 복제 지연은 pg_monitor 역할, 테이블스페이스 크기는 CREATE 권한이나 pg_read_all_stats 역할 |
| MySQL, MariaDB | 느린 쿼리, 호출 횟수, 블로킹 세션은 performance_schema(MariaDB 는 기본으로 비활성화되어 있음), 장기 트랜잭션은 PROCESS 권한, 비밀번호 만료(MySQL)는 mysql.user 조회 권한, 복제 지연은 MySQL 8 이상의 performance_schema 복제 테이블 |
| Oracle | v$session, v$sql, v$sysstat 같은 동적 성능 뷰 조회 권한, 저장 공간은 DBA 뷰(SELECT_CATALOG_ROLE) |
| SQL Server | 세션, 성능은 VIEW SERVER STATE, 저장 공간은 VIEW DATABASE STATE 권한 |
| SQLite | 데이터베이스 크기는 pragma 함수를 사용하는 SQLite 3.16 이상 |
DBMS 마다 있는 프리셋
| 분류 | 무엇을 보나 | 있는 DBMS |
|---|---|---|
| 세션 · 연결 | 활성 세션 수, 실시간 세션 현황 | MariaDB, MySQL, PostgreSQL, Oracle, SQL Server, H2 |
| 세션 · 연결 | 블로킹 세션 수 | MariaDB, MySQL, PostgreSQL, Oracle, SQL Server |
| 세션 · 연결 | 커넥션 사용률 | MariaDB, MySQL, PostgreSQL, Oracle |
| 성능 | 느린 쿼리 Top 5, 호출 횟수 Top 5, 장기 실행 트랜잭션 | MariaDB, MySQL, PostgreSQL, Oracle, SQL Server |
| 성능 | 버퍼 / 캐시 히트율 | MariaDB, MySQL, PostgreSQL, Oracle |
| 저장 공간 | 데이터베이스 크기 | MariaDB, MySQL, PostgreSQL, Oracle, SQL Server, SQLite |
| 저장 공간 | 테이블 크기 Top 10 | MariaDB, MySQL, PostgreSQL, Oracle, SQL Server |
| 저장 공간 | 인덱스 / 데이터 비율 | MariaDB, MySQL, PostgreSQL, Oracle |
| 저장 공간 | 테이블스페이스 사용률 | PostgreSQL, Oracle, SQL Server |
| 건전성 | DB 가동 시간 | MariaDB, MySQL, PostgreSQL, Oracle, SQL Server |
| 건전성 | 비밀번호 만료 임박 | MySQL, PostgreSQL, Oracle, SQL Server |
| 건전성 | 복제 지연 | MySQL, PostgreSQL |
| 건전성 | 데드 튜플 비율 | PostgreSQL |
| 스키마 품질 | PK 없는 테이블(수동) | MariaDB, MySQL, PostgreSQL, Oracle, SQL Server, H2 |
| 스키마 품질 | 미사용 인덱스 | MySQL, PostgreSQL, SQL Server |
- 세트 두 개(세션 현황 세트, 저장 공간 세트)는 MariaDB, MySQL, PostgreSQL, Oracle, SQL Server 에 있습니다.
- 같은 DBMS 라도 버전에 따라 사용하는 SQL 이 다릅니다. NeoSQL 이 커넥션의 버전을 모르면 가장 오래된 버전에서도 사용할 수 있는 SQL 을 사용합니다.
- 위 표에 없는 DBMS 에는 프리셋이 없습니다. 직접 타일을 만드세요.
세트
세트는 조회 한 번의 결과를 여러 타일이 나눠 사용하는 묶음입니다. 따로 넣으면 주기마다 같은 조회가 타일 수만큼 나가지만, 세트로 넣으면 한 번만 나갑니다. 카드의 개별 타일이면 조회 n회 → 세트는 1회 표시가 조회 횟수의 차이입니다.
| 세트 | 들어가는 타일 |
|---|---|
| 세션 현황 세트 | 활성 세션 수, 블로킹 세션 수, 실시간 세션 현황. 30초마다 |
| 저장 공간 세트 | 테이블 크기 Top 10, 데이터 / 인덱스 구성 (누적), 용량 구성비, 데이터 대비 인덱스 크기, 스키마 총 용량, 테이블 수, 인덱스 / 데이터 비율. 6시간마다 |
- DBMS 에서 만들 수 없는 타일은 카드에 이 DBMS 에서 제외 표시로 보이고 빠진 채로 들어갑니다. 예를 들어 MariaDB 와 MySQL 의 세션 현황 세트 카드에는 블로킹 세션 수 타일이 없습니다.
- 세트 타일의 자리와 크기는 편집 모드에서 타일마다 변경할 수 있습니다. 같이 사용하는 것은 쿼리와 주기입니다.
- 세트 타일의 설정 창을 열려면 세트에서 분리해야 합니다. 타일 설정 에서 설명합니다.
커넥션을 만들 때 제안되는 대시보드
새 커넥션을 저장하면 커넥션 대시보드 만들기 창이 표시됩니다. 만들기 버튼을 클릭하면 커넥션의 DBMS 에 있는 프리셋을 모두 넣은 대시보드가 커넥션 이름 뒤에 현황 표시를 붙인 이름으로 만들어지고 열립니다.
- 제안으로 만든 대시보드는 가용성 확인을 하지 않습니다. 커넥션을 막 만든 순간 운영 DB 에 조회를 여러 번 보내지 않기 위해서입니다. 권한이 없는 타일은 열었을 때 오류로 보이니 삭제하세요.
- 세트가 아니라 낱개 프리셋으로 들어갑니다.
- 프리셋이 없는 DBMS 의 커넥션이면 묻지 않습니다.
주의할 점
- PostgreSQL 의 느린 쿼리, 호출 횟수 카드는
pg_stat_statements뷰를 실제로 읽어 확인합니다. 확장이 없거나shared_preload_libraries에 올라 있지 않으면 차단된 카드로 보입니다. 확장을 준비한 뒤 가용성을 다시 확인하세요. - 프리셋은 복사되어 들어갑니다. 앱을 업데이트해도 이미 넣은 타일의 SQL 은 변경되지 않습니다. 새 프리셋 SQL 을 사용하려면 타일을 삭제하고 다시 넣으세요.
- 갤러리를 여는 것만으로 커넥션에 확인 조회가 나갑니다. 운영 DB 라면 조회가 나간다는 점을 알고 여세요.
- 성능, 저장 공간 프리셋은 시스템 뷰를 읽습니다. 넓은 권한을 주는 대신 읽기 전용 모니터링 계정을 따로 두는 것이 좋습니다 (운영 DB 안전장치).
- 무거운 프리셋(heavy 표시)은 큰 스키마에서 시간이 오래 걸릴 수 있습니다. 주기를 줄이지 마세요.
관련 화면
- 대시보드: 넣은 타일이 놓이는 화면과 자동 실행입니다.
- 타일 설정: 넣은 타일을 수정하고 세트에서 분리합니다.
- 커넥션 만들기와 수정: 커넥션을 만들고 DB 계정을 정합니다.
- 운영 DB 안전장치: 모니터링용 계정을 따로 두는 이유입니다.