직접 설치
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에서는 필요하지 않습니다.
DBX 에이전트 다운로드
설치 화면에서 운영체제에 맞는 DBX 에이전트를 내려받으세요. SingleStore 설치는 Manual(수동) 방식을 사용합니다.
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 에이전트 설정 문서를 참조하세요.
방화벽 설정
DBX 에이전트에서 WhaTap Server로 향하는 6600 포트 Outbound를 허용해야 합니다.
| 구분 | 방향 | 포트 |
|---|---|---|
| DBX 에이전트 → WhaTap Server | Outbound | 6600 |
모니터링 시작
설정을 마친 뒤 에이전트를 실행하면 지표 수집이 시작됩니다.