본문으로 건너뛰기

설치 문제 해결

데이터베이스 에이전트 설치 시 발생할 수 있는 문제를 확인해 보세요.

방화벽 설정 확인​

방화벽 차단을 해제하세요. 와탭 서버에 대한 TCP 아웃바운드 방화벽이 설정되어 있으면 모니터링 정보를 서버로 전송할 수 없습니다.

방화벽 확인 방법​

telnet 명령어를 수행해 다음과 같은 접속 관련 정보가 표시되어야 정상입니다. (telnet [서버 IP] [서버 포트])

Example
$ telnet 52.193.60.176 6600
Trying 52.193.60.176...
Connected to 52.193.60.176.
Escape character is '^]'.
노트

와탭 수집 서버 정보는 관리 > 에이전트 설치 메뉴에서 확인할 수 있습니다.

에이전트 로그 확인하기​

에이전트가 데이터베이스에 접속하지 못하거나 일부 데이터가 수집되지 않으면 먼저 에이전트 로그를 확인하세요. 아래 항목은 로그에 남는 메시지를 기준으로 원인과 해결 방법을 안내합니다.

  • logs/: 에이전트 설치 경로에 생성되는 에이전트 로그 폴더입니다.
  • nohup.out: 에이전트 실행에 실패했을 때 먼저 확인할 표준 출력 기록입니다. ./startd.sh로 실행하면 에이전트 설치 경로에 생성됩니다.

설정 파일(whatap.conf)이나 JDBC 드라이버를 바꾼 뒤에는 에이전트를 다시 시작하세요.

BASH
./stop.sh
./startd.sh

데이터베이스에 접속할 수 없는 경우​

계정 정보가 등록되지 않은 경우​

에이전트 로그
File not exist or Invalid file: db.user

모니터링 계정 정보 파일(db.user)이 없습니다. 계정 정보 없이 접속을 시도하다 에이전트가 종료될 수 있습니다. 에이전트 설치 경로에서 uid.sh로 계정 정보를 등록한 뒤 ./startd.sh로 에이전트를 실행하세요.

BASH
./uid.sh {DB_USER} {DB_PASSWORD}

계정 이름 또는 비밀번호가 맞지 않는 경우​

에이전트 로그
Access denied for user 'whatap'@'<에이전트 IP>' (using password: YES)
CRITICAL! : DB Connection FAILED. Invaild username or password.
DB Account error!!!

이 오류로 접속에 반복해서 실패하면 에이전트가 종료됩니다. 다음 내용을 확인한 뒤 uid.sh로 계정 정보를 다시 등록하고 ./startd.sh로 에이전트를 실행하세요.

  • 등록한 비밀번호가 데이터베이스 계정의 비밀번호와 같은지 확인하세요.
  • 로그에 표시된 '계정'@'IP'가 데이터베이스 계정의 접속 허용 호스트(mysql.user의 host)에 포함되는지 확인하세요.
에이전트 로그
Communications link failure
The driver has not received any packets from the server.

에이전트 서버에서 데이터베이스 포트로 연결할 수 없는 상태입니다. 데이터베이스 실행 상태와 포트, 방화벽, whatap.conf의 db_ip, db_port 값을 확인하세요. 에이전트는 종료되지 않고 계속 다시 연결을 시도하며, 문제가 해결되면 자동으로 다시 연결됩니다.

연결 확인 예시
nc -zv {DB_IP} 3306

JDBC 드라이버 버전이 맞지 않는 경우​

에이전트 로그 예시
WARN: Establishing SSL ...
Communications link failure
The last packet successfully received from the server was ... ago.
에이전트 로그 예시
Unable to load authentication plugin 'caching_sha2_password'.

jdbc/ 폴더에 드라이버가 없어 에이전트에 포함된 기본 드라이버로 접속하면 MySQL 8.0 이상에 연결하지 못할 수 있습니다. jdbc/ 폴더에 Connector/J 8.0 이상 드라이버(.jar)를 넣고 에이전트를 다시 시작하세요. JDBC 다운로드

SSL 연결이 필요한 데이터베이스인 경우​

에이전트 로그
Connections using insecure transport are prohibited while --require_secure_transport=ON.

