DBX 에이전트 설정

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

whatap-docs

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

db_ip String

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

db_port String

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

클러스터 구성

cluster_name String

클러스터 세트를 정의하는 옵션으로 동일한 cluster_name 옵션 값을 갖는 데이터베이스들은 대시보드 > 인스턴스 목록 메뉴에서 트리 구조로 표시됩니다. 멀티 인스턴스 모니터링 메뉴의 에이전트 선택 옵션에서 클러스터별 에이전트 항목을 선택해 클러스터를 구성하는 인스턴스들끼리 대시보드에 표현되어 한눈에 모니터링할 수 있습니다. 일부 위젯은 클러스터 단위의 정보를 제공합니다. 자세한 내용은 다음 문서를 참조하세요.

데이터 수집

db_param_enabled Boolean

기본값 true

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

conn_fail_count Int

기본값 15

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

idle_as_active Second

기본값 1

세션이 마지막 active 상태였던 이후로 idle 상태를 유지한 시간(초)이 설정값보다 작은 세션들을 active session으로 간주하는 옵션입니다. 예를 들어 설정값이 1이면, 1초 이내에 active였던 세션들이 액티브 세션 창에 나타납니다.

사용자 지표 수집 (SQLMON)

SQLMON으로 사용자 정의 SQL 결과를 주기적으로 수집해 메트릭스로 저장합니다. 결과가 숫자이고 실행 부하가 낮은 쿼리에 적합합니다.

sqlmon Int

기본값 1
- 1 dbx와 sqlmon 동시 실행
- 2 sqlmon만 실행

지원 버전: dbx 2.3.5 이상

설정하기

dbx 에이전트 하위에 sqlmon 디렉터리를 만들고, 수집하려는 쿼리를 <filename>.sql 파일로 생성합니다.

dbx/
└── sqlmon/
    ├── active_sessions.sql
    └── lock_count.sql

수집할 쿼리를 <filename>.sql 파일로 저장합니다.

.sql 파일의 첫 번째 라인에 실행 옵션을, 두 번째 라인부터 SQL 문을 작성합니다.

옵션 형식
주기(분);동작시간;태그명
SQL문

항목	설명	예시
주기	실행 주기(분 단위), 최솟값 `1`	`1` → 1분마다 실행
동작 시간	`HHMM-HHMM` 형식, 쉼표(`,`)로 여러 구간 지정 가능. `0`이면 상시 실행	`0900-1100` → 09:00~11:00에만 실행
태그명	메트릭스에 저장할 태그 이름. 생략 시 파일명이 태그명으로 사용됨	`whatap`

예시: 1분 주기, 09:00~11:00 동작, 태그명 whatap
1;0900-1100;whatap
SELECT count(*) FROM active_sessions

예시: 1분 주기, 상시 동작, 태그명은 파일명 사용
1;0
SELECT count(*) FROM active_sessions

노트

동작 시간은 날짜를 걸쳐 설정할 수 있습니다. (예: 2300-0100 → 23:00~익일 01:00)
태그명을 생략할 경우 동작 시간 뒤에 세미콜론(;)을 붙이지 않습니다.
SQL 문 끝에 세미콜론(;)을 붙이지 않습니다.

whatap.conf에 SQLMON을 활성화합니다.
에이전트를 재기동합니다.
사이트맵 > 메트릭스 조회에서 sqlmon 카테고리를 확인합니다.

# whatap.conf
sqlmon=1

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

기본 옵션​

클러스터 구성​

데이터 수집​

사용자 지표 수집 (SQLMON)​

설정하기​

AES 256 암호화 적용​

에이전트 이름 설정​

자동 설정하기​

수동 설정하기​