본문으로 건너뛰기

DBX Agent Release Notes

2026-10-22

v2.64.05

MS SQL Server, MySQL, PostgreSQL, Oracle

Feature 락 대기 세션 수(lock_wait_sessions)를 데이터베이스별로 추가 수집

  • 기존 인스턴스 전체 값은 그대로 수집
  • 락 대기가 없는 데이터베이스는 0으로 전송
Oracle

Fixed Oracle 10g 환경에서 락 정보가 수집되지 않던 문제 수정

DB2

Feature 버퍼풀, 로그, 정렬, 카탈로그 캐시, 대기 시간 지표 추가

  • 대상: db_db2_counter, db_db2_bufferpool
  • 버퍼풀: bp_cur_buffsz(버퍼풀별 현재 크기), no_victim_buffer
  • 로그(DB2 10.1 이상): total_log_size, sec_logs_allocated, log_read_time, log_write_time, log_to_redo_for_recovery, log_held_by_dirty_pages
  • 정렬·해시 조인·OLAP(DB2 10.5 이상): total_sorts, sort_heap_allocated, sort_shrheap_top, active_hash_joins, active_olap_funcs
  • 카탈로그 캐시(DB2 10.5 이상): cat_cache_lookups, cat_cache_inserts
  • 대기 시간(DB2 10.5 이상): total_wait_time

Fixed 로그 읽기·쓰기 지표(log_reads, log_writes, log_time)가 항상 0으로 수집되던 문제 수정

Fixed active_sorts를 현재 값이 아니라 증가량으로 수집하던 문제 수정

Changed cat_cache_ratio를 카탈로그 캐시 미스율에서 적중률(%)로 변경

  • 조회가 없는 주기는 100으로 전송

2026-10-18

v2.64.04

SingleStore

Changed 복제 토폴로지 수집 구조 개선

  • 토폴로지 수집을 전용 스레드로 분리해 대형 클러스터에서도 5초 주기 지표(액티브 세션, 카운터 등) 수집이 지연되지 않음. DB 접속 세션 1개 추가
    • topology_interval: 토폴로지 수집 주기, 단위 초 (기본값: 5)
    • topology_heartbeat_interval: 변화가 없어도 전체 스냅샷을 전송하는 주기, 단위 초 (기본값: 300)
    • topology_dbcount_interval: 데이터베이스별 파티션·테이블 수 갱신 주기, 단위 초 (기본값: 60)
  • 수집 소요 시간에 따라 수집 주기를 자동 조절(최대 300초), 회복되면 원래 주기로 복원
  • 토폴로지 조회 쿼리를 나눠 DB 부하 감소. 전송 데이터(행·필드·태그)는 동일
  • 직전 수집과 내용이 같으면 전송 생략. 단, 복제 지연 값(lsn_lag, volume_lag_mb, catchup_s)이 변하는 동안에는 매 수집마다 전송

Feature 파이프라인 수집이 연속으로 실패하면 수집을 중단하는 옵션 추가

  • 파이프라인 통계·에러 수집이 지정 횟수만큼 연속 실패하면 해당 수집 중단. 한 번이라도 성공하면 실패 횟수 초기화
  • pipeline_error_limit: 허용하는 연속 실패 횟수 (기본값: 5). 0 이하로 설정하면 제한 없음

Feature 컬럼스토어 압축률을 계산할 테이블의 최소 크기 옵션 추가

  • compression_min_bytes: 압축률 계산 대상 원본 크기의 하한, 단위 바이트 (기본값: 1048576(1MB)). 0으로 설정하면 하한 없음
  • 원본 크기가 하한보다 작은 테이블은 압축률(compression_percent)을 전송하지 않음
  • 세그먼트 고정 오버헤드 때문에 작은 테이블의 압축률이 왜곡되는 것을 방지

Changed 노드 카운터(db_singlestore_counter)에서 os_other_used_mb, os_other_pct 지표 제거

Fixed 액티브 세션 목록에 모니터링 수집 쿼리가 표시되던 문제 수정

2026-10-06

v2.64.03

MySQL

Fixed SQL 통계의 timer_wait, lock_time 값이 초 단위보다 1000배 작게 수집되던 문제 수정

MySQL, PostgreSQL

Fixed DB 재시작이나 통계 초기화 후 SQL 통계에 음수 값이 수집되던 문제 수정

Fixed SQL 통계를 부하가 낮은 SQL부터 수집하던 문제 수정

  • 수행 시간이 긴 SQL부터 statements_row_limit 건까지 수집
PostgreSQL

Fixed PostgreSQL 17.0에서 SQL 통계가 수집되지 않던 문제 수정

Changed statements_order_by에 정렬 방향을 지정하지 않으면 내림차순(desc)으로 정렬

Oracle

Feature 액티브 세션 수집 시 트랜잭션 정보 조회를 끄는 옵션 추가

  • 옵션: ora_txn_undo (기본값: true)
  • false로 설정하면 v$transaction을 조회하지 않고 undo 정보(undo_segid, undo_blk, undo_rec)를 수집하지 않음
  • 값을 변경하면 에이전트를 재시작해야 적용
Common

Fixed Windows 서비스 설치 스크립트(install_WindowsService.bat)가 괄호가 들어간 경로(예: C:\Program Files (x86))에서 중단되던 문제 수정

Fixed Windows 서비스로 등록한 에이전트가 시작되지 않던 문제 수정

  • JAVA_HOME(또는 JAVA_BIN) 값을 따옴표로 감싸 지정하면(예: "C:\Program Files\Java\jdk") 서비스 등록은 성공하지만 에이전트가 시작 직후 멈추던 현상 해결
  • 설치 스크립트의 Java 확인 단계에서 잘못된 경로를 통과시키던 문제도 함께 수정

2026-10-02

v2.64.02

CUBRID

Fixed 테이블스페이스 크기 지표가 2GB를 넘으면 음수나 비정상 값으로 수집되던 문제 수정

2026-09-30

v2.64.01

DB2

New CachedPlan 실시간 조회 기능 추가

  • Explain Plan을 실행하지 않고 플랜 조회

New CachedPlan 저장 기능 추가

  • db2_plan_saving: 플랜 저장 여부 (기본값: true)
  • db2_plan_elapse: 저장 대상 SQL의 최소 수행 시간, 단위 초 (기본값: 5)
  • db2_plan_max_count: 수집 주기당 조회 상한 (기본값: 50)

New Plan Change 수집 기능 추가

Feature SQL 통계를 실행 계획 단위로 분리

SingleStore

Feature 복제 토폴로지 수집 데이터 확장 및 수집 주기 옵션 추가

  • 파티션 복제와 레퍼런스 복제를 함께 수집
  • topology_interval: 수집 주기, 단위 초 (기본값: 5)

Feature SingleStore 7.3 지원

Feature 테이블 통계 수집 방식을 하루 1회 지정 시각에서 주기 기반으로 변경

  • table_interval: 수집 주기, 단위 시간 (기본값: 1)
  • tables_hour 옵션은 더 이상 사용하지 않음

Feature 파티션별 테이블 통계 수집 주기 단위를 시간으로 통일

  • row_table_interval: 기본값 1 (기존 5분)
  • partition_interval: 기본값 12
  • column_table_interval: 기본값 1

2026-09-02

v2.63.06

Oracle

Fixed 서브파티션으로 구성된 인덱스의 통계 정보가 수집되지 않던 문제 수정

MySQL

Fixed 오래 운영한 환경에서 SQL 통계(statements)가 수집되지 않던 문제 수정

  • performance_schema에 누적된 SQL 실행 시간이 일정 값을 넘으면 수집 작업이 중단
  • 재시작 없이 오래 운영한 DB에서 발생

2026-08-26

v2.63.05

Common

Feature 화면에서 에이전트 설정 조회 및 수정 지원

  • 에이전트 설정 화면에서 whatap.conf 옵션을 확인하고 값 변경
  • 저장 시 설정 파일의 주석, 옵션 순서, 기존 표기 형식 유지
  • 옵션 삭제 시 설정 파일에서 항목이 제거되고 기본값으로 동작

Feature 화면에서 에이전트 재시작 지원

  • 변경한 설정을 적용할 때 서버에 접속하지 않고 화면에서 재시작