데이터베이스가 SSL 연결만 허용하는데(require_secure_transport=ON) whatap.conf의 connect_option에 useSSL=false가 설정되어 있습니다. connect_option에서 useSSL=false를 제거하고 에이전트를 다시 시작하세요.

공개 키 조회가 허용되지 않은 경우​

에이전트 로그
Public Key Retrieval is not allowed

평소에는 정상으로 접속되다가 데이터베이스를 다시 시작하거나 FLUSH PRIVILEGES를 실행한 뒤에 발생할 수 있습니다. connect_option에 useSSL=false를 설정하고 caching_sha2_password 인증을 쓰는 계정으로 접속할 때 나타납니다. 다음 중 하나로 설정하고 에이전트를 다시 시작하세요.

  • connect_option에서 useSSL=false를 제거합니다. (권장)

  • SSL을 사용할 수 없다면 allowPublicKeyRetrieval=true를 함께 설정합니다. 이 옵션은 접속 경로가 신뢰할 수 있는 네트워크일 때만 사용하세요.

    whatap.conf
    connect_option=?useSSL=false&allowPublicKeyRetrieval=true

일부 데이터가 수집되지 않는 경우​

데이터베이스에는 접속했지만 모니터링 계정에 권한이 부족하면 해당 데이터만 수집되지 않고, 에이전트 로그에 command denied, lack rights, you need ... privilege(s) 메시지가 남습니다. 에이전트는 종료되지 않습니다. 다음 명령어로 모니터링 계정의 권한을 확인하세요.

SQL
SHOW GRANTS FOR 'whatap'@'%';
에이전트 로그필요한 권한수집되지 않는 데이터
SELECT command denied ... for table 'threads' 등 performance_schema 테이블grant select on performance_schema.* to whatap;액티브 세션, 대기 이벤트, 락 정보
SELECT command denied ... for table 'innodb_lock_waits'grant select on sys.* to whatap;락 정보
View 'sys.innodb_lock_waits' ... lack rightsgrant process on *.* to whatap;
performance_schema 권한도 함께 확인		락 정보
you need (at least one of) the PROCESS privilege(s)grant process on *.* to whatap;데드락 정보, 다른 계정의 세션 정보
you need (at least one of) the ... REPLICATION CLIENT privilege(s)
you need ... REPLICATION SLAVE privilege(s)		grant replication client on *.* to whatap;
grant replication slave on *.* to whatap;		복제(Replication) 정보

권한을 부여한 뒤 에이전트를 다시 시작하세요. 권한별로 지원하는 기능은 계정 생성의 권한에 따른 지원 기능 살펴보기를 참조하세요.

제약 사항​

복수 리전을 단일 프로젝트로 선택 불가​

  • 와탭 모니터링 서비스 사이트에서 프로젝트 생성 시 지역(Region)은 중복 선택할 수 없으며, 복수의 지역(Region)을 활용하는 경우 별도의 프로젝트를 생성해야 합니다.

  • 클라우드 환경과 같이 복수의 지역(Region)에 서버가 존재하는 경우 네트워크 latency 등 성능 정보 수집상의 제약 사항을 회피하기 위해 지역(Region) 단위로 수집 서버를 위치시켜야 합니다.

  • 와탭은 고객 요구 사항에 부응하기 위해 지역(Region)별로 수집 서버를 구축합니다.

에이전트 이름(ONAME) 중복 사용 불가​

와탭 DBX 모니터링은 에이전트의 식별을 위해 에이전트의 IP 주소와 포트(Port) 정보를 이용합니다. 사용자 환경의 모니터링할 데이터베이스 서버가 동일 IP, 동일 포트(Port)를 사용한다면 와탭 서버에서 해당 서버 인스턴스를 구분할 수 없습니다.

  • 서버 인스턴스가 동적으로 확장되는 환경이 아니라면 다음 문서를 참조해 데이터베이스 식별을 위한 명칭을 직접 설정해 우회할 수 있습니다.

  • 모니터링할 데이터베이스의 internal address 또는 네트워크 가상화로 인해 중복된 IP를 이용할 경우 다음 문서를 참조해 별도의 데이터베이스 이름 패턴을 활용하세요.

최종 수정: