에이전트 설치
모니터링 대상 애플리케이션 서버에서 TCP 통신으로 데이터를 전달하고, 와탭 수집 서버로 데이터를 전송하려면 같은 서버에 에이전트를 설치해야 합니다. 설치 방식은 패키지 설치로 가능합니다.
에이전트는 기본 127.0.0.1:6600 TCP 서버로 작동합니다. Go 애플리케이션에서 데이터를 수신해서 와탭 수집 서버로 Outbound 6600 포트로 전달합니다.
-
와탭 저장소(Repository)를 설치하세요.
-
whatap-agent 리눅스 패키지(yum, apt-get)를 설치하세요.
-
whatap-agent 서비스를 실행하세요.
와탭 모니터링 서비스를 사용하기 위해서는 회원 가입 후 프로젝트를 생성하고 대상 서버에 에이전트를 설치해야 합니다.
프로젝트 생성하기
에이전트를 설치하기 전에 먼저 프로젝트를 생성하세요.
-
와탭 모니터링 서비스로 이동한 다음 로그인하세요.
-
프로젝트를 생성하려면 화면 왼쪽 사이드 메뉴에서 전체 프로젝트 > + 프로젝트 버튼을 선택하세요.
-
상품 선택 화면에서 프로젝트에 설치할 상품을 선택하세요.
-
프로젝트 이름, 데이터 서버 지역, 타임 존 등의 항목을 차례로 설 정하세요.
-
모든 설정을 완료한 다음에는 프로젝트 생성하기 버튼을 선택하세요.
-
데이터 서버 지역은 리전(클라우드 서비스를 제공하기 위해 설치한 데이터 센터의 묶음)을 의미합니다. 특정 리전을 선택하면 해당 리전에 속한 데이터 센터에 사용자의 데이터를 저장합니다.
-
타임 존은 알림, 보고서를 생성하는 기준 시간입니다.
-
여러 개의 프로젝트를 그룹으로 묶어 관리하려면 프로젝트 그룹에서 그룹을 선택하거나 그룹을 추가하세요. 그룹에 대한 자세한 설명은 다음 문서를 참조하세요.
-
조직을 선택한 상태에서 프로젝트를 추가할 경우 조직 하위 그룹을 필수로 설정해야 합니다.
액세스 키 확인
액세스 키는 와탭 서비스 활성화를 위한 고유 ID입니다.
설치 안내 섹션에서 프로젝트 액세스 키 발급받기 버튼을 선택하세요. 액세스 키를 자동으로 발급받은 후 다음 단계를 진행합니다.
프로젝트를 생성한 다음에는 자동으로 에이전트 설치 페이지로 이동합니다. 에이전트 설치 페이지로 이동하지 않는다면 화면 왼쪽 메뉴에서 관리 > 에이전트 설치를 선택하세요.
에이전트 다운로드
액세스 키를 발급 받으면 다음 명령어를 이용해 에이전트를 다운로드하세요.
- Red Hat/CentOS
- Debian/Ubuntu
- Amazon Linux
- Alpine Linux
- Alpine Linux Docker
## 패키지 리포지토리 등록
$ sudo rpm -Uvh https://repo.whatap.io/centos/5/noarch/whatap-repo-1.0-1.noarch.rpm
## 패키지 설치
$ sudo yum install whatap-agent
## 패키지 저장소 등록
$ wget https://repo.whatap.io/debian/release.gpg -O -|sudo apt-key add -
$ wget https://repo.whatap.io/debian/whatap-repo_1.0_all.deb
$ sudo dpkg -i whatap-repo_1.0_all.deb
$ sudo apt-get update
## 패키지 설치
$ sudo apt-get install whatap-agent
## 패키지 저장소 등록
$ 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/latest/\$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-agent
whatap-agent.tar.gz 파일을 다운받고 '/' 디렉터리 기준으로 압축을 해제하세요. /usr/whatap/agent 경로에 모니터링 파일을 생성합니다.
$ wget https://s3.ap-northeast-2.amazonaws.com/repo.whatap.io/alpine/x86_64/whatap-agent.tar.gz
$ tar -xvzf whatap-agent.tar.gz -C /
whatap-agent.tar.gz 파일을 다운받고 /usr/whatap/agent 경로에 압축을 해제하세요.
FROM alpine
RUN apk update && apk upgrade
# Install WhaTap Go monitoring agent
RUN wget https://s3.ap-northeast-2.amazonaws.com/repo.whatap.io/alpine/x86_64/whatap-agent.tar.gz
RUN tar -xvzf whatap-agent.tar.gz -C /
에이전트 구성 파일
모니터링 정보를 수집하기 위한 트레이서, 수집한 정보를 서버에 전송하기 위한 에이전트, 트레이서와 에이전트를 서버에 동적으로 적용하기 위한 설치 스크립트 파일로 구성합니다.
-
whatap-agent: 에이전트, 트레이서에서 UDP로 전달한 정보를 수집 서버로 전송하는 프로그램입니다.
-
/etc/init.d/whatap-agent: 서비스 스크립트 파일입니다.
-
whatap_agent: 서비스 실행 파일입니다.
-
whatap.conf: 설정 정보 및 수집 서버 IP, 액세스 키를 입력하는 파일입니다.
-
whatap-boot-
yyyymmdd
.log: 에이전트 로그 파일입니다. (경로: /usr/whata/agent/log)