DBX 에이전트 설정

정보

이 문서는 SQL Server 모니터링 V2를 기준으로 작성했습니다. SQL Server 모니터링 V1 문서는 다음 문서를 참조하세요.

DBX 에이전트에 필요한 설정은 whatap.conf 파일에 작성합니다. 설정할 수 있는 옵션은 다음을 참조하세요.

기본 옵션

license String

에이전트를 설치할 때 서버로부터 부여받은 프로젝트 액세스 키를 설정합니다. 프로젝트 액세스 키는 에이전트가 속한 프로젝트와 보안 통신을 위한 암호 키를 포함하고 있습니다.
whatap.server.host String

기본값 127.0.0.1,127.0.0.1

에이전트가 수집한 데이터를 전송할 와탭 수집 서버의 IP 주소를 설정하세요. 수집 서버 이중화로 2개 이상의 IP를 가진 경우 쉼표(,)를 구분자로 사용하세요. 설정한 IP 주소에는 수집 서버 proxy 데몬이 리스닝 상태로 서비스돼야 합니다.

whatap.server.port String

기본값 6600

수집 서버 포트(port)를 설정합니다. 포트는 하나만 설정할 수 있으므로 whatap_server_host에 설정한 수집 서버들은 동일 포트를 사용해야 합니다.
dbms String

mssql

주의
다른 옵션 값을 입력할 경우 모니티링을 위한 데이터 수집이 정상 작동하지 않을 수 있습니다.

db_ip String

모니터링할 데이터베이스 서버의 IP 주소를 설정합니다.

db_port String

데이터베이스가 통신에 사용하는 포트를 설정합니다.

데이터 수집

db_param_enabled Boolean

기본값 true

DB 파라미터 수집 여부를 설정합니다.
conn_fail_count Int

기본값 15

15번 연속 connection error가 발생할 때 알림을 보냅니다. 원하는 횟수를 입력해 알림 발생 기준을 조정할 수 있습니다.

tables_hour Int

기본값 5

테이블 사이즈 정보를 저장하기 위해 정보를 수집하는 시각을 설정합니다. 기본값으로 5이며 새벽 5시에 수집을 시작합니다.

long_run_session_sec Second

기본값 10 (단위: 초)

설정한 시간보다 길게 수행되고 있는 세션을 long run 세션으로 처리합니다.

skip_whatap_session Int

기본값 0

1을 설정하면 와탭에서 수집하기 위한 query가 동작하는 세션을 active session list에 표시하지 않습니다.(기본값: 0)

filegroup Boolean

기본값 true

파일 그룹(filegroup) 사이즈 수집 여부를 설정합니다.
filegroup_interval Int

기본값 60 (단위: 초, sec)

파일 그룹(filegroup) 사이즈 수집 간격을 설정합니다.
procedure_stats Boolean

기본값 true

프로시저 통계 정보 수집 여부를 설정합니다.
procedure_interval Int

기본값 1 (단위: 시간, hour)

프로시저 통계 정보 수집 간격을 설정합니다.
procedure_stat_row_limit Int

기본값 10000

프로시저 통계 정보 수집 조건을 설정합니다. 평균 실행 시간 순, 상위 10000건(기본값)을 기준으로 수집합니다.
query_stats Boolean

기본값 true

쿼리 통계 정보 수집 여부를 설정합니다.
query_interval Int

기본값 1 (단위: 시간, hour)

쿼리 통계 정보 수집 간격을 설정합니다.
query_stat_row_limit Int

기본값 10000

쿼리 통계 정보 수집 조건을 설정합니다. 평균 실행 시간 순, 상위 10000건(기본값)을 기준으로 수집합니다.
backup_row_limit Int

기본값 50

백업 내역 수집 건수를 50건(기본값)으로 제한합니다.
restore_row_limit Int

기본값 50

복구 내역 수집 건수를 50건(기본값)으로 제한합니다.
job_info_row_limit Int

기본값 50

Job 수행 내역 수집 건수를 50건(기본값)으로 제한합니다.
job_history_row_limit Int

기본값 50

Job 히스토리 수집 건수를 50건(기본값)으로 제한합니다.

데드락(Deadlock) 관련 옵션

다음은 xp_ReadErrorLog 명령어로부터 에러 로그를 읽어 데드락(Deadlock) 정보를 확인할 수 있는 에이전트 옵션입니다.

mslog Boolean

기본값 true

xp_ReadErrorLog 명령어를 수행하여 에러 로그를 조회합니다.
mslog_interval Int

기본값 1 (단위: 분, min)

이전 주기부터 현재 주기까지의 로그를 조회합니다.

팁

데드락(Deadlock) 로그를 기록하기 위한 DB 설정

데드락(Deadlock) 로그를 기록하려면 Trace Flag 1204가 활성화되어 있어야 합니다. Trace Flag는 서버의 동작에 영향을 미칠 수 있으므로, 설정 및 해제 작업은 신중히 수행해야 합니다.

설정 확인 방법

Trace Flag 1204가 활성화되었는지 확인하려면 다음 명령어를 실행하세요. 추적 플래그의 설정 상태가 ON(1)인지, OFF(0)인지 확인할 수 있습니다.
```
DBCC TRACESTATUS;
```
Trace Flag 1204 활성화(ON)

Trace Flag 1204를 활성화하려면 다음 명령어를 실행하세요.
```
DBCC TRACEON (1204, -1);
```
- 1204: Deadlock 정보를 기록하는 Trace Flag
- -1: 서버 전체에 적용(글로벌 설정)
Trace Flag 1204 비활성화(OFF)

Trace Flag 1204를 비활성화하려면 아래 명령어를 실행하세요:
```
DBCC TRACEOFF (1204, -1);
```

노트

데드락(Deadlock) 관련 에이전트 옵션은 DBX 에이전트 2.2.2 버전 이상에서 지원합니다.
xp_ReadErrorLog는 Microsoft SQL Server에서 제공하는 확장 저장 프로시저로, SQL Server의 에러 로그나 에이전트 로그의 내용을 조회할 수 있도록 지원합니다. 이를 통해 SQL Server의 상태, 오류 메시지, 경고, 또는 특정 이벤트를 빠르게 확인할 수 있습니다.
DBCC TRACESTATUS 명령어에 대한 자세한 내용은 다음 링크를 참조하세요.
DBCC TRACEON 명령어에 대한 자세한 내용은 다음 링크를 참조하세요.
DBCC TRACEOFF 명령어에 대한 자세한 내용은 다음 링크를 참조하세요.

AES 256 암호화 적용

와탭 DBX 에이전트는 수집된 데이터를 암호화하여 서버로 전송합니다. 데이터의 중요도나 설정에 따라 이를 변경할 수 있습니다. 기본적으로 XOR 연산과 AES 알고리즘을 통한 암호화를 사용하며 평문을 128비트 단위로 나누어 암호화, 복호화를 수행합니다. 사용자 설정에 따라 256비트까지 확장할 수 있습니다.

와탭 DBX 에이전트를 설치한 경로에서 whatap.conf 파일에 다음과 같이 옵션을 추가하세요.

whatap.conf
cypher_level=256

설정을 추가한 다음 에이전트를 다시 시작하세요.

에이전트 이름 설정

자동 설정하기

에이전트 설정(whatap.conf)에서 이름을 설정하지 않으면, 에이전트 이름은 IP 주소와 포트 번호가 결합되어 자동 지정됩니다. 예를 들어, IP 주소가 10.11.12.13이고 포트 번호가 3000이라면, 에이전트 이름은 DBX-12-13-3000으로 설정됩니다.

에이전트 이름을 결정하는 주요 변수는 다음을 참조하세요.

설정	설명
`{type}`	DBX 값을 사용합니다.
`{ip0}`	IPv4 주소 중 첫 번째 단위를 사용합니다. (예시, 10.11.12.13 중 10)
`{ip1}`	IPv4 주소 중 두 번째 단위를 사용합니다. (예시, 10.11.12.13 중 11)
`{ip2}`	IPv4 주소 중 세 번째 단위를 사용합니다. (예시, 10.11.12.13 중 12)
`{ip3}`	IPv4 주소 중 네 번째 단위를 사용합니다. (예시, 10.11.12.13 중 13)
`{port}`	데이터베이스 서버 포트

노트

RDS와 같이 IP 주소가 숫자가 아니라면 DBX-{ip0}-{hash}-{port} 형식으로 이름이 설정됩니다. 여기서 {hash} 값은 IP 주소를 4자리의 16진수로 변환한 값입니다.

수동 설정하기

에이전트 이름을 직접 설정하고 싶다면, whatap.conf 파일에서 whatap.name 또는 object_name 옵션에 원하는 이름을 입력하세요. 사용자가 입력한 이름이 에이전트 이름으로 설정됩니다.

whatap.conf
whatap.name=agent-1234
# or
object_name=agent-1234

기본 옵션​

데이터 수집​

데드락(Deadlock) 관련 옵션​

AES 256 암호화 적용​

에이전트 이름 설정​

자동 설정하기​

수동 설정하기​