데이터베이스

에이전트 네트워크 통신

license

Default : NONE
Type : String
에이전트를 설치할 때 서버로부터 부여받은 라이센스를 지정합니다. 라이센스에는 에이전트가 속한 프로젝트와 보안 통신을 위한 암호 키를 포함하고 있습니다.

whatap.server.host

Default : 127.0.0.1,127.0.0.1
Type : String
에이전트가 수집한 데이터를 전송할 서버를 지정합니다. 수집 서버 이중화로 2개 이상의 IP를 가진 경우 콤마(,)로 분리하여 지정할 수 있습니다. 지정된 IP에는 수집 서버 proxy 데몬이 리스닝 상태로 서비스되어야 합니다.

whatap.server.port

Default : 6600
Type : String
수집 서버 PORT를 지정합니다. 포트는 하나만 지정할 수 있으므로 whatap_server_host에 지정된 수집 서버들은 동일 PORT를 사용해야 합니다.

dbms

Defalut: None
Type : String
모니터링할 데이터베이스의 종류를 지정합니다.
DB의 종류는 다음 중 한 가지를 지정합니다.
oracle, postgresql, mysql, mssql

db_ip

Defalut: None
Type : String
모니터링할 데이터베이스 서버의 ip를 지정합니다.

db_port

Defalut: None
Type : Int
데이터베이스가 통신에 사용하는 포트를 지정합니다.
각 데이터베이스 별 기본 포트는 다음과 같습니다.
oracle: 1521
postgresql: 5432
edb: 5444
mysql: 3306
mssql: 1433

#db

Defalut: None
Type : String
데이터베이스 접속에 필요한 db 명을 지정합니다.
oracle의 경우 SID를 지정합니다.
postgresql과 edb의 경우 지정하지 않으면, 기본값으로 postgres의 db를 사용합니다.
mssql의 경우 지정하지 않으면, 기본값으로 master의 db를 사용합니다.
mysql의 경우는 지정하지 않아도 됩니다.

AWS RDS Cloud Watch 사용

aws_region

Default : None Type : String
AWS 리전을 지정합니다.

aws_access_key

Default : None
Type : String
AWS 엑세스 키를 지정합니다.

aws_secret_key

Default : None
Type : String
AWS 시크릿 키를 지정합니다.

cloud_watch

Default : None
Type : String
cloud watch 모니터링의 유무를 지정합니다. 지정 값은 on 또는 off입니다.

cloud_watch_instance

Default : None
Type : String
cloud watch 인스턴스 명을 지정합니다.

cloud_watch_interval

Default : None
Type : Second
cloud watch로 모니터링 값을 가져올 주기를 지정합니다. (단위: 초)

cloud_watch_metrics

Default : None
Type : String
cloud watch로 가져올 모니터링 지표 이름을 지정합니다.
다음의 값을 지정할 수 있습니다.
cloud_watch_metrics=CPUUtilization,FreeableMemory,FreeStorageSpace,NetworkTransmitThroughput,NetworkReceiveThroughput

애플리케이션 등록

object_name

Default : {type}-{ip2}-{ip3}-{port}
Type : String
애플리케이션을 식별하는 에이전트 이름(ONAME)체계입니다. ONAME을 토대로 OID가 생성됩니다.

  • remark: 다시 시작 필요 (Apache 및 PHP-FPM)

명칭

설명

{type}

whatap.app_name에 설정된 값을 사용합니다.

{ip#}

IP를 나누었을 때 #번째 자리를 사용합니다.

{port}

whatap.app_port_name에 설정된 값을 사용합니다.

{hostname}

서버 호스트명을 사용합니다.

auto_oname_enabled

Default : false
Type : Boolean
서버에 등록될 에이전트 이름(oname)을 서버로부터 자동 부여받는 기능을 활성화합니다. 적용 시, -Dwhatap.name, -Dwhatap.oname 옵션은 무시됩니다. 수집 서버와의 통신을 통해 oname 을 부여받은 이후, 에이전트의 일반적인 동작을 개시합니다.

auto_oname_prefix

Default : agent
Type : String
에이전트 이름을 서버로부터 자동 부여할 때 에이전트 이름의 prefix, 보통 업무 명을 사용합니다. prefix 일련번호 1~) 부여됩니다.

auto_oname_reset

Default : 0
Type : Int
서버로부터 새로운 에이전트 이름을 부여받기 위해서 수정합니다. 에이전트 이름을 자동 부여하면 what.oname이라는 시스템 환경 변수에 설정됩니다. 한번 설정되면 자바 인스턴스가 다시 시작될 때까지 유지됩니다. 리셋을 원할 때 auto_oname_reset 값을 수정합니다.(현재 설정값과 다른 값으로 변경하면 적용됩니다.)

에이전트 데이터 수집

multi_db_stat

Default: 1
Type : Int
multi db의 stat 정보 수집 처리 유무를 지정합니다.
oracle(pluggable db인 경우)과 postgresql에서만 유효합니다.
db instance 내의 각 db 별로 stat을 수집할지의 여부를 지정하게 되며,
수집 부하를 줄이기 위해 0으로 지정할 수 있습니다.

long_run_session_sec

Defalut: 10
Type : Second
지정한 시간보다 길게 수행되고 있는 세션을 long run 세션으로 처리합니다. (단위: 초)

deadlock_interval

Defalut: 1
Type : Int
mysql에서 deadlock 정보를 가져오는 주기를 지정합니다. (단위: 분) deadlock 정보는 주기 동안 발생했던 가장 마지막의 deadlock 정보만을 가져옵니다.

tables_hour

Defalut: 5
Type : Int
테이블 정보를 저장하기 위해 정보를 수집하는 시각을 지정합니다. 기본값으로 5를 사용하며, 새벽 5시에 수집을 하게 됩니다.

tables_min_row

Defalut: 10000
Type : Int
테이블 정보를 수집할 때 지정한 값보다 작은 row 수를 가진 테이블 정보는 수집하지 않습니다.

tables_exclude_sys

Default: false
Type : Boolean
테이블 정보를 수집할 때 sys 소유인 테이블 정보의 수집 유무를 지정합니다.
true로 지정하면 sys 소유의 테이블 정보는 수집하지 않습니다.

stat

Defalut: 하단참조
Type : String
oracle 모니터링 정보중, 수집 처리할 stat 지표들을 콤마로 구분하여 지정합니다.
다음의 값을 기본값으로 사용합니다.
stat=logons current,user commits,session logical reads,CPU used by this session,DB time,enqueue waits,physical reads,physical writes,execute count,db block changes,opened cursors current,parse count (total),parse count (hard),sorts (memory)

event

Defalut: 하단참조
Type : String
oracle 모니터링 정보중, 수집 처리할 event 지표들을 콤마로 구분하여 지정합니다.
다음의 값을 기본값으로 사용합니다.
event=db file sequential read,db file scattered read,enq: TX - row lock contention

exclude_background

Defalut: 3
Type : String
oracle 모니터링 정보 중, 세션 개수 및 세션 리스트를 수집할 때 background 세션의 제외 유무를 지정합니다.
0 : 제외하지 않음.
1 : 세션 리스트 수집 시 background 세션 제외.
2 : 세션 개수 처리 시 background 세션 제외.
3 : 세션 리스트와 개수 처리 시 background 세션 제외.

my_opt

Default: 0
Type : Int
mysql의 data 디렉토리 권한에 따라 performance_schema가 존재 및 사용 가능 상태임에도 불구하고
사용하지 못할 경우가 있으며, 이때에는 dbx 에이전트가 정상 동작하지 않습니다.
이때에 performance_schema를 사용하지 않도록 하려면 1을 지정합니다.

XOS 에이전트 설정에 관한 설정

xos

Defalut: 0
Type : String
xos 에이전트 사용 여부를 지정합니다.
0 인 경우 xos 에이전트 수집 처리를 하지 않습니다.
1 또는 xos 에이전트의 ip를 적어 지정합니다.
ip를 지정할 경우, 지정한 ip의 xos 에이전트로부터만 수집 처리를 합니다.

xos_port

Defalut: 3002
Type : String
xos 에이전트와 통신할 포트를 지정합니다.
xos 에이전트와는 udp로 통신을 하게 되며,
방화벽이 설정되어 있을 경우 지정한 포트의 udp 통신이 될 수 있도록 설정해 주어야 합니다.

xos_cpu_iowait

Default: 1
Type : Int
xos로부터 수집한 cpu 사용률에 iowait의 값을 포함할지를 지정합니다.
1로 지정할 경우 iowait를 포함하고, 0으로 지정하면 iowait를 포함하지 않습니다.

xos_mem_buffcache

Default: 0
Type : Int
xos로부터 수집한 memory 사용률에 buffcache의 값을 포함할지를 지정합니다.
1로 지정할 경우 buffcache를 포함하고, 0으로 지정시 buffcache를 포함하지 않습니다.