Server Agent Guide

제목 : Server Agent Guide
작성자 : WhaTap Support
이메일 : support@whatap.io
날짜 : 2019-11-25
버전 : 1.0.1

설명 : 본 문서는 WhaTap Server Monitoring 에이전트에 대해 설명합니다.

서버 모니터링의 전반적인 사용은 서버 모니터링 서비스 사용자가이드를 확인 해 주세요.

1. 개요

1.1. 지원 환경

X86 기반에서 동작하는 Linux, Windows, FreeBSD 에 적용 할 수 있습니다.
지원 리스트에 포함되지 않는 환경이라면 support@whatap.io 로 별도 문의 주시기를 부탁 드립니다.

Table 1. 제품 지원 환경
제품	환경	지원 환경
서버 모니터링 Agent	Windows	Windows 2008R2 이상
	Linux	Debian 7.0 이상 Ubuntu 12.04 이상 Centos, Readhat 6.0 이상 Amazon Linux 1.0 이상 SUSE 12.1 이상
	FreeBSD	FreeBSD 10 이상

1.2. 구성 파일

Table 2. 공통
파일명	설명
ChangeLog.txt	에이전트 변경 내역
whatap.conf	서버의 데이터를 수집할 서버의 주소와 서버의 프로젝트 라이센스 키가 입력되는 파일

Table 3. Linux / FreeBSD
파일명	설명
whatap_infrad	데이터 수집 및 전송용 에이전트
whatap_infrad.pid	실행 중인 에이전트의 PID 값을 기록한 파일
VERSION	현재 설치된 에이전트의 버전이 기록된 파일

Table 4. Windows
파일명	설명
whatap_infra.exe	데이터 수집 및 전송용 에이전트
unins000.*	에이전트 삭제 파일
whatap.ico	와탭 인프라의 아이콘 이미지

1.3. 에이전트 이름 식별

와탭은 모니터링 정보 수집 대상인 인프라 서버 식별을 위해 기본적으로 서버로부터 수집한 정보를 활용합니다. 기본값은 서버의 호스트명(hostname)입니다.

default: hostname

2. 설치

와탭 서버 모니터링 서비스는 다수의 서버를 프로젝트로 그룹화 하여 관리합니다.

2.1. 프로젝트 생성

와탭 콘솔의 프로젝트 그룹에서 추가 버튼을 누릅니다.

INFRA STRUCTURE 아이콘 선택 후 각 입력란에 해당하는 정보를 입력하고 전송 버튼을 눌러 프로젝트를 추가합니다.

2.2. Linux / FreeBSD 에이전트 설치

신규 생성한 서버 모니터링 프로젝트를 선택하면 에이전트 설치 화면이 나타납니다. 프로젝트 관리 | 에이전트 설치 메뉴를 통해서도 확인 가능합니다.

2.2.1. 패키지 저장소(Repository) 추가

에이전트 설치 페이지에서 상위에 위치한 OS탭에서 서버 OS와 동일한 탭을 클릭합니다.

설치 페이지에 존재하는 “와탭 저장소(Repository)를 추가합니다.” 항목 설명에 따라 설치하고자 하는 서버에 입력합니다.

Debian / Ubuntu

wget http://repo.whatap.io/debian/release.gpg -O -|sudo apt-key add -
wget http://repo.whatap.io/debian/whatap-repo_1.0_all.deb
sudo dpkg -i whatap-repo_1.0_all.deb
sudo apt-get update

CentOS

sudo rpm --import http://repo.whatap.io/centos/release.gpg
sudo rpm -Uvh http://repo.whatap.io/centos/5/noarch/whatap-repo-1.0-1.noarch.rpm

Amazon Linux

sudo rpm --import http://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=http://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

SUSE

sudo rpm --import http://repo.whatap.io/suse/release.gpg
echo "[whatap]" | sudo tee /etc/zypp/repos.d/whatap.repo > /dev/null
echo "name=whatap packages for enterprise linux" | sudo tee -a /etc/zypp/repos.d/whatap.repo > /dev/null
echo "baseurl=http://repo.whatap.io/suse/12/x86_64" | sudo tee -a /etc/zypp/repos.d/whatap.repo > /dev/null
echo "enabled=1" | sudo tee -a /etc/zypp/repos.d/whatap.repo > /dev/null
echo "gpgcheck=1" | sudo tee -a /etc/zypp/repos.d/whatap.repo > /dev/null
sudo zypper refresh

FreeBSD

wget http://repo.whatap.io/freebsd/10/whatap-infra.txz

2.2.2. 에이전트 설치

설치 페이지에 존재하는 “서버 모니터 패키지를 설치하십시오.” 항목 설명에 따라 설치하고자 하는 서버에 입력합니다.

Debian / Ubuntu

sudo apt-get install whatap-infra

CentOS / Amazon Linux / XenServer

sudo yum install whatap-infra

SUSE

sudo zypper install whatap-infra

FreeBSD

pkg install whatap-infra.txz

2.2.3. 라이센스 등록

설치 페이지에 존재하는 “설정 스크립트를 실행하여 서버 모니터 데몬을 시작하십시오.” 밑에 있는 박스를 클릭하여 라이선스를 발급받습니다. 이후 생성되는 명령어를 copy 버튼을 눌러 복사하거나 아래의 명령어에 라이선스키와 서버 IP를 추가하여 설치하고자 하는 서버에 입력합니다.

echo "license=[발급된 라이선스키]" |sudo tee /usr/whatap/infra/conf/whatap.conf
echo "whatap.server.host=[할당된 와탭 서버 IP]" |sudo tee -a /usr/whatap/infra/conf/whatap.conf
echo "createdtime=`date +%s%N`" |sudo tee -a /usr/whatap/infra/conf/whatap.conf
sudo service whatap-infra restart

설치 페이지에서 발급받은 명령어에는 라이센스 키와 IP가 포함 되어 있습니다.
에이전트 → 수집서버로 TCP 6600 포트 접근이 가능해야 합니다. (TCP 아웃바운드)

2.2.4. 에이전트 정상 작동 확인

에이전트가 정상적으로 설치된경우 아래와 같은 로그 출력을 확인하실 수 있습니다. connected 문구가 표시되지 않는 경우 접속 실패로 방화벽 설정을 포함하여 네트워크 설정을 확인 해야 합니다.
네트워크 설정이 반영되면 에이전트는 자동 접속됩니다.

Debian / Ubuntu / SUSE

tail -10 /var/log/syslog
...

Apr  8 16:28:08 localhost systemd[1]: Started LSB: Start whatap-infra daemon.
Apr  8 16:28:08 localhost whatap_infrad[32468]: 2019/04/08 16:28:08 Config file :  /usr/whatap/infra/conf/whatap.conf
Apr  8 16:28:08 localhost whatap_infrad[32468]: 2019/04/08 16:28:08 OID: 1193741647 ONAME: localhost
Apr  8 16:28:08 localhost whatap_infrad[32468]: 2019/04/08 16:28:08 connected to  {whatap ip}:{whatap port}

CentOS / Amazon Linux / FreeBSD

tail -10 /var/log/messages
...

Apr  8 16:28:08 localhost systemd[1]: Started LSB: Start whatap-infra daemon.
Apr  8 16:28:08 localhost whatap_infrad[32468]: 2019/04/08 16:28:08 Config file :  /usr/whatap/infra/conf/whatap.conf
Apr  8 16:28:08 localhost whatap_infrad[32468]: 2019/04/08 16:28:08 OID: 1193741647 ONAME: localhost
Apr  8 16:28:08 localhost whatap_infrad[32468]: 2019/04/08 16:28:08 connected to  {whatap ip}:{whatap port}

2.3. Windows 에이전트 설치

새롭게 생성한 서버 모니터링 프로젝트를 클릭하여 아래와 같은 에이전트 설치 화면에 진입합니다.

해당 화면은 프로젝트 관리 → 에이전트 설치 부분에서 확인 가능합니다.

2.3.1. 에이전트 파일 다운로드

에이전트 설치 페이지 상단에 위치한 OS 탭에서 Windows를 클릭합니다. 이후 Whatap_infra.exe 를 클릭하여 설치파일을 다운로드 합니다.

보안상 .exe 형식의 파일이 받아지지 않는 사용자를 위하여 .zip 형식의 파일도 제공됩니다.
보안을 위해 브라우저를 통한 직접 설치보단 다운로드 받은 파일 실행을 권장합니다.

2.3.2. 에이전트 파일 업로드

다운로드 받은 서버 모니터링 에이전트 설치파일을 설치하고자 하는 서버에 접속하여 업로드 합니다.

2.3.3. 라이센스 발급

설치 페이지에서 라이센스 키와 IP를 발급받습니다.

2.3.4. 에이전트 설치

서버에서 업로드 받은 서버 모니터링 에이전트 설치파일을 실행합니다.

실행 시 다음과 같은 화면을 볼 수 있습니다. 입력란에 발급받은 라이센스 키와 IP를 입력하고 진행합니다.

정상적으로 설치가 완료된 경우 다음과 같은 화면을 볼 수 있으며, 에이전트가 자동적으로 모니터링을 시작합니다. 완료 버튼을 눌러 설치를 완료합니다.

데이터 전송을 위하여 6600 PORT가 열려 있어야 합니다. (TCP 아웃바운드)

2.4. 노트북에 설치할떄

노트북과 같이 서버 컴퓨터가 아닌 개인용 컴퓨터 및 아이피가 변하는 wifi를 사용하는 환경에서는 아래 옵션을 적용하면 IP 가 변경될때마다 자동으로 재등록되지 않아 편리하게 사용할 수 있습니다.

Linux

echo "ipreg=false" | sudo tee -a /usr/whatap/infra/conf/whatap.conf
sudo service whatap-infra restart

Windows 관리자 권한 파워쉘에서 아래 명령을 실행

Add-Content "c:\Program Files\WhatapInfra\whatap.conf" "ipreg=false"
Restart-Service "Whatap Infra"

3. 에이전트 업데이트

설치된 에이전트를 최신 버전으로 업데이트 하고자 하는 경우 아래 명령어를 실행하십시오.

3.1. Linux / FreeBSD

Debian / Ubuntu

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

CentOS / Amazon Linux / SUSE / XenServer

sudo yum update whatap-infra
sudo service whatap-infra restart

FreeBSD

wget http://repo.whatap.io/freebsd/10/whatap-infra.txz
pkg install whatap-infra.txz

3.2. Windows

신규 버전으로 설치과정을 다시 수행합니다.
제거 과정은 불필요 합니다.

4. 에이전트 삭제

설치된 에이전트를 삭제 하고자 하는 경우 아래 명령어를 실행하십시오.

4.1. Linux / FreeBSD

Debian / Ubuntu

sudo apt-get remove whatap-infra

CentOS / Amazon Linux / SUSE / XenServer

sudo yum remove whatap-infra

FreeBSD

pkg delete whatap-infra

4.2. Windows

서버 모니터링 에이전트 삭제명령을 관리자 권한의 command 창에서 실행합니다. 제어판의 프로그램 삭제 기능을 사용하실수도 있습니다.

Windows

"C:\Program Files\WhatapInfra\unins000.exe"

5. 확장팩 설정

정상적으로 설치 완료 후 확장팩 기능을 사용하기 위해 아래와 같이 설정파일을 생성하고 에이전트를 재시작하실 수 있습니다.

5.1. MySQL 모니터링

기능 도태 대상입니다. DB 모니터링 에이전트를 이용할 수 있습니다.

5.2. 웹 URL 성능 체크

와탭 인프라 에이전트가 주어진 웹 주소로 접속하여 접속여부 및 응답시간을 수집 합니다.

아래 명령으로 체크할 웹주소를 추가 하실 수 있습니다.

Linux Shell

sudo echo "체크할 웹 주소" | sudo tee -a /usr/whatap/infra/conf/webcheck.conf
sudo service whatap-infra restart

Windows Powershell

Add-Content -Path "C:\Program Files\WhatapInfra\webcheck.conf" -Value "체크할 웹 주소"
Restart-Service "Whatap Infra"

5.3. Redis 서버 목록

와탭 인프라 에이전트가 주어진 Redis 주소로 접속하여 연결 개수를 포함한 복수개의 성능지수를 수집 합니다.

아래 명령으로 체크할 Redis 서버의 접속 정보를 추가 하실 수 있습니다.

Linux Shell

sudo echo "addr=Redis 주소:포트" | sudo tee /usr/whatap/infra/conf/redis.conf
sudo echo "password=Redis 패스워드" | sudo tee -a /usr/whatap/infra/conf/redis.conf
sudo service whatap-infra restart

Windows Powershell

Add-Content -Path "C:\Program Files\WhatapInfra\redis.conf" -Value "addr=Redis 주소:포트"
Add-Content -Path "C:\Program Files\WhatapInfra\redis.conf" -Value "password=Redis 패스워드"
Restart-Service "Whatap Infra"

5.4. Memcached 서버 목록

와탭 인프라 에이전트가 주어진 Memcached 주소로 접속하여 연결 개수를 포함한 복수개의 성능지수를 수집 합니다.

아래 명령으로 체크할 Memcached 서버의 접속 정보를 추가 하실 수 있습니다.

Linux Shell

sudo echo "addr=Memcached 주소:포트" | sudo tee /usr/whatap/infra/conf/memcached.conf
sudo echo "password=Redis 패스워드" | sudo tee -a /usr/whatap/infra/conf/memcached.conf
sudo service whatap-infra restart

Windows Powershell

Add-Content -Path "C:\Program Files\WhatapInfra\memcached.conf" -Value "addr=Memcached 주소"
Add-Content -Path "C:\Program Files\WhatapInfra\memcached.conf" -Value "password=Memcached 패스워드"
Restart-Service "Whatap Infra"

6. 원격 파일 뷰어 설정

와탭 웹에서 사용자 서버의 사용자가 지정한 임의의 텍스트 파일의 내용을 볼 수 있습니다.

6.1. 설정방법

와탭 서버 모니터링 설정파일에 웹에서 조회할 텍스트 파일을 추가합니다.

아래 명령으로 조회할 텍스트 파일을 추가 하실 수 있습니다.

Linux Shell

echo "webview.allow.`date +%s%N`=조회할 파일의 전체 경로" | sudo tee -a /usr/whatap/infra/conf/whatap.conf

Windows Powershell

Add-Content -Path "C:\Program Files\WhatapInfra\whatap.conf" -Value "webview.allow.$(Get-Date -uformat %s)=조회할 파일의 전체 경로"