Fixed 설정 값에 역슬래시가 포함되면 잘못 저장되던 문제 수정

  • 예: C:\data\whatap이 C:datawhatap으로 적용됨
  • 경로를 값으로 사용하는 옵션(dbx_log_path, cms_token_file, fileview)에 해당

2026-07-29

v2.63.04

SingleStore

Changed 노드 상태를 전용 카테고리 db_singlestore_node_state로 분리 전송

  • 노드별로 5초 주기 전송, 클러스터 뷰의 노드 상태 값을 가공 없이 제공
  • 파티션이 없는 aggregator 노드를 포함한 전체 노드의 상태 확인 가능
  • 기존 db_singlestore_counter의 노드 상태 지표(fatal_count, warning_count) 제거

2026-07-28

v2.63.03

Common

Changed IAM 인증 시 어느 자격증명 경로(고정키/AssumeRole/EC2 Role)로 접속했는지 로그 출력

PostgreSQL, MySQL, MariaDB

Feature 비밀번호 대신 AWS IAM 토큰으로 RDS/Aurora 접속 지원

  • 옵션: aws_iam_auth=true + aws_region
  • 자격증명: 직접 키 / AssumeRole(aws_arn) / EC2 인스턴스 Role
MongoDB

Feature Amazon DocumentDB 5.0+ IAM 인증(MONGODB-AWS) 지원

  • MongoDB 드라이버 4.11.5로 업그레이드(IAM 인증에 4.1+ 필요)
  • $external에 등록한 IAM 유저/역할로 접속
Redis

Feature Amazon ElastiCache(Redis 7+/Valkey 7.2+) IAM 인증 지원

  • 옵션: aws_iam_auth, elasticache_name
  • serverless / 노드 기반 모두 지원(serverless는 CLIENT LIST 미지원으로 액티브 세션 수집 제외)

2026-07-27

v2.63.02

Tibero

Fixed SQL child_number 값이 int 범위를 초과할 때 잘못 수집되던 문제 수정(long 처리)

SingleStore

Feature 클러스터 노드별 상태 모니터링 추가

  • 각 노드(MA/CA/LEAF)의 상태를 online / attaching / down으로 수집
  • 노드 다운 시 fatal_count=1, attaching 시 warning_count=1로 표현
  • 노드별 개별 데이터 전송(노드 OID별 라우팅, heartbeat 포함)

Fixed MySQL SQL 통계가 수집되지 않던 문제 수정

  • 발생버전: 2.59.01(2026-01-21) ~ 2.61.02

2026-07-22

v2.63.01

MySQL, PostgreSQL

Feature DB 복제 토폴로지 수집 추가

  • 복제 구조(클러스터 그룹핑) · 노드 상태 · 원인 정보를 수집하여 토폴로지 화면에서 복제 구성을 시각화

Feature 클러스터 그룹핑 키 자동 인식

  • 기존 replication_name 옵션 미설정 시, 복제 구성에서 그룹핑 키를 자동 인식하여 클러스터를 묶음
  • 자동 인식 지원: MySQL 5.6+(server_uuid 기반), PostgreSQL 9.6+(system_identifier 기반), Galera, Group Replication
  • 자동 인식 미지원(기존처럼 옵션 설정 필요): Aurora MySQL/PostgreSQL, RDS/Azure PostgreSQL, MariaDB 전통 복제, MySQL 5.6 미만, PostgreSQL 9.6 미만
  • 옵션을 설정한 경우 기존과 동일하게 해당 값이 우선(자동 인식 비활성, 클러스터 전 노드에 동일 값 설정)

Changed 인스턴스 목록 세트 묶음 자동 적용

  • replication_name 미설정 환경에서도 자동 인식된 그룹핑 키로 인스턴스 세트가 구성됨(기존에는 옵션 설정 시에만 묶임)
MySQL

Changed failover 시 클러스터 그룹핑 자동 추종

  • master 승격/재지향을 감지하여 그룹핑 키를 자동 갱신(수 초 ~ 1분 내 수렴)
  • 여러 master를 구독하는 멀티소스 slave는 첫 번째 채널 기준으로 그룹핑

Feature Galera 클러스터 토폴로지 지원

  • 쿼럼 상실(non-Primary) · 클러스터 이탈 · 쿼리 거부 상태를 장애로 표시하고, 클러스터 상태 지표를 수집
