본문으로 건너뛰기

패키지 매니저 설치

패키지 매니저를 이용한 와탭 데이터베이스 모니터링 에이전트 설치 방법을 안내합니다.

팁

설치 방법 선택

  • apt 패키지 매니저를 사용하는 Debian/Ubuntu 계열 시스템의 경우 이 문서를 참고하세요.
  • Docker 환경에서는 Docker 설치를 참고하세요.
  • 기타 환경에서는 직접 설치를 참고하세요.
노트

지원 데이터베이스

MySQL, PostgreSQL, SQL Server

와탭 모니터링 서비스를 사용하려면 회원 가입 후 프로젝트를 생성하고, 모니터링 대상 서버에 에이전트를 설치해야 합니다. 회원 가입에 관한 자세한 내용은 다음 문서를 참고하세요.

프로젝트 생성하기​

에이전트를 설치하기 전에 먼저 프로젝트를 생성하세요.

  1. 와탭 모니터링 서비스에 로그인합니다.

  2. 왼쪽 사이드 메뉴에서 전체 프로젝트 > + 프로젝트 버튼을 클릭합니다.

  3. 상품 선택 화면에서 설치할 제품을 선택합니다.

  4. 아래 항목을 입력하거나 선택합니다.

    • 프로젝트 이름: 프로젝트의 이름을 입력합니다.

    • 데이터 서버 지역: 데이터 서버가 위치한 리전을 선택합니다. 리전은 클라우드 서비스를 제공하는 데이터 센터의 묶음입니다. 선택한 리전에 사용자의 데이터가 저장됩니다.

    • 타임 존: 알림 및 보고서 생성 시 기준이 되는 시간을 설정합니다.

    • 알림 언어 설정: 경고 알림 메시지의 언어를 설정합니다. (한글, 영어 지원)

    • 프로젝트 그룹: 여러 프로젝트를 그룹으로 묶어 관리할 수 있습니다. 소속될 그룹이 있으면 선택하세요.

    • 프로젝트 설명: 프로젝트에 대한 추가 설명이나 세부 정보를 입력합니다.

  5. 모든 설정을 완료하면 프로젝트 생성하기 버튼을 클릭합니다.

노트

조직을 선택한 상태에서 프로젝트를 추가할 경우 조직 하위 그룹을 필수로 설정해야 합니다.

그룹에 대한 자세한 설명은 다음 문서를 참고하세요.

구성도 확인​

DBX 에이전트는 별도 서버에 설치하거나 DB 서버에 설치할 수 있습니다. 설치할 방식을 선택하고 구성과 방화벽을 확인하세요.

별도 서버에 설치DB 서버에 같이 설치

계정 생성​

데이터베이스 모니터링을 하기 위해 필요한 권한을 가진 계정을 생성하세요. root(admin) 계정으로 로그인해 계정을 생성하세요.

노트

  • 권한을 가진 계정이 있다면 이 단계를 생략하고 다음 단계로 넘어가세요.

  • 예시 코드에서 DB_User는 DB 사용자 계정 이름입니다. 사용자가 이용하는 사용자 계정 이름으로 변경하세요.

  • 예시 코드의 DB_Password에는 사용자 비밀번호를 입력하세요.

기능 및 사용 환경에 따라 추가 권한을 부여하세요.

  • PostgreSQL 10 버전 이상

    SQL
    create user DB_User with password 'DB Password'; 
    grant pg_monitor to DB_User;

  • PostgreSQL 10 버전 미만

    SQL
    create user DB_User with password 'DB Password';
    alter user DB_User with superuser;

  • Kill session 기능을 사용할 경우 (10 버전 이상)

    데이터베이스 모니터링에서는 진행 중인 세션을 종료할 수 있는 Kill Session 기능을 제공합니다. 이 기능을 사용하려면 다음과 같이 권한을 설정하세요.

    SQL
    grant pg_signal_backend to DB_User;

  • 테이블 사이즈를 수집하는 경우 (통계/보고서 > 데이터베이스 사이즈 > 테이블 사이즈 (TOP 50))

    SQL
    grant usage on schema {schema_name} to DB_User;
    노트

    개별 DB마다 명령어를 수행해야 합니다.

  • 오브젝트 정보를 조회하는 경우 (분석 > Top 오브젝트)

    SQL
    grant select on all tables in schema {schema_name} to DB_User;
