본문으로 건너뛰기

SCP 모니터링

exemONE SCP(Samsung Cloud Platform) 모니터링 설정 가이드

exemONE에서 SCP(Samsung Cloud Platform) 모니터링은 Cloud Database 모니터링을 중심으로 구성됩니다. SCP 환경의 Database OS 리소스 정보를 수집하여 모니터링할 수 있습니다.

1. 사전 준비 사항​

1.1 모니터링 지원 DB​

SCP에서 지원하는 모니터링 대상 데이터베이스:

  • MySQL
  • MariaDB
  • EPAS
  • SQL Server

1.2 네트워크 확인​

아래 도메인에 대해 443 포트 허용이 필요합니다.

도메인용도
operation.samsungcloud.comSCP 운영 API
openapi.samsungsdscloud.comSCP Enterprise용 OpenAPI
s-openapi.samsungsdscloud.comSCP 일반 OpenAPI

openapi URL에 따라 db-agent 파라미터 설정이 필요합니다. (아래 4. OpenAPI URL에 따른 파라미터 변경 참고)

1.3 권한 설정​

SCP 콘솔에서 아래 권한을 설정해야 합니다.

권한관리(IAM):

  • MonitoringView 권한 필요
  • Detail{DBMS} 권한 필요

인증키 관리 > 보안 설정:

  • 인증 방식: 인증키 인증 설정 필요
  • 접근 허용 IP: 수집 서버의 외부 IP 설정 필요 (사용 안 함 설정 시 모든 IP에서 접근 허용)

2. SCP 인증 정보 확인 (단계별)​

SCP 콘솔에서 exemONE 등록에 필요한 정보를 확인합니다.

Step 1. Access Key / Secret Key / Project ID 확인​

  1. SCP 콘솔에서 My > 인증키 관리를 클릭합니다.

  1. 인증키 클릭 > [보기] 버튼 클릭 > 계정 비밀번호 입력 > Access Key, Secret Key를 확인합니다. (인증키가 없으면 새로 생성합니다.)

  1. 인증키 상세에서 프로젝트 ID를 확인합니다.

Step 2. Cluster ID / Product Resource ID 확인​

  1. SCP 콘솔에서 자원관리 > 전체 자원관리를 클릭합니다.

  1. 아래 규칙으로 자원 ID를 구분합니다:
자원 ID 형식매핑 항목
SERVICE-로 시작하는 자원 IDCluster ID
INSTANCE-로 시작하는 자원 IDProduct Resource ID

3. exemONE에서 SCP Database 인스턴스 등록​

Step 1. Database Information 입력​

  1. exemONE에 로그인합니다.
  2. Setting > Platform > Database > Instance로 이동합니다.
  3. Add Instance 버튼을 클릭합니다.
  4. Database Information 섹션에서 다음 항목을 입력합니다:
항목설명
Database Type데이터베이스 타입 선택 (MySQL, SQL Server 등)
Instance Group인스턴스 그룹 선택
Agent에이전트 선택
Enable모니터링 활성화 여부 선택
Instance Name인스턴스 이름 입력
Host Name호스트 IP 입력
PortDatabase Port 번호 입력
DB NameDB 이름 입력
User Name사용자 이름 입력
Password비밀번호 입력
Connection Test데이터베이스 연결 테스트 실행

Step 2. OS Resource - SCP 정보 입력​

OS Information 섹션에서 SCP를 선택하고 다음 항목을 입력합니다.

항목설명확인 방법
OS AgentOS 에이전트 선택 (미선택 시 'default agent' 설정)exemONE 내부
Monitoring Enable클라우드 모니터링 활성화 여부 선택exemONE 내부
Access KeySCP API Access Key 값SCP 콘솔 > My > 인증키 관리
Secret KeySCP API Secret Key 값SCP 콘솔 > My > 인증키 관리
Project IDSCP 프로젝트 ID 값SCP 콘솔 > My > 인증키 관리 > 인증키 상세
Cluster IDDB 서비스 자원 ID (SERVICE-~로 시작)SCP 콘솔 > 자원관리 > 전체 자원관리
Product Resource IDVirtual Server 자원 ID (INSTANCE-~로 시작)SCP 콘솔 > 자원관리 > 전체 자원관리
Connection Test연결 테스트 실행필수 정보 입력 후 활성화

Step 3. 저장 및 확인​

  1. 모든 정보를 입력한 후 Connection Test 버튼을 클릭하여 연결 상태를 확인합니다.
  2. 연결 성공 시 Save 버튼을 클릭하여 인스턴스를 저장합니다.

4. OpenAPI URL에 따른 파라미터 변경​

SCP의 OpenAPI URL에 따라 db-agent의 파라미터를 설정해야 합니다.

4.1 URL별 파라미터 값​

OpenAPI URLEXEMONE_SCP_FOR_ENTERPRISEEXEMONE_SCP_FOR_PG_ENTERPRISE
https://openapi.samsungsdscloud.comtruetrue
https://s-openapi.samsungsdscloud.comfalsefalse

4.2 Docker 환경 파라미터 변경 방법​

  1. {EXEMONE_HOME}/docker-compose.yml 내 services:db-agent:environment 하위에 파라미터를 추가합니다.

  1. db-agent를 재기동합니다.

4.3 Binary 환경 파라미터 변경 방법​

  1. {EXEMONE_HOME}/services/exemone-db-agent/start.sh 내 아래 내용을 추가합니다. (이미 추가되어 있을 경우 스킵)

  1. {EXEMONE_HOME}/services/exemone-db-agent/.env 파일을 생성하여 파라미터를 추가합니다.

  1. db-agent를 재기동합니다.

5. 트러블슈팅: SCP Key 등록 후 정상 동작하지 않는 경우​

증상​

SCP 등록 가이드 진행 후 정상적으로 동작하지 않는 현상

에러 로그 확인​

db-agent 로그:

Get "https://operation.samsungcloud.com/database/postgresql/vl/postgresql/SERVICE-E~~<서비스 명>": Dial top 45.223.140.179:443 : i/o timeout

exemone-api 로그:

~~~~ RsaRequestWrapper - isRequiredEncrypt : scpSecretKey

발생 원인​

수집 서버에서 SCP 도메인 접속 불가

조치 방법​

  1. 수집 서버에서 아래 도메인에 대한 443 포트 접근이 허용되어 있는지 확인합니다.
    • operation.samsungcloud.com
    • openapi.samsungsdscloud.com
    • s-openapi.samsungsdscloud.com
  2. 방화벽/네트워크 설정에서 해당 도메인 접속을 허용합니다.

6. 주의사항​

  • OpenAPI URL 구분이 중요합니다: openapi.samsungsdscloud.com(Enterprise)과 s-openapi.samsungsdscloud.com(일반) URL에 따라 EXEMONE_SCP_FOR_ENTERPRISE 파라미터 값이 달라집니다. 잘못 설정하면 데이터 수집이 되지 않습니다.
  • 자원 ID 형식 확인: Cluster ID는 반드시 SERVICE-로 시작하는 자원 ID, Product Resource ID는 INSTANCE-로 시작하는 자원 ID를 입력해야 합니다.
  • 인증키 보안 설정: 수집 서버의 외부 IP가 접근 허용 IP에 포함되어 있어야 합니다. 설정하지 않으면 i/o timeout 에러가 발생할 수 있습니다.
  • 파라미터 변경 후 재기동 필수: Docker든 Binary든 파라미터 변경 후 반드시 db-agent를 재기동해야 적용됩니다.

참고 문서: