본문으로 건너뛰기

에이전트 설치

와탭 NPM 서비스를 사용하기 위해서는 회원 가입 후 프로젝트를 생성하고 운영 중인 서버에 NPM 에이전트를 설치해야 합니다.

프로젝트 생성하기​

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

  1. 와탭 모니터링 서비스로 이동한 다음 로그인하세요.

  2. 프로젝트를 생성하려면 화면 왼쪽 사이드 메뉴에서 전체 프로젝트 > + 프로젝트 버튼을 선택하세요.

  3. 상품 선택 화면에서 프로젝트에 설치할 상품을 선택하세요.

  4. 프로젝트 이름, 데이터 서버 지역, 타임 존 항목을 차례로 설정하세요.

    프로젝트 생성

  5. 알림 언어 설정에서 경고 알림 메시지의 언어를 선택하세요.

  6. 모든 설정을 완료한 다음에는 프로젝트 생성하기 버튼을 선택하세요.

노트

  • 데이터 서버 지역은 리전(클라우드 서비스를 제공하기 위해 설치한 데이터 센터의 묶음)을 의미합니다. 특정 리전을 선택하면 해당 리전에 속한 데이터 센터에 사용자의 데이터를 저장합니다.

  • 타임 존은 알림, 보고서를 생성하는 기준 시간입니다.

  • 여러 개의 프로젝트를 그룹으로 묶어 관리하려면 프로젝트 그룹에서 그룹을 선택하거나 그룹을 추가하세요. 그룹에 대한 자세한 설명은 다음 문서를 참조하세요.

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

프로젝트 액세스 키 확인​

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

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

팁

프로젝트를 생성한 다음에는 자동으로 에이전트 설치 페이지로 이동합니다. 에이전트 설치 페이지로 이동하지 않는다면 왼쪽 메뉴에서 전체 프로젝트를 선택한 다음 새로 생성한 프로젝트를 선택하세요.

리눅스 환경에 설치하기​

설치 안내 섹션에서 리눅스 탭을 선택하고 화면의 안내에 따라 에이전트 설치를 진행하세요.

에이전트 다운로드​

모니터링 대상 서버에 에이전트 파일을 다운로드하세요.

sudo rpm --import https://repo.whatap.io/centos/release.gpg
echo "[whatap]" | sudo tee /etc/yum.repos.d/whatap.repo > /dev/null
echo "name=whatap packages for enterprise linux" | sudo tee -a /etc/yum.repos.d/whatap.repo > /dev/null
echo "baseurl=https://repo.whatap.io/centos/9/\$basearch" | sudo tee -a /etc/yum.repos.d/whatap.repo > /dev/null
echo "enabled=1" | sudo tee -a /etc/yum.repos.d/whatap.repo > /dev/null
echo "gpgcheck=0" | sudo tee -a /etc/yum.repos.d/whatap.repo > /dev/null
sudo yum install whatap-npmd
노트

AWS EC2 환경에서 리소스 정보를 수집하려면 다음 문서를 참조하세요.

호환성 체크 및 설정​

에이전트를 다운로드한 서버의 호환성을 체크하고 설정 정보를 입력하세요.

sudo /usr/whatap/whatap-npmd/install.sh {프로젝트 액세스 키} {수집 서버 IP 주소}

다음과 같이 호환성 체크 결과와 구동 메시지를 확인할 수 있습니다.

Supported kernel version : 5.15. OK.
Supported CPU Arch : aarch64, OK.
Move package files
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                                        Dload  Upload     Total   Spent    Left     Speed
100    14  100    14        0      0            65            0       --:--:-- --:--:-- --:--:--        65
Start service
Installation complete!

쿠버네티스 환경에 설치하기​

설치 안내 섹션에서 쿠버네티스 탭을 선택하고 화면의 안내에 따라 에이전트 설치를 진행하세요.

노트

AWS EKS 환경에서 리소스 정보를 수집하려면 다음 문서를 참조하세요.

에이전트 생성​

  1. 에이전트 생성하기 위해 다운로드 버튼을 선택해 YAML 파일을 다운로드하세요.

  2. 다운로드한 YAML 파일을 마스터 노드에 업로드하세요.

  3. 마스터 노드에서 다음 명령어를 실행해 에이전트를 생성하세요.

    kubectl apply -f whatap_npmd.yaml

  4. 다음 명령어를 실행해 에이전트의 동작 상태(STATUS)가 RUNNING 상태인지 확인하세요.

    kubectl get pod -n whatap-npm-ns

    NPM 에이전트 설치

TagRule 옵션 설정 (선택 사항)​

NPM에서는 tagRule 설정을 통해 불규칙하고 다양한 정보를 수집하고 토포롤지 또는 차트로 표현할 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.

모니터링 시작하기​

에이전트가 정상 작동하면 모니터링 정보를 수집하기 시작합니다. 수집된 정보를 서비스 화면에서 확인하려면 화면 오른쪽 아래에 네트워크 토폴로지 버튼을 선택하세요.