본문으로 건너뛰기

SingleStore 모니터링

exemONE SingleStore(MemSQL) 모니터링 상세 가이드

1. 지원 버전​

참고 문서: SingleStore 모니터링 지원 버전, DB Agent 지원 환경

SingleStore 버전​

SingleStore 버전지원 여부비고
8.9 이상✅ 지원기본 모니터링 가능
8.9 미만⚠️ 확인 필요별도 검증 필요

exemONE 필요 모듈 버전​

SingleStore 모니터링을 위해 아래 exemONE 모듈 버전이 필요합니다:

모듈최소 버전
exemone-apiv3.0.508.99
exemone-ingesterv3.0.508.27
exemone-alerterv3.0.508.42
exemone-corev3.0.508.36
exemone-frontv3.0.508.77
exemone-receiverv3.0.508.11
exemone-db-agentv3.0.508.42

2. 필수 권한​

참고 문서: SingleStore 모니터링 권한

권한 부여 SQL​

GRANT USAGE, SHOW METADATA, PROCESS, CLUSTER, SHOW ROUTINE ON *.* TO exemone;

권한별 상세 용도​

권한용도 (조회 대상 테이블/기능)
USAGE기본 접속 권한
SHOW METADATA(MV_)DISTRIBUTED_DATABASES(_STATUS), MV_CLUSTER_STATUS, MV_PROCESSLIST, MV_TASKS, MV_ACTIVITIES_EXTENDED_CUMULATIVE, MV_EVENTS, MV_DISK_USAGE, MV_BOTTOMLESS_REMOTE_STATS
PROCESSMV_PROCESSLIST, MV_TASKS, MV_QUERIES, MV_ACTIVITIES_EXTENDED_CUMULATIVE, MV_PLANCACHE, KILL_QUERY
CLUSTERMV_EVENTS, MV_DISK_USAGE, MV_DATA_DIS_USAGE, MV_BOTTOMLESS_API_EVENTS, MV_BOTTOMLESS_STATUS_EXTENDED
SHOW ROUTINEROUTINES, AGGREGATE_FUNCTIONS, SHOW CREATE FUNCTION, SHOW CREATE PROCEDURE

개별 권한 부여 SQL (참고)​

GRANT USAGE ON *.* TO exemone;

GRANT SHOW METADATA ON *.* TO exemone;

GRANT PROCESS ON *.* TO exemone;

GRANT CLUSTER ON *.* TO exemone;

GRANT SHOW ROUTINE ON *.* TO exemone;

3. 사전 설정​

참고 문서: SingleStore 모니터링 사전 설정

Plan 조회를 위한 파라미터 설정​

SingleStore에서 Plan 조회 기능(Show Plan {Plan ID})을 사용하려면 아래 DB 파라미터 설정이 필요합니다:

enable_disk_plan_explain=ON
항목내용
파라미터enable_disk_plan_explain
설정값ON
용도Plan 조회 기능 활성화 (Show Plan {Plan ID})
주의사항활성화 시 디스크/메모리 사용량이 소폭 증가할 수 있음

해당 파라미터가 비활성화(OFF)되어 있을 경우, Plan 조회 기능은 지원되지 않으며 아래와 같은 안내 문구가 출력됩니다:

4. 모니터링 등록 방법​

참고 문서: SingleStore 모니터링 등록 방법

Step 1) Instance Group 생성​

Setting > Database > Instance Group에서 SingleStore로 그룹을 추가합니다.

Step 2) Instance 추가 및 Node List 호출​

Instance 추가 화면에서 아래 정보를 입력한 후 [Get List] 버튼을 클릭하여 Node List를 호출합니다:

  • Cluster Name: 클러스터 명
  • Master Aggregator IP: Master Aggregator의 IP 주소
  • Master Aggregator Port: Master Aggregator의 포트
  • ID: 모니터링 계정 ID
  • Password: 모니터링 계정 비밀번호

Step 3) Node List 확인 및 Instance Alias 설정​

Get List 성공 시 {Cluster명} - List of nodes included in the cluster. 안내 문구가 출력되며, 각 노드에 대해 Instance Alias를 지정할 수 있습니다.

  • Instance Name 규칙: {Cluster명}_{Role}-{NodeId} (변경 불가)

Step 4) Instance List 확인​

등록 완료 후 Instance List에서 등록된 SingleStore 인스턴스를 확인합니다.

5. 참고사항 및 주의사항​

참고 문서: SingleStore 모니터링 참고사항

5-1. 수집 주기가 긴 데이터 즉시 수집​

싱글스토어는 수집 주기가 긴 데이터가 있습니다. 인스턴스 등록 시 즉시 데이터를 수집하고 싶은 경우 Custom Configuration에서 아래 옵션을 설정합니다:

common.once_collect_at_starting=true
옵션설명
common.once_collect_at_startingtrue로 설정 시 모니터링 시작 시 즉시 데이터 수집

설정 경로: Setting > Database > Edit Instance > Custom Configuration

5-2. 멀티 클러스터 환경에서 Instance Name 중복​

싱글스토어 클러스터가 여러 대일 경우, 노드 불러오기 시 클러스터 간 인스턴스 이름이 중복으로 확인되는 현상이 있습니다. 이 경우 Instance Alias를 별도로 설정하여 구분해야 합니다.

추후 {사용자가 지정한 Cluster명}_{Role}-{NodeID} 규칙에 맞게 저장되도록 수정 예정

5-3. Query History 수집 제한​

싱글스토어 Query History 수집 시, 1분 이상 수행되거나 1분 이상의 간격으로 수행되는 쿼리의 경우 delta 서머리 처리가 정상적으로 진행되지 않을 수 있습니다. 이는 고객사 운영 환경에서의 Query History 데이터 양 확인 이후 개선 예정입니다.

5-4. 참고사항 적용 대상 모듈 버전​

위 참고사항이 적용된 모듈 버전은 다음과 같습니다:

모듈버전
exemone-apiv3.0.508.119
exemone-ingesterv3.0.508.35
exemone-alerterv3.0.508.54
exemone-corev3.0.508.45
exemone-frontv3.0.508.108
exemone-receiverv3.0.508.16
exemone-db-agentv3.0.508.57

5-5. 기타​

  1. Plan 조회 시 enable_disk_plan_explain=ON 파라미터 활성화가 필요하며, 이로 인한 디스크/메모리 사용량 소폭 증가에 대해 사전 안내가 필요합니다.
  2. Cloud 환경에서의 SingleStore 모니터링은 Cloud 모니터링 지원 표에 포함되어 있지 않으므로, On-Premise 환경에서의 사용을 기본으로 합니다.
  3. SingleStore는 클러스터 기반 데이터베이스로, Master Aggregator 정보를 통해 전체 노드를 자동으로 검색하여 등록하는 방식입니다. 개별 노드를 수동으로 등록하는 것이 아닌 [Get List] 기능을 통한 일괄 등록이 필요합니다.