권한에 따른 지원 기능 살펴보기

기본 권한 외의 권한은 사용자의 환경에 따라 부여하지 않아도 됩니다. 단, 일부 기능이 동작하지 않을 수 있습니다.

권한command메뉴 및 기능상세 내역
기본 권한grant pg_monitor to whatap;인스턴스 모니터링 / 멀티 인스턴스 모니터링 / SQL 통계grant pg_read_all_stats,pg_read_all_settings to DB_User; 와 동일
상세 권한grant usage on schema {schema_name} to whatap;데이터베이스 사이즈 / 테이블 사이즈 (TOP 50)해당 DB의 모든 스키마에 대해 권한 필요
grant select on all tables in schema {schema_name} to whatap;테이블 레이아웃 조회-
grant pg_read_all_settings to whatap;파라미터 조회특정 파라미터 값이 보이지 않을 수 있음
세션 킬grant pg_signal_backend to whatap;액티브 세션 > 세션 킬PostgreSQL 9.6 버전 이하는 superuser 권한 필요

액세스 키 확인​

액세스 키는 와탭 서비스 활성화를 위한 고유 ID입니다.

설치 안내 섹션에서 프로젝트 액세스 키 발급받기 버튼을 선택하세요. 액세스 키를 자동으로 발급받은 후 다음 단계를 진행합니다.

노트

프로젝트를 생성한 후, 자동으로 에이전트 설치 페이지로 이동합니다. 에이전트 설치 페이지로 이동하지 않는다면 화면 왼쪽 메뉴에서 관리 > 에이전트 설치를 선택하세요.

에이전트 설치​

와탭 리포지토리 추가​

다음 명령어를 실행하여 와탭 공식 리포지토리를 시스템에 추가합니다.

curl -s https://repo.whatap.io/debian/release.gpg | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/whatap-release.gpg > /dev/null
echo "deb [signed-by=/etc/apt/trusted.gpg.d/whatap-release.gpg] https://repo.whatap.io/debian unstable/" | sudo tee /etc/apt/sources.list.d/whatap.list
sudo apt-get update

패키지 설치​

다음 명령어로 와탭 데이터베이스 모니터링 에이전트를 설치합니다.

sudo apt-get install whatap-db

에이전트 설정 및 시작​

설정 파일을 생성하고 에이전트를 시작합니다.

sudo bash -c 'cat > /usr/whatap/db/whatap.conf <<EOF
license=라이센스
whatap.server.host=13.124.11.223/13.209.172.35
dbms=mysql
db_ip=127.0.0.1
db_port=3306
EOF'
cd /usr/whatap/db && sudo /usr/whatap/db/uid.sh whatap whatap && cd -
sudo service whatap-db restart
노트
  • whatap.conf 파일에 필요한 데이터베이스 옵션을 추가할 수 있습니다.
  • uid.sh 스크립트의 파라미터 값(데이터베이스 계정 ID 및 비밀번호)을 실제 환경에 맞게 수정하세요.

에이전트 관리​

에이전트 업데이트​

에이전트를 최신 버전으로 업데이트하려면 다음 명령어를 실행합니다.

sudo apt-get update
sudo apt-get install whatap-db
sudo service whatap-db restart

에이전트 중지 및 패키지 제거​

와탭 데이터베이스 모니터링 에이전트를 제거하려면 다음 명령어를 실행합니다.

sudo service whatap-db stop
sudo apt-get remove whatap-db

에이전트 로그 확인​

에이전트 로그를 확인하려면 다음 명령어를 사용합니다.

sudo service whatap-db log
최종 수정: