화면: 대시보드

프리셋 갤러리

프리셋 갤러리는 NeoSQL 이 DB 를 모니터링하려고 미리 만들어 둔 타일을 선택해 대시보드에 넣는 창입니다. 세션과 락, 느린 쿼리, 저장 공간, 가동 시간 같은 지표를 DBMS 마다 맞는 SQL 로 준비해 두었습니다. 선택한 프리셋은 복사되어 내 타일이 되므로 타일 설정 에서 마음대로 수정할 수 있습니다.

사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트

화면 구성

번호이름설명
1커넥션 칸프리셋을 조회할 커넥션입니다. 대시보드가 이미 사용하는 커넥션이 있으면 먼저 선택되어 있습니다. 커넥션의 DBMS 에 있는 프리셋만 보입니다.
2스키마 칸프리셋을 조회할 데이터베이스와 스키마입니다. 넣은 타일이 선택한 데이터베이스와 스키마를 갖습니다.
3바로 적용 가능 n / m 표시보이는 프리셋 가운데 지금 선택한 커넥션에서 실행할 수 있는 수입니다.
4가용성 재검사 버튼가용성을 다시 확인합니다. DB 에 권한을 주거나 확장을 설치한 뒤에 클릭하세요.
5분류세션 · 연결, 성능, 저장 공간, 건전성, 스키마 품질 분류 순서로 카드를 묶습니다. 선택한 커넥션의 DBMS 에 프리셋이 없는 분류는 보이지 않습니다.
6세트 카드세트 표시가 붙은 카드입니다. 조회 한 번의 결과를 여러 타일이 나눠 사용합니다(아래 '세트').
7프리셋 카드이름, 타입, 기본 크기, 기본 주기와 설명입니다. 주기가 수동 표시이면 자동으로 실행되지 않습니다. 무거운 조회에는 heavy 표시가 붙습니다.
8선택 n개 추가 버튼선택한 카드를 타일로 넣습니다. 옆에 선택한 프리셋은 복사되어 내 타일이 됩니다 — 앱 업데이트가 수정을 덮어쓰지 않습니다. 안내가 있습니다.
  • 커넥션의 DBMS 에 프리셋이 하나도 없으면 카드 대신 … 용 프리셋이 아직 없습니다. 안내가 보입니다.

프리셋으로 타일 넣기

  1. 대시보드 도구 모음의 프리셋 버튼을 클릭합니다. 빈 대시보드에서는 가운데의 프리셋으로 시작 버튼을 클릭해도 됩니다.
  2. 커넥션 칸과 스키마 칸을 선택합니다. 선택하면 선택한 커넥션과 스키마로 가용성 확인이 실행됩니다.
  3. 넣을 카드를 클릭합니다. 선택한 카드에는 체크 표시가 붙고, 다시 클릭하면 해제됩니다. 사용할 수 없는 카드는 눌리지 않습니다.
  4. 선택 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 복제 테이블
Oraclev$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 10MariaDB, 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 표시)은 큰 스키마에서 시간이 오래 걸릴 수 있습니다. 주기를 줄이지 마세요.

관련 화면