설치 및 파라미터 설정
TPM Agent를 설치하는 과정은 다음과 같다. 단, 반드시 관제 데이터베이스를 설치한 계정과 동일한 OS 계정으로 진행해야 한다.
1. 설치 파일 배포
관제 데이터베이스가 위치한 서버에 "tpmagent_dist_{version}.tar.gz" 압축 파일을 배포한 후 압축을 해제한다.
tar -zxvf java_tpmagent_dist_{version}.tar.gz2. application.yml 파일 설정
"java_tpmagent_dist_{version}.tar.gz" 압축 파일을 해제한 디렉터리에 application.yml 파일을 아래와 같이 작성하여 설정을 적용한다. yml 문법에 맞게 각 파라미터들의 값을 조정하여 설정한다.
agent-config:
id: "AAA1"
ip: "192.1.3.225"
port: 8292
freq: 1000
charset: "utf-8"
cpu-mem-proc-freq: 5000
disk-freq: 5000
sessioninfo-freq: 5000
dbsysinfo-freq: 5000
sqltrace-freq: 5000
log:
level: INFO
rotate-time-interval: 24
rotate-file-size: 50MB
max-log-file-number: 7
path: logs/해당 과정에서 설정하는 파라미터에 대한 설명은 다음과 같다.
agent-config
id
인스턴스 ID
[참고] 웹 UI에서 관제 데이터베이스 인스턴스 등록 시 입력한 INSTANCE ID 값과 동일해야 함
O
agent-config
ip
SysMaster DB 8.2 서버에 접속할 수 있는 IP 주소
O
agent-config
port
TPM Agent가 SysMaster DB 8.2 서버의 COLLECTOR_PORT로 연결하기 위한 포트 번호
O
agent-config
freq
수집 주기 (단위: msec).
[참고] 설정하지 않으면 1000ms로 설정되므로 1초 주기로 수집.
X
agent-config
charset
관제 DB의 문자 집합 (NLS_CHARACTERSET 파라미터로 확인).
[참고] 설정하지 않으면 utf-8 로 설정
X
agent-config
cpu-mem-proc-freq
CPU, 메모리, 프로세스 목록 정보를 가져오는 주기(단위: ms) [참고] 설정하지 않으면 "freq" 값으로 설정됨
X
agent-config
disk-freq
디스크 정보를 가져오는 주기 (단위: ms)
[참고] 설정하지 않으면 "freq × 60" 값으로 설정되며, 설정하면 설정한 주기로 수집을 진행
X
agent-config
session-freq
세션 정보를 가져오는 주기 (단위: ms)
[참고] 설정하지 않으면 "freq" 값으로 설정됨
X
agent-config
dbsysinfo-freq
관제 DB의 시스템 지표 정보를 가져오는 주기 (단위: ms)
[참고] 설정하지 않으면 "freq" 값으로 설정됨
X
agent-config
sqltrace-freq
SQL Trace 정보를 가져오는 주기 (단위: ms)
[참고] 설정하지 않으면 "freq" 값으로 설정됨
X
log
level
로그 레벨로
FATAL
ERROR
WARN
INFO
DEBUG
TRACE
[참고]설정하지 않으면 INFO 로 설정됨.
DEBUG 이상 설정을 할 경우 로그양이 많아져 TPM Agent 에 설정한 주기 안에 수집을 하지 못하여 데이터 누락이 발생할 수 있음. 그로 인하여 실시간 데이터 모니터링 중 데이터가 조회되지 않는 현상이 있을 수 있음. 따라서 운영 환경에서는 해당 설정을 하지 않는 것을 권고하며, 이슈 분석을 위해서만 해당 로그 레벨을 설정.
X
log
rotate-time-interval
로그 파일이 아카이빙되는 주기 (단위: h)
적재 중인 로그 파일을 주기마다 아카이빙하고 새로운 로그 파일에 적재
[참고] 설정하지 않으면 24로 설정되므로 하루 주기로 로그 파일 아카이빙
X
log
rotate-file-size
로그 파일이 아카이빙되는 파일 사이즈 (단위: MB)
적재 중인 로그 파일이 해당 파일 사이즈에 도달하면 적재 중인 로그 파일을 아카이빙하고 새로운 로그 파일에 적재
[참고] 설정하지 않으면 50으로 설정되므로 적재 중인 로그 파일이 50MB에 도달하면 로그 파일 아카이빙
X
log
max-log-file-number
아카이빙되는 파일 최대 개수 (단위: 개수)
아카이빙한 파일 개수가 최대에 도달하면 가장 오래 된 로그 파일부터 삭제
[참고] 설정하지 않으면 7로 설정되므로 최대 로그 파일 개수는 7개
X
log
path
로그 파일 생성 디렉터리
[참고] 설정하지 않으면 tpmagent.jar 경로에 logs/ 로 경로 설정
X
Java TPM Agent 지원Charset
Tibero에서 지원하는 문자 집합은 다음과 같다.
ASCII
EUC-KR
MSWIN949
UTF-8
UTF-16
SHIFT-JIS
JA16SJIS
JA16SJISTILDE
JA16EUC
JA16EUCTILDE
VN8VN3
GBK
WE8MSWIN1252
ZHT16HKSCS
CL8MSWIN1251
WE8ISO8859P1
EE8ISO8859P2
WE8ISO8859P9
WE8ISO8859P15
CL8KOI8R
CL8ISO8859P5
CP866
TH8TISASCII
EL8MSWIN1253
EL8ISO8859P7
AR8MSWIN1256
AR8ISO8859P6
SJISTILDE
ZHT16BIG5
ZHT16MSWIN950
GB18030
IW8ISO8859P8
EUC-TW
환경 변수를 통한 설정
"java_tpmagent_dist_{version}.tar.gz" 압축 파일을 해제한 디렉터리에 set.sh 파일에 적용시킬 환경 변 수들이 있으며, 아래와 같이 작성하여 설정을 적용한다.
export BOOT_WITH_AUTO_DOWN_CLEAN=true
export ENABLE_DEBUG=false
export ENABLE_GC_LOG=false
export JAVA_MIN_HEAP_SIZE=300m
export JAVA_MAX_HEAP_SIZE=300m해당 과정에서 설정하는 환경변수에 대한 설명은 다음과 같다.
BOOT_WITH_AUTO_DOWN_CLEAN
TPM Agent 실행시 기존에 실행중인 process가 있으면 해당 프로세스 종료 후 실행할 것인가에 대한 환경 변수, default는 true
X
ENABLE_DEBUG
TPM Agent 실행시 debug port를 열 것인 지에 대한 환경 변수, default는 false
X
ENABLE_GC_LOG
TPM Agent 실행시 jvm gc log를 파일로 생성할 것인가에 대한 환경 변수, default는 false
X
JAVA_MIN_HEAP_SIZE
TPM Agent 실행시 시작 heap 크기 설정에 대한 환경 변수, default는 각 jvm 구현체마다 다르며 보통 현재 머신 메모리의 1/64 이다.
X
JAVA_MAX_HEAP_SIZE
TPM Agent 실행시 최대 heap 크기 설정에 대한 환경 변수, default는 각 jvm 구현체마다 다르며 보통 현재 머신 메모리의 1/4 이다.
X
Last updated