DB Advisor

홈 화면 > 프로젝트 선택 > DB Advisor

DB Advisor는 데이터베이스 인스턴스 상태, SQL, 용량, 경고 알림을 정해진 규칙에 따라 점검하고 이상 항목을 한눈에 보여 줍니다. 어드바이저는 WhaTap AI를 기반으로 점검 결과를 설명하고 추정 원인과 권장 조치를 제시합니다. DBA와 운영 담당자는 점검 결과로 데이터베이스 상태를 파악할 수 있습니다. 날짜별로 저장된 일일 점검 결과는 인수인계와 일일 보고에 활용할 수 있습니다.

DB Advisor는 다음 원칙으로 동작합니다.

• 규칙 기반 판정: 화면에 명시된 기준과 수치에 따라 정상, 주의, 위험을 판정합니다.
• AI 기반 설명: 어드바이저는 점검마다 한 차례 결과 설명, 원인 가설, 권장 조치를 작성합니다. 수치는 점검 규칙으로 산출한 값을 그대로 인용합니다.
• 사용자 검토 후 조치: 사용자가 권장 조치를 검토한 뒤 데이터베이스에 직접 적용합니다.

사용 전 확인

지원 데이터베이스

다음 데이터베이스 프로젝트에서 사용할 수 있습니다. 클러스터 프로젝트는 지원하지 않습니다.

• PostgreSQL
• MySQL
• SQL Server
• Oracle
• Oracle Pro

Amazon RDS와 Amazon Aurora에서도 위 데이터베이스 엔진을 사용하면 이 기능을 이용할 수 있습니다.

사용 권한

DB Advisor의 사용 여부는 프로젝트 단위로 설정하며, 활성화하면 모든 프로젝트 멤버가 같은 화면을 공유합니다. 다음 권한 중 하나가 있는 멤버만 활성화하거나 사용을 중지할 수 있습니다.

• 프로젝트 수정 권한
• 프로젝트 Flex 보드 편집 권한

권한이 없는 멤버에게는 DB Advisor 시작하기 버튼이 비활성화되고, 홈 화면에 사용 중지 버튼이 나타나지 않습니다. 멤버 권한에 대한 자세한 내용은 다음 문서를 참고하세요.

데이터 접근 범위

• 활성화 전에는 프로젝트 데이터에 접근하지 않습니다.
• 활성화하면 인스턴스 카운터, SQL 통계, 용량 추이, 경고 이벤트를 조회합니다. 데이터베이스에 명령을 실행하지 않습니다.
• 점검마다 판정에 사용한 수치와 발견 내용을 WhaTap AI에 전달해 설명을 생성합니다.

설치형 환경

DB Advisor는 WhaTap AI 기능으로, front.conf의 ui_whatap_ai_mode 설정값이 show일 때만 메뉴가 나타납니다. 설정하지 않으면 SaaS 환경은 show, 설치형 환경은 disabled로 동작합니다. 메뉴가 숨겨진 환경에서는 DB Advisor 주소로 직접 접근해도 화면이 열리지 않습니다.

시작하기와 사용 중지

시작하기

DB Advisor는 기본적으로 비활성화되어 있습니다. 다음 순서로 사용을 시작하세요.

1. 프로젝트를 선택한 다음 사이드바 맨 위의 DB Advisor 메뉴를 선택하세요.

2. 안내 화면에서 DB Advisor의 주요 기능과 알아두실 것을 확인하세요.

3. DB Advisor 시작하기 버튼을 클릭하세요.

버튼을 클릭하면 첫 점검을 바로 시작하고 DB Advisor 홈 화면으로 이동합니다. 별도로 설정할 항목은 없습니다.

홈 화면 상단에는 최근 점검 결과의 요약이 표시됩니다. 원인 물어보기 버튼을 클릭하면 WhaTap AI 채팅 창에서 원인을 분석할 수 있습니다. 그 아래 맡고 있는 일 영역에서 진단과 조치, 일일 점검 카드를 선택해 각 화면으로 이동할 수 있습니다.

말하면 만들어 드립니다 영역에서는 다음 기능을 사용할 수 있습니다.

• Flex 보드 만들기: 필요한 지표를 대화로 설명하면 현재 프로젝트에 Flex 보드를 생성합니다. 대시보드 수정 권한이 필요합니다.
• 인수인계 노트: 현재 점검 결과와 적용한 조치를 인수인계용 문서로 정리합니다. 작성된 내용은 복사해 활용할 수 있습니다.

사용 중지

1. DB Advisor 홈 화면 맨 아래에서 사용 중지 버튼을 클릭하세요.

2. DB Advisor 사용을 중지할까요? 확인 창에서 사용 중지 버튼을 클릭하세요.

사용을 중지하면 안내 화면으로 돌아갑니다. 기존 일일 점검 기록은 유지되며, 언제든 다시 시작할 수 있습니다.

판정 체계

점검 결과는 다음 네 가지 판정 중 하나로 표시합니다.

판정	의미
정상	기준 범위 이내. 근거 수치와 평소값을 함께 표시
주의	기준 범위를 벗어남. 즉각적인 장애는 아니지만 확인 필요
위험	즉시 확인 필요
확인 필요	데이터 부족으로 판정 불가

주의

확인 필요는 수집 중단이나 데이터 부족으로 판정할 수 없는 상태입니다. 정상으로 간주하지 말고 에이전트의 수집 상태를 확인하세요.

점검 항목은 다음 네 가지로 구분합니다.

• 가용성: 수집 연속성, 재시작, 복제 지연 등 서비스가 정상적으로 동작하는지에 관한 항목
• 성능: CPU, 세션, SQL 응답시간 등 처리 속도에 관한 항목
• 용량: 테이블스페이스, 데이터베이스 크기 등 저장 공간에 관한 항목
• 이벤트: 경고 알림, 데드락 등 발생 건수로 판정하는 항목

진단과 조치

진단과 조치는 현재 데이터베이스 상태를 점검하고 이상 항목의 발견부터 원인 분석, 조치까지 진행 상태를 관리합니다. 홈 화면의 진단과 조치 카드를 선택하면 화면이 열립니다.

화면 구성

진단과 조치 화면은 위에서부터 다음 영역으로 구성됩니다.

• 점검 요약: 어드바이저가 이번 점검 결과를 설명합니다. 아침, 오후, 저녁 점검 구분과 점검 대상 구간을 함께 표시합니다. 설명을 새로 작성하려면 다시 생성을 클릭하세요.
• 인스턴스 상태: 인스턴스마다 점검 구간의 추이 차트와 판정을 카드로 보여 줍니다.
• 어드바이저의 일: 다섯 가지 점검의 결과와 마지막 점검 시각을 표시합니다. 지금 다시 점검하려면 다시 점검을 클릭하세요.
• 발견 목록: 점검에서 찾은 이상 항목입니다. 자세한 내용은 발견 확인하기를 참고하세요.

점검 구간

진단과 조치는 화면에 접근한 시각을 기준으로 점검하며 정해진 시각에 자동으로 실행되지 않습니다. 접근 시각에 따라 아침, 오후, 저녁 점검으로 구분하고 다음 구간을 분석합니다.

점검	화면 접근 시각	점검 구간
아침 점검	06:00 ~ 12:00	전날 18:00부터 지금까지
오후 점검	12:00 ~ 18:00	당일 06:00부터 지금까지
저녁 점검	18:00 ~ 다음 날 06:00	당일 12:00부터 지금까지

00:00 ~ 06:00에 접근하면 전날의 저녁 점검으로 보고, 전날 12:00부터 지금까지를 점검합니다.

어드바이저의 일

어드바이저의 일 영역에는 다음 다섯 가지 점검이 표시됩니다. 각 점검의 대상 구간과 이상 여부를 기록합니다.

점검	점검 기준
인스턴스 상태 점검	점검 구간을 10분 단위로 확인하고 최근 30분 데이터를 기준으로 현재 상태 판정. 세션은 절대 하한값과 평소 대비 배수, CPU는 사용률 80%와 92%를 기준으로 판정
이벤트 감시	최근 24시간 내 critical 1건 이상 또는 warning 3건 이상 반복 발생
악화 SQL 감시	최근 6시간과 전날 같은 시간대 비교. 두 구간 모두 실행 30회 이상, 현재 구간의 평균 응답시간 0.1초 이상이면서 전날의 3배 이상
평소 성능 진단	최근 6시간 실행시간 상위 SQL 중 단일 SQL의 비중이 40% 이상이고 누적 실행시간 60초 이상, 실행 10회 이상이면 부하 집중으로 판정
용량 감시	사용률 80% 이상이면서 14일 추세를 기준으로 30일 이내 소진 예상. 한도가 없는 플랫폼은 최근 3일간 하루 증가량이 100MB 이상이면서 14일 평균의 3배

평소값은 최근 14일간 수집한 1시간 평균값의 중앙값입니다.

검수 중인 초안 — clio-lua, 2026-10-23 추가

warning

• 커밋: bbe374513ca (수집이 새로 끊긴 인스턴스를 위험으로 판정, 작업자 허진권)
• 상태: 개발자 컨펌 대기.
• 최종 머지 직전 본 박스와 이 안내는 제거되고 본문만 남습니다.

인스턴스 상태 점검은 점검 구간의 수집 데이터가 거의 없는 인스턴스를 수집 중단 상태로 간주하고 위험으로 판정해 발견 목록에 추가합니다. 인스턴스 카드에는 이번 점검 구간에 수집 데이터가 없습니다라고 표시합니다. 다음 인스턴스는 수집 중단 판정에서 제외합니다.

• 점검 구간이 시작되기 하루 전부터 에이전트가 비활성 상태였던 인스턴스
• 점검 구간 중에 에이전트가 처음 연결된 인스턴스

발견 확인하기

점검에서 이상을 감지하면 발견 목록에 항목을 추가합니다. 발견 목록은 우선순위, 발견, 대상, 발생 시기, 조치 열로 구성됩니다.

발견의 지속 및 재발 여부에 따라 다음 이력을 표시합니다.

• 오늘 처음: 당일 처음 발견한 이상 항목
• n일째: 여러 날 지속된 이상 항목
• 해소됐다 재발: 해소 후 재발한 이상 항목
• 효과 없던 뒤 계속: 조치 적용 후에도 지속된 이상 항목

발견 목록 아래의 발견에서 조치까지의 흐름 보기를 클릭하면 발견별 진행 상태를 한 줄로 표시하는 흐름도가 펼쳐집니다. 흐름도는 발견, 원인, 조치, 상태 순서로 이어지며, 아직 조치가 없으면 조치 칸이 비어 있습니다. 흐름도를 닫으려면 흐름 접기 버튼을 클릭하세요.

발견 목록의 행이나 흐름도의 칸을 클릭하면 오른쪽에 상세 패널이 열립니다. 어드바이저의 일에서 이상을 감지한 점검 이름을 클릭해도 해당 발견의 상세 패널이 열립니다. 상세 패널은 판정 기준, 원인, 추이 차트, 근거 순서로 구성됩니다.

조치 적용과 상태

권장 조치를 검토한 뒤 데이터베이스에 직접 적용하세요. 적용한 뒤에는 상세 패널에서 적용했음으로 마킹 버튼을 클릭하세요. 이 버튼은 조치를 제안한 발견의 상세 패널에만 나타납니다. 적용 표시를 취소하려면 적용 마킹 취소 버튼을 클릭하세요.

조치의 진행 상태는 다음과 같이 표시합니다.

상태	설명
적용 대기	권장 조치 제시. 사용자가 직접 적용
검증 중	적용 완료로 표시. 다음 점검에서 해소 여부 판정
효과 확인	적용 후 같은 발견이 다시 나타나지 않음
효과 없음	적용 후에도 같은 발견이 다시 나타남

적용 완료로 표시한 뒤 효과를 판정하기까지 필요한 시간은 점검 종류에 따라 다릅니다.

점검	효과 판정 대기 시간
인스턴스 상태 점검, 악화 SQL 감시, 평소 성능 진단	6시간
이벤트 감시	12시간
용량 감시	3일

심층 조사

발견 상세 패널에서 다음 버튼을 사용할 수 있습니다.

• 어드바이저에게 심층 조사: WhaTap AI 채팅 창이 열리고, 선택한 발견을 바탕으로 관련 데이터를 추가로 조회해 원인을 더 자세히 조사합니다.
• 관련 분석 화면으로 이동하는 버튼: 발견의 종류에 따라 인스턴스 모니터링에서 보기, Top SQL에서 보기, Top SQL 비교에서 보기, 용량 추이에서 보기, 경고 알림 이력에서 보기 중 하나가 나타납니다. 버튼을 클릭하면 대상 인스턴스와 점검 구간이 지정된 채 해당 화면으로 이동합니다.

일일 점검

일일 점검은 매일 08:00 기준 직전 24시간의 데이터베이스 운영 상태를 점검하고 결과를 날짜별로 저장합니다. 홈 화면의 일일 점검 카드를 선택하면 화면이 열립니다.

점검 기록 만들기

노트

일일 점검은 정해진 시각에 자동으로 실행되지 않습니다. 그날 처음 일일 점검 화면을 열면 점검을 실행하고 결과를 저장합니다. 화면을 열지 않은 날의 기록은 이전 7일 더 채우기 버튼으로 최대 21일 전까지 생성할 수 있습니다.

• 기준 시각은 매일 08:00이며, 사용 중인 브라우저의 시간대를 따릅니다.
• 당일 점검 기록은 마지막 1시간 집계가 끝난 뒤 08:30 이후에 만듭니다.
• 같은 날 다시 열면 저장된 결과를 표시하므로 수치와 판정이 유지됩니다.

지난 날짜의 점검 기록은 이전 7일 더 채우기 버튼으로 생성하세요. 다만 SQL, 이벤트, 용량 항목은 7일 전까지만 계산하며, 그보다 오래된 날짜에서는 확인 필요로 표시합니다. 특정 날짜의 기록만 다시 생성하려면 이 날만 다시 시도 버튼을 클릭하세요.

점검 기록은 날짜별로 일정 기간 보관하며, 오래된 날짜는 요약만 남습니다. 장기 보관이 필요한 기록은 요약 복사로 별도 저장하세요.

점검 결과 확인하기

일일 점검 화면은 위에서부터 다음 영역으로 구성됩니다.

• 점검 기록 정보: 점검 기록의 기준 날짜와 분석 대상 구간을 표시합니다. 화살표 버튼이나 날짜 드롭다운으로 다른 날짜의 점검 기록을 선택할 수 있습니다.
• 날짜별 기록 막대: 날짜별 점검 기록 유무와 가장 심각한 판정을 색상으로 표시합니다. 막대에서 날짜를 선택하면 그날의 점검 기록이 열립니다.
• 판정 집계: 확인한 항목 수와 정상, 주의, 위험, 확인 필요 건수를 표시합니다.
• 항목별 요약: 항목마다 판정 분포를 카드로 보여 줍니다. 카드를 선택하면 아래 점검 결과 표에 해당 항목만 표시합니다.
• 점검 결과 표: 항목마다 구분, 항목, 대상, 언제, 확인 결과와 근거, 판정을 보여 줍니다. 판정 옆의 아이콘에 마우스를 올리면 판정 사유를 볼 수 있습니다. 항목별 판정 기준은 표 위의 기준 보기를 펼쳐 확인하세요.

전날 점검 기록이 있으면 표 아래에 전날과 비교한 변화를 함께 표시합니다.

점검 범위는 항목에 따라 다릅니다.

• 프로젝트 단위: 응답시간 악화 SQL, SQL 부하 집중, 경고 알림 발화
• 인스턴스 단위: 그 밖의 모든 항목

카운터 항목의 값은 24시간 동안의 1시간 평균값 24개 중 최댓값입니다.

이 데이터베이스에서 점검하는 항목과 판정 기준은 일일 점검 항목을 참고하세요. 프로젝트가 수집하는 지표에 해당 값이 없으면 해당 항목을 생성하지 않고 데이터가 없는 인스턴스 수를 표 아래에 표시합니다.

검수 중인 초안 — clio-lua, 2026-10-23 추가

warning

• 커밋: 77611cbe416 · ad716f53ef8 · bbe374513ca (CPU 값이 없는 인스턴스와 이틀 넘게 수집이 없는 인스턴스를 각주로 안내, 작업자 허진권)
• 상태: 개발자 컨펌 대기.
• 최종 머지 직전 본 박스와 이 안내는 제거되고 본문만 남습니다.

다음 인스턴스는 점검 결과 표에 항목을 생성하지 않고, 표 아래에 해당 인스턴스 수를 표시합니다.

• CPU 사용률 값이 없는 인스턴스: 최근 14일간 CPU 사용률 수집값이 없으면 XOS 에이전트 미설치 상태로 간주합니다. 안내 문구 옆의 XOS 에이전트 설치 링크를 클릭하면 설치 문서로 이동합니다. 최근 14일간 수집 이력이 있으나 점검일에만 값이 없으면 수집 중단으로 간주해 항목을 생성하고 확인 필요로 판정합니다.
• 점검일과 전날의 수집 시간이 부족한 인스턴스: 점검일과 그 전날 모두 수집 시간이 6시간 미만이면 매일 위험 판정을 누적하지 않고 해당 인스턴스 수만 표시합니다.

점검 기록 요약은 화면 위쪽의 요약 복사 버튼을 클릭해 클립보드에 복사할 수 있습니다. 인수인계나 일일 보고에 활용하세요. 화면 맨 아래의 원인 물어보기 버튼을 클릭하면 이 점검 기록의 내용을 담은 채 WhaTap AI 채팅 창이 열립니다.

현재 시간 기준으로 보기

현재 시간 기준으로 보기 버튼을 클릭하면 현재 시점을 기준으로 다시 판정한 결과를 표시합니다. 분석 구간은 항목 종류에 따라 다릅니다.

• 카운터 항목은 최근 30분
• SQL 항목은 최근 6시간
• 이벤트 항목은 최근 24시간
• 용량 항목은 최근 14일

분석 구간이 저장된 점검 기록과 다르므로 결과가 다를 수 있습니다. 저장된 점검 기록으로 돌아가려면 점검 기록으로 보기 버튼을 클릭하세요.

분석 화면으로 이동하기

점검 결과 표의 각 행에는 관련 분석 화면으로 이동하는 버튼이 있습니다. 버튼 이름은 사이드바 메뉴 이름과 같습니다. 버튼을 클릭하면 점검한 인스턴스와 점검 구간이 지정된 상태로 해당 화면이 열립니다. 예를 들어 Top SQL 비교 화면은 인스턴스, SQL 조건, 점검 구간이 설정된 상태로 열립니다.

• 정상 행의 이동 버튼은 정상 항목 n건 더 보기를 클릭해 행을 펼치면 나타납니다.
• 수집 데이터가 없어 확인 필요로 판정한 행은 에이전트 목록으로 이동합니다. 해당 인스턴스의 수집 상태를 확인하세요.
• 이벤트 기록 화면은 점검 구간만 지정된 상태로 열립니다. 대상 인스턴스는 화면에서 직접 검색하세요.

항목별 이동 화면은 일일 점검 항목을 참고하세요.

WhaTap AI로 원인 분석하기

주의 또는 위험으로 판정한 행에서 원인 버튼을 클릭하세요. WhaTap AI 채팅 창이 열리고, 해당 항목의 판정 기준과 판정, 확인 결과가 함께 전달되므로 상황을 다시 설명하지 않아도 됩니다. WhaTap AI는 전달받은 내용을 바탕으로 원인 후보를 정리합니다. 점검 기록의 판정은 확정된 결과로, 채팅 내용에 따라 변경되지 않습니다.

WhaTap AI에 대한 자세한 내용은 다음 문서를 참고하세요.

일일 점검 항목

PostgreSQL 프로젝트의 일일 점검은 다음 항목을 확인합니다.

검수 중인 초안 — clio-lua, 2026-10-23 추가

warning

• 커밋: 5a354f4a5a2 · 77611cbe416 · ad716f53ef8 · bbe374513ca · 2f43551d8be (일일 점검 CPU·수집 연속성·재시작 여부 판정 변경, 작업자 허진권)
• 상태: 개발자 컨펌 대기.
• 최종 머지 직전 본 박스와 이 안내는 제거되고 본문만 남습니다.

항목	구분	범위	판정 기준	이동 버튼
CPU 사용률	성능	인스턴스	80% 이상 주의, 92% 이상 위험. 값이 수집된 시간대가 6개 미만이면 판정하지 않음. 데이터베이스 서버에 설치한 XOS 에이전트의 수집값으로 점검. Amazon RDS 및 Aurora 인스턴스는 CloudWatch CPUUtilization 값으로 점검. 최근 14일간 수집값이 없으면 항목을 생성하지 않고 표 아래에 해당 인스턴스 수 표시	인스턴스 모니터링
액티브 세션	성능	인스턴스	10개 이상이면서 평소의 3배 이상이면 주의, 30개 이상이면서 6배 이상이면 위험	인스턴스 모니터링
잠금 대기 세션	성능	인스턴스	2개 이상이면서 평소의 3배 이상이면 주의, 5개 이상이면서 5배 이상이면 위험	인스턴스 모니터링
수집 연속성	가용성	인스턴스	수집 시간이 22시간 이상이면 정상, 6시간에서 21시간이면 주의, 6시간 미만이면 위험(동일 인스턴스의 다른 카운터 항목은 확인 필요). 전날 수집 시간도 6시간 미만이면 항목을 생성하지 않고 표 아래에 해당 인스턴스 수 표시. 점검 구간에 처음 연결된 에이전트는 확인 필요. 점검 구간에 에이전트가 재시작한 경우 판정 근거에 재시작 시각 표시	인스턴스 모니터링
재시작 여부	가용성	인스턴스	DB 파라미터의 가동 시간(uptime)으로 마지막 기동 시각을 산출하고, 기준 시각까지의 가동 시간이 24시간 미만이면 주의. 기준 시각 이후에 재기동한 경우 확인 필요. 파라미터를 조회하지 못한 인스턴스는 항목을 생성하지 않음	인스턴스 모니터링
복제 지연	가용성	인스턴스	10초 이상 주의, 60초 이상 위험. 복제 지연 값이 없으면 항목을 생성하지 않음	토폴로지
데드락 발생	이벤트	인스턴스	24시간 증가량 1건 이상이면 주의	락 트리
DB 크기 급성장	용량	인스턴스	최근 3일간 하루 증가량이 100MB 이상이면서 14일 평균의 3배 이상이면 주의	데이터베이스 사이즈
응답시간 악화 SQL	성능	프로젝트	직전 24시간과 그 이전 24시간 비교. 두 구간 모두 실행 30회 이상, 평균 응답시간 0.1초 이상, 응답시간이 이전 구간의 3배 이상인 SQL이 1건 이상이면 주의	Top SQL 비교
SQL 부하 집중	성능	프로젝트	1위 SQL의 비중 40% 이상, 누적 실행시간 60초 이상, 실행 10회 이상이면 주의	Top SQL
경고 알림 발화	이벤트	프로젝트	critical 1건 이상이면 위험, 동일 규칙에서 warning 3회 이상 발생하면 주의	이벤트 기록
트랜잭션 나이 소진률	가용성	인스턴스	한도의 50% 이상 주의, 80% 이상 위험. 인스턴스 내 소진률이 가장 높은 테이블 기준	Vacuum 분석
죽은 튜플 비율	성능	인스턴스	20% 이상 주의, 50% 이상 위험. 10,000행 이상 테이블 대상	Vacuum 분석

노트

트랜잭션 나이 소진률과 죽은 튜플 비율은 당일 점검 기록에만 포함됩니다. 이전 7일 더 채우기로 만든 과거 점검 기록에는 포함되지 않습니다.