DBX 에이전트 설정
이 문서는 Oracle 모니터링 V2를 기준으로 작성했습니다. Oracle 모니터링 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
oracle
주의다른 옵션 값을 입력할 경우 모니티링을 위한 데이터 수집이 정상 작동하지 않을 수 있습니다.
-
db_ip String
모니터링할 데이터베이스 서버의 IP 주소를 설정합니다.
-
db_port String
데이터베이스가 통신에 사용하는 포트를 설정합니다.
데이터 수집
-
replication_name String
리플리케이션 이름을 설정하면 동일한
replication_name
을 갖는 DB 사이에 Master/Slave 관계가 있는 것으로 간주합니다.리플리케이션 세트를 정의하는 옵션으로 마스터, 슬레이브 노드에 모두 동일한 값의
replication_name
옵션을 설정하면 인스턴스 모니터링에서 트리 구조로 표시됩니다. 또한 이 옵션 값을 기준으로 Flex 보드에서 리플리케이션 상태를 모니터링하는 위젯을 제공합니다.
-
skip_whatap_session Int
기본값
0
1
을 설정하면 와탭에서 수집하기 위한 query가 동작하는 세션을 active session list에 표시하지 않습니다.(기본값: 0)
-
ora_ratio Boolean
DBX agent v1.6.11 or later
기본값
false
각종 ratio 지표를 추가로 수집할 수 있습니다. 수집하는 지표는 다음과 같습니다.
buffer cache hit ratio
soft parse ratio
hard parse ratio
library cache hit ratio
library cache pin hit ratio
library cache get hit ratio
latch hit ratio
shared pool free mem ratio
-
interval_sec Boolean
DBX agent v1.7.3 or later
기본값
true
에이전트에서 5초 단위로 수집한 데이터를 초 단위(
delta
1초 값)로 환산해 보고하는 옵션입니다. -
segments Boolean
기본값
true
세그먼트 사이즈 정보를 수집합니다. 통계/보고서 > 테이블스페이스 사이즈 메뉴에서 해당 데이터베이스 또는 테이블스페이스를 선택하면 사이즈 정보를 확인할 수 있습니다.
-
segments_hour Int
기본값
5
세그먼트 사이즈 정보를 수집하는 시각을 설정합니다. 기본값으로
5
이며 새벽 5시에 수집을 시작합니다. -
segments_min_size Int
기본값
10
세그먼트 사이즈 정보를 수집하는 최소 단위로 기본값은 10MB 입니다. 세그먼트 사이즈 정보를 수집할 때 설정한 값보다 작은 크기의 세그먼트 사이즈 정보는 수집하지 않습니다.
-
segments_exclude_sys Int
기본값
1
sys에 해당하는 계정을 제외하고 사이즈 정보를 수집합니다.
-
segments_sys String
기본값 'SYS', 'OUTLN', 'SYSTEM', 'AUDSYS', 'DBSNMP', 'GSMADMIN_INTERNAL', 'XDB', 'WMSYS', 'OJVMSYS', 'CTXSYS', 'ORDSYS', 'ORDDATA', 'MDSYS', 'LBACSYS', 'DVSYS', 'DBSFWUSER', 'APPQOSSYS', 'OLAPSYS'
sys에 해당하는 계정 목록입니다. 위 계정에 추가하고 싶으면
segments_sys+='xxx'
로 추가할 수 있습니다. -
segments_max_count Int
기본값
50
테이블스페이스 별로 사이즈가 큰 세그먼트 50개만 수집하여 저장합니다.
-
xview_min_sec Int
기본값
0
xview 수집 시, 쿼리의 수행 시간이 설정된 시간보다 오래 걸릴 때만 수집합니다. 기본 설정으로는 수행 시간이 0초 이상인 모든 쿼리를 수집합니다.
AWS RDS CloudWatch 적용
AWS CloudWatch를 이용하는 에이전트 설정에 대한 설명입니다. 수집을 시작하면 메트릭스에 포함되며, 관리 > 메트릭스 차트 메뉴의 db_oracle_counter
카테고리에서 다른 지표들과 함께 확인할 수 있습니다.
클라우드 설정 메뉴를 통해 더 쉽고 직관적으로 설정할 수 있습니다. 이 메뉴를 통해 클라우드 서비스에서 제공하는 모니터링 지표를 데이터베이스 프로젝트의 대시보드에서 추가로 수집하고 모니터링할 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.
-
aws_region String
AWS 리전을 설정합니다.
-
aws_arn String
AWS 인증을 위해 적절한 권한을 가진 IAM ROLE의 ARN을 사용할 수 있습니다.
필수 권한
ROLE은 다음의 권한(Policy)이 필요합니다.
권한 권한 내용 rds:DescribeDBInstances 인스턴스 클래스 정보 수집 rds:DescribeDBClusters autoscale 사용 시 클러스터의 정보 수집 rds:DescribeDBLogFiles CloudWatch 로그 수집 rds:DownloadDBLogFilePortion CloudWatch 로그 수집 ec2:DescribeInstanceTypes 인스턴스 클래스에 해당하는 cpu 개수 수집 elasticache:DescribeCacheClusters elasticache 이용 시 인스턴스 클래스 정보 수집 cloudwatch:ListMetrics CloudWatch 지표 리스트 수집 cloudwatch:GetMetricStatistics CloudWatch 지표의 값 수집 logs:DescribeLogStreams CloudWatch 로그 수집(게시된 로그 기능 사용 시) logs:GetLogEvents CloudWatch 로그 수집(게시된 로그 기능 사용 시) -
cloud_watch String
CloudWatch 모니터링의 유무를 설정합니다. 설정 값은
on
또는off
입니다. -
cloud_watch_instance String
CloudWatch 인스턴스 명을 설정합니다.
-
cloud_watch_interval Second
CloudWatch로 모니터링 값을 가져올 간격을 설정합니다. (단위: 초)
-
cloud_watch_metrics String
CloudWatch로 가져올 모니터링 지표 이름을 설정합니다. 다음과 같이 설정할 수 있습니다.
cloud_watch_metrics=CPUUtilization,FreeableMemory,FreeStorageSpace,NetworkTransmitThroughput,NetworkReceiveThroughput