DB Advisor

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

DB Advisor는 데이터베이스 인스턴스 상태와 SQL, 용량, 경고 알림을 매일 정해진 규칙으로 점검하고, 이상이 있는 항목을 한 화면에 모아 보여 주는 기능입니다. 이상 항목에는 어드바이저가 원인을 추정하고 조치를 제안합니다. 어드바이저는 DB Advisor 화면에서 설명을 작성하는 WhaTap AI입니다. 여러 분석 화면을 차례로 열어 확인하던 일을 점검 한 번으로 끝낼 수 있습니다. 하루 단위 점검 결과를 날짜별로 저장하므로 업무 교대나 일일 보고에 그대로 활용할 수 있습니다. 데이터베이스를 운영하는 DBA와 운영 담당자를 위한 기능입니다.

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

• 판정은 규칙이 합니다. 정상, 주의, 위험 판정은 화면에 표시하는 판정 기준과 수치로만 내립니다.
• 설명은 어드바이저가 씁니다. 어드바이저는 점검마다 한 번 결과 설명과 원인 가설, 조치 제안을 작성합니다. 설명 속 숫자는 점검 규칙이 계산한 값을 그대로 인용합니다.
• 조치 적용은 사람이 합니다. 조치는 제안입니다. 데이터베이스에 적용하는 일은 사용자가 직접 합니다.

사용 전 확인

지원 데이터베이스

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

• 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 응답시간 등 처리 속도에 관한 항목
• 용량. 테이블스페이스, 데이터베이스 크기 등 저장 공간에 관한 항목
• 이벤트. 경고 알림, 데드락 등 발생 건수로 판정하는 항목

진단과 조치

진단과 조치는 지금 데이터베이스가 괜찮은지 점검합니다. 직전 점검 이후 지금까지의 구간을 보고, 이상이 있으면 발견부터 원인, 조치까지 상태를 관리합니다. 홈 화면의 진단과 조치 카드를 선택하면 화면이 열립니다.

화면 구성

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

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

점검 구간

진단과 조치는 정해진 시각에 자동으로 점검하지 않습니다. 화면에 들어온 시각을 기준으로 점검합니다. 하루를 6시간 단위 세 번의 점검으로 나누며, 들어온 시각에 따라 다음과 같이 점검 이름과 보는 구간이 정해집니다.

점검	들어온 시각	보는 구간
아침 점검	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시간 평균값을 모아 구한 중앙값입니다.

발견 확인하기

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

같은 발견이 이어지면 목록에 다음과 같이 이력을 표시합니다.

• 오늘 처음. 오늘 처음 찾은 발견
• 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개 중 최댓값입니다.

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

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

현재 시간 기준으로 보기

현재 시간 기준으로 보기 버튼을 클릭하면 저장된 점검 기록 대신 지금 시점의 최근 구간으로 다시 판정한 결과를 표시합니다. 다시 판정하는 구간은 항목 종류마다 다릅니다.

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

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

분석 화면으로 이동하기

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

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

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

WhaTap AI로 원인 분석하기

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

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

일일 점검 항목

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

항목	구분	범위	판정 기준	이동 버튼
CPU 사용률	성능	인스턴스	80% 이상 주의, 92% 이상 위험. 값이 있는 시간이 6개 미만이면 판정하지 않음. 데이터베이스 서버에 XOS 에이전트를 설치해야 점검하며, 설치하지 않으면 확인 필요	인스턴스 모니터링
액티브 세션	성능	인스턴스	10개 이상이면서 평소의 3배 이상이면 주의, 30개 이상이면서 6배 이상이면 위험	인스턴스 모니터링
잠금 대기 세션	성능	인스턴스	2개 이상이면서 평소의 3배 이상이면 주의, 5개 이상이면서 5배 이상이면 위험	인스턴스 모니터링
수집 연속성	가용성	인스턴스	22시간 이상 수집하면 정상, 6시간에서 21시간이면 주의, 6시간 미만이면 확인 필요(같은 인스턴스의 다른 항목도 판정 보류)	인스턴스 모니터링
재시작 여부	가용성	인스턴스	가동 시간(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일 더 채우기로 만든 지난 날짜의 기록에서는 계산하지 않습니다.