직접 설치

WhaTap 데이터베이스 모니터링은 DBX 에이전트가 SingleStore 클러스터에 접속해 지표를 수집합니다. 에이전트는 애그리게이터 노드 한 곳에만 설치하면 되며, 리프 노드는 MV_NODES로 자동 탐지되어 클러스터 전체가 함께 수집됩니다. 모든 노드에 에이전트를 설치할 필요가 없습니다. 이 문서는 에이전트를 직접 설치하고 whatap.conf 파일을 설정하는 기본 방법을 안내합니다. SingleStore 9.0 이상 환경을 대상으로 합니다.

모니터링 계정 생성

DBX 에이전트가 사용할 모니터링 전용 계정을 만들고 다음 권한을 부여하세요.

grant select, process, cluster on *.* to '{모니터링_계정}'@'%';

Privilege	Description
select	모니터링에 필요한 시스템 뷰·테이블 조회
process	실행 중인 세션·쿼리 정보 조회
cluster	클러스터 노드 구성과 분산 상태 조회

MySQL이나 MariaDB 안내에 포함되는 일부 전용 권한은 SingleStore에서는 필요하지 않습니다.

SingleStore 설치는 Manual(수동) 방식을 사용합니다.

DBX 에이전트 다운로드

DBX 에이전트 파일을 다운로드하세요. 다음 두 가지 방법을 이용하세요.

• wget 명령어를 이용해 다운로드할 수 있습니다.

  BASH

  wget -O whatap.agent.database.tar.gz "https://service.whatap.io/download/dbx_agent?type=singlestore&format=tar.gz"

• 명령어로 다운로드할 수 없다면 와탭 모니터링 서비스 화면에서 다운로드 버튼을 선택하세요.

DBX 에이전트 파일을 다운로드한 다음 압축을 해제하세요.

BASH

tar -zxvf whatap.agent.database.tar.gz

노트

보안 설정으로 인해 tar 형식의 파일을 다운로드할 수 없는 사용자를 위해 ZIP 형식의 파일도 함께 제공합니다. 설치 화면에서 .zip 다운로드 버튼을 선택하세요.

whatap.conf 기본 설정

에이전트를 설치한 디렉터리의 whatap.conf 파일에 다음 항목을 설정하세요.

whatap.conf

license={AccessKey}
whatap.server.host={WhaTap_Server_주소}
dbms=singlestore
db_ip={DB_Server_IP}
db_port={DB_Server_Port}

Option	Description
license	프로젝트 Access Key
whatap.server.host	데이터를 전송할 WhaTap Server 주소
dbms	singlestore 고정
db_ip	접속할 SingleStore 애그리게이터 노드 IP
db_port	접속 포트

여기서 헷갈릴 수 있는 부분은 dbms 값입니다. MySQL은 dbms=mysql이지만 SingleStore는 반드시 singlestore로 설정해야 SingleStore 전용 화면이 활성화된다고 설치 가이드에 안내되어 있습니다.

설정 옵션의 자세한 설명은 DBX 에이전트 설정 문서를 참조하세요.

방화벽 설정

DB 서버는 DBX 에이전트가 DB 포트에 접근할 수 있도록 Inbound 접속을 허용하고, DBX 에이전트는 WhaTap Server로 데이터를 전송할 수 있도록 6600 포트 Outbound를 허용해야 합니다. 수집 서버 주소 목록은 지원 환경 문서를 참조하세요.

구분	방향	포트
DBX 에이전트 → DB 서버	Inbound	DB 접속 포트
DBX 에이전트 → WhaTap Server	Outbound	6600

모니터링 시작

설정을 마친 뒤 에이전트를 실행하면 지표 수집이 시작됩니다.