PostgreSQL

Feature Primary에서 standby별 복제 상세 수집

  • 복제 상태 · 동기 방식 · 지연 정보를 standby별로 수집, replication slot 기반 자동 매칭(slot 미사용 시 db_ip 기준)

Fixed 복제 깨짐 상태에서 replication_delay가 비정상적으로 큰 값으로 표시되던 문제 수정

  • 지연 측정이 불가한 구간(standby 기동 직후, 지연 복제 등)에는 값을 전송하지 않음

Fixed standby 복제 깨짐 상태가 정상으로 전송되던 문제 수정

Fixed Aurora PostgreSQL에서 에이전트 기동 시점에 인스턴스 식별에 실패하면 복제 상태가 계속 수집되지 않던 문제 수정(재접속 시 자동 복구)

2026-06-29

v2.62.03

SingleStore

Feature 에이전트 파일에 JDBC 드라이버 포함(별도 로컬 jar 파일 불필요)

2026-06-24

v2.62.02

MS SQL Server

Fixed SQL Server 2012 이상 환경에서 AlwaysOn 활성 시 topology 데이터 수집 누락 문제 수정

DB2

Fixed wait class 지표 수집 누락 문제 수정

2026-06-23

v2.62.01

Common

Feature AWS IAM 토큰 기반 DB 접속 인증 지원 추가

  • DB 비밀번호 대신 AWS IAM 인증 토큰으로 접속(MySQL/MariaDB/PostgreSQL RDS·Aurora 대상)
  • 옵션명: aws_iam_auth, 기본값: false
  • true 설정 시 IAM 토큰으로 접속, 기본값(false)이면 기존 비밀번호 방식 유지
  • aws_arn 분기 시 whatap.conf에 액세스 키/시크릿 키 직접 입력 가능
SingleStore

Feature SingleStore 데이터베이스 모니터링 신규 지원

  • 분산 노드(Master Aggregator/Child Aggregator/Leaf) 구조 인식 및 노드별 지표 수집
  • 활성 세션, 시스템 정보, 파라미터, 파이프라인, 그룹 카운트 상태, 테이블/파티션 등 수집
  • 제어 명령 지원: 세션 강제 종료(kill), 실행 계획 조회(plan)

v2.61.04

Common

Fixed AIX 등 일부 Unix 환경에서 에이전트 스크립트가 실행되지 않던 문제 수정

Fixed AIX(IBM J9 JVM) 환경에서 에이전트가 부팅되지 않던 문제 수정

2026-06-18

v2.61.03

MySQL

Fixed MySQL SQL 통계가 수집되지 않던 문제 수정

  • 발생 버전: v2.59.01(2026-01-21) ~ v2.61.02

2026-06-01

v2.61.02

MySQL

Feature MariaDB 고유 인증(ed25519 등) 환경을 위한 MariaDB Connector/J 드라이버 지원 추가

  • 옵션명: mariadb_driver, 기본값: false
  • true 설정 시 MariaDB 전용 드라이버(org.mariadb.jdbc)로 접속, 기존 MySQL 드라이버로는 지원하지 않던 ed25519 인증 계정 모니터링 가능
  • 설치 경로의 jdbc/ 디렉터리에 MariaDB Connector/J(3.x) 드라이버 파일 배치 필요
  • SSL이 필요한 환경(예: require_secure_transport=ON)은 connect_option=?sslMode=TRUST와 함께 사용

2026-05-27

v2.61.01

DB2

New Wait class (대기 이벤트) 지표 수집

New Parallel Query (PQ) tree 수집

  • 병렬 처리되는 SQL의 subagent와 coordinator 구조 시각화
  • 지표 수집을 위해 모니터링 계정 권한 추가 필요
    • MON_GET_WORKLOAD
    • MON_GET_PKG_CACHE_STMT
    • WLM_GET_SERVICE_CLASS_AGENTS
    • MON_GET_DATABASE_DETAILS
    • MON_FORMAT_XML_WAIT_TIMES_BY_ROW
    • MON_GET_UNIT_OF_WORK
MS SQL Server

New Always On AG (Availability Group) 토폴로지 수집

  • Primary / Secondary replica 상태, AG 별 sync 상태 시각화

New Failover 자동 감지

  • replica role 변경 시 즉시 db_set_info로 새 상태 전송

2026-05-22

v2.60.12

Common

Changed Windows Service 에이전트 자동 업데이트 후 서비스 자동 재기동 지원

  • 기존: 자동 업데이트 시 서비스가 중지된 채로 남아 수동 재기동 필요

Changed Windows Service 등록 방식 NSSM 기반으로 전환

  • 서비스 중지 시 에이전트(Java) 프로세스 트리째 종료되어 종료 후 프로세스 잔존 문제 해결
  • Oracle Java 환경에서 발생하던 종료 실패 해소
PostgreSQL

Fixed table_bloat_bytes, index_bloat_bytes 설정값이 반영되지 않던 문제 수정

  • 잘못된 키 참조로 사용자 지정값이 무시되던 오류 수정

2026-05-12

v2.60.11

Oracle

Feature Oracle NLS 파라미터 수집 추가(ora_nls_param)

  • 기본값: true
  • true 설정 시 v$nls_parameters 결과(NLS_LANGUAGE, NLS_TERRITORY, NLS_DATE_FORMAT, NLS_CHARACTERSET, NLS_SORT 등)를 기존 파라미터 수집 결과와 함께 전송, 날짜·숫자·통화 포맷, 캐릭터셋, 정렬 순서 등 Oracle 지역화 동작을 진단할 때 사용

2026-05-08

v2.60.10

MySQL

Feature Aurora cascade 구조 지원 — Aurora Writer가 외부 master로부터 binlog를 받는 환경에서 slave 상태(db_mysql_slave) 자동 수집

  • 추가 설정 불필요. cascade 구성 자동 감지

Fixed Seconds_Behind_Master NULL 상태 오탐 수정

  • replication 단절(NULL) 상태를 정상으로 표시하던 케이스 해결

2026-04-27

v2.60.09

CUBRID

Feature Active Session SQL Text를 CUBRID 매니저(gettransactioninfo) 응답에서 직접 수집하는 옵션 추가(cub_disable_xcub_sqltext)

  • 기본값: false
    • false: 기존 동작 유지 — xcub 에이전트가 전달하는 SQL Text 사용
    • true: xcub SQL Text 기능 우회, CUBRID 매니저 응답의 SQL_Text 필드 직접 사용. CUBRID 신버전에서 xcub 없이 SQL Text 수집 가능
  • 주의: true 설정 시에도 xcub는 계속 실행 필요. xcub 패킷 비용을 줄이려면 xcub.conf의 tranlist=0 함께 설정 권장

Feature Active Session SQL Text 수집 디버그 로그 옵션 추가(cub_sqltext_debug)

  • 기본값: false
  • true 설정 시 매 수집 사이클마다 세션별 원문 SQL Text, sql_hash, sql_param을 로그로 출력

2026-04-17

v2.60.08

MS SQL Server

Feature 액티브 세션에서 특정 계정 제외 옵션 지원

  • 옵션명: skip_user
    • 기본값: 비어있음 (미적용)
    • 설정 시 액티브 세션 목록 및 세션 카운트 양쪽에서 해당 계정 제외
    • 복수 계정은 콤마로 구분: skip_user=NT AUTHORITY\\SYSTEM,monitor_user
    • Windows 계정명의 백슬래시는 \\로 입력 (Java Properties 이스케이프 규칙)
Oracle

Fixed tablespace 수집에서 used > usagesize로 수집되는 문제 수정

  • datafile의 size가 maxsize보다 크게 지정된 경우(수동 RESIZE 등에 의해)는 usagesize에 size를 넣어줌

2026-04-14

v2.60.07

PostgreSQL

Fixed 에이전트 기동 후 테이블 사이즈 1회 수집 후 중단 문제 수정

  • v2.60.02에서 발생한 문제

2026-04-13

v2.60.06

Oracle

Fixed 테이블스페이스 사용량(used) 과소 보고 수정

  • free space가 없는 데이터 파일에서 used가 0으로 표시되는 문제 수정

Changed 테이블스페이스 수집 시 OFFLINE 상태 데이터 파일 제외

  • 접근 불가한 OFFLINE 파일로 인한 수집 오류 방지

Feature ASM Disk 용량 수집 추가

2026-04-10

v2.60.05

Redis

Feature skip_whatap_session 옵션 추가

  • true 설정 시 액티브 세션 목록에서 whatap 세션 숨김

2026-03-26

v2.60.04

Tibero

Fixed pga_used_mem 지표의 데이터 타입 변경

2026-03-23

v2.60.03

SQLMON

Feature 파일별로 category를 지정할 수 있는 기능 추가

2026-03-06

v2.60.02

Oracle

Feature tablespace 카테고리에 usagesize 지표 추가

  • 데이터 파일의 autoextensible 여부에 따라 YES이면 maxbytes, NO이면 bytes를 파일 크기로 적용
  • 전체를 합산하여 테이블스페이스의 usagesize로 산출

2026-03-05

v2.60.01

PostgreSQL

Feature 테이블 및 인덱스 hit ratio 수집 여부 설정 옵션 추가

  • 옵션명: collect_hit_ratio_metrics
  • 기본값: true
DB2

Changed DB2 수집 쿼리를 모든 멤버 정보 조회 방식에서 현재 DB 인스턴스 정보만 조회하도록 변경

2026-02-11

v2.59.04

MongoDB, Redis, DB2, SAP ASE

Feature delta 옵션 추가

  • 옵션명: delta
  • 기본값: 2
  • 기본 수집 주기마다 계산된 델타 값을 저장하는 방식을 설정합니다.
    • 1: 계산된 델타 값을 초당 값(per-second)으로 환산하여 저장
    • 2: 기본 수집 주기 기준의 델타 값 그대로 저장
SAP ASE

Fixed 지표 수정: PagesRead, RowsDeleted, RowsUpdated

DB2

Fixed hit ratio 관련 지표 계산 방식 개선

  • 옵션명: includePrefetch
  • 기본값: true
  • false: 기존방식 유지
    • (logical_reads - physical_reads) / logical_reads * 100
  • true: 동기페이지 적중(pages_found_sync) 기준으로 계산
    • pages_found_sync / logical_reads * 100

2026-02-10

v2.59.03

Oracle

Fixed 테이블 레이아웃 수집 시 인덱스 정보 중복되는 문제 수정

PostgreSQL

Feature table size 수집 타임아웃 발생 시 30분 간격으로 3회까지 retry 기능 추가

2026-02-09

v2.59.02

MySQL, MS SQL Server, CUBRID, Altibase, Tibero

Feature delta 옵션 추가

  • 옵션명: delta
  • 기본값: 2
  • 기본 수집 주기마다 계산된 델타 값을 저장하는 방식을 설정합니다.
    • 1: 계산된 델타 값을 초당 값(per-second)으로 환산하여 저장
    • 2: 기본 수집 주기 기준의 델타 값 그대로 저장

2026-01-21

v2.59.01

MySQL

Changed MySQL 통계(db_mysql_statements) 수집 개선

  • 기존 수집 기준에서 overflow가 나는 문제 개선

기존

sum_rows_affected+ sum_rows_sent+ sum_rows_examined>10000

변경

sum_rows_affected>=10000
OR sum_rows_sent>=10000
OR sum_rows_examined>=10000
  • 수집 건수를 제어할 수 있도록 limit 옵션 추가
    • statements_row_limit = 5000
  • 에이전트 기동 직후 최초 SQL 통계 수집 단계에서, 불필요한 sql_text 조회를 제거하여 초기 수집 부하를 개선

Changed Table Size 수집 시 limit 조건을 >에서 >=로 수정하여 경계값 누락 문제 개선

PostgreSQL

Changed PostgreSQL 통계(db_postgresql_statements) 수집 개선

  • 에이전트 기동 직후 최초 SQL 통계 수집 단계에서, 불필요한 sql_text 조회를 제거하여 초기 수집 부하를 개선

Changed frozenxid, seq_scan, idx_scan 수집을 기존 인스턴스 단위 수집에서 DB별 수집 방식으로 개선

Oracle

Changed db_oracle_tablespace의 써머리 데이터 생성을 위해 _no_5m_hour 필드 제거

최종 수정: