Server Agent Guide - PDF Free Download

Server Agent Guide WhaTap Support Version 1.0.1

Table of Contents Server Agent Guide......................................................................................... 1 1. 개요................................................................................................. 2 1.1. 지원환경......................................................................................... 2 1.2. 구성파일......................................................................................... 2 1.3. 에이전트이름식별................................................................................... 2 2. 설치................................................................................................. 3 2.1. 프로젝트생성...................................................................................... 3 2.2. Linux / FreeBSD 에이전트설치.......................................................................... 4 2.3. Windows 에이전트설치............................................................................... 7 3. 에이전트업데이트..................................................................................... 11 3.1. Linux / FreeBSD................................................................................... 11 3.2. Windows......................................................................................... 11 4. 에이전트삭제......................................................................................... 12 4.1. Linux / FreeBSD................................................................................... 12 4.2. Windows......................................................................................... 12 5. 확장팩설정.......................................................................................... 13 5.1. MySQL 모니터링................................................................................... 13 5.2. 웹 URL 성능체크................................................................................... 13 5.3. Redis 서버목록.................................................................................... 13 5.4. Memcached 서버목록............................................................................... 13

Preface Server Agent Guide 제목 : Server Agent Guide 작성자 : WhaTap Support 이메일 : support@whatap.io 날짜 : 2019-04-24 버전 : 1.0.1 설명 : 본문서는 WhaTap Server Monitoring 에이전트에대해설명합니다. 서버모니터링의전반적인사용은서버모니터링서비스사용자가이드를확인해주세요. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 1

1.1. 지원환경 Chapter 1. 개요 1.1. 지원환경 X86 기반에서동작하는 Linux, Windows, FreeBSD 에적용할수있습니다. 지원리스트에포함되지않는환경이라면 support@whatap.io 로별도문의주시기를부탁드립니다. Table 1. 제품지원환경 제품환경지원환경 서버모니터링 Agent Windows Windows 2008R2 이상 Linux FreeBSD Debian 7.0 이상 Ubuntu 12.04 이상 Centos, Readhat 6.0 이상 Amazon Linux 1.0 이상 SUSE 12.1 이상 FreeBSD 10 이상 1.2. 구성파일 Table 2. 공통 파일명 ChangeLog.txt whatap.conf 설명 에이전트변경내역 서버의데이터를수집할서버의주소와서버의프로젝트라이센스키가입력되는파일 Table 3. Linux / FreeBSD 파일명 whatap_infrad whatap_infrad.pid VERSION 설명데이터수집및전송용에이전트실행중인에이전트의 PID 값을기록한파일현재설치된에이전트의버전이기록된파일 Table 4. Windows 파일명 whatap_infra.exe unins000.* whatap.ico 설명데이터수집및전송용에이전트에이전트삭제파일와탭인프라의아이콘이미지 1.3. 에이전트이름식별 와탭은모니터링정보수집대상인인프라서버식별을위해기본적으로서버로부터수집한정보를활용합니다. 기본값은서버의 호스트명 (hostname) 입니다. default hostname Copyright c 2019 WhaTap Labs Inc. All rights reserved. 2

2.1. 프로젝트생성 Chapter 2. 설치 와탭서버모니터링서비스는다수의서버를프로젝트로그룹화하여관리합니다. 2.1. 프로젝트생성 와탭콘솔의프로젝트그룹에서추가버튼을누릅니다. INFRA STRUCTURE 아이콘선택후각입력란에해당하는정보를입력하고전송버튼을눌러프로젝트를추가합니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 3

2.2. Linux / FreeBSD 에이전트설치 2.2.1. 패키지저장소 (Repository) 추가 에이전트설치페이지에서상위에위치한 OS 탭에서서버 OS 와동일한탭을클릭합니다. 설치페이지에존재하는 와탭저장소 (Repository) 를추가합니다. 항목설명에따라설치하고자하는서버에입력합니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 5

2.2. Linux / FreeBSD 에이전트설치 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. 라이센스등록 설치페이지에존재하는 설정스크립트를실행하여서버모니터데몬을시작하십시오. 밑에있는박스를클릭하여라이선스를발급받습니다. 이후 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 6

2.3. Windows 에이전트설치 생성되는명령어를 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 에이전트설치 새롭게생성한서버모니터링프로젝트를클릭하여아래와같은에이전트설치화면에진입합니다. 해당화면은프로젝트관리 에이전트설치부분에서확인가능합니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 7

2.3. Windows 에이전트설치 2.3.1. 에이전트파일다운로드 에이전트설치페이지상단에위치한 OS 탭에서 Windows 를클릭합니다. 이후 Whatap_infra.exe 를클릭하여설치파일을다운로드합니다. 보안상.exe 형식의파일이받아지지않는사용자를위하여.zip 형식의파일도제공됩니다. 보안을위해브라우저를통한직접설치보단다운로드받은파일실행을권장합니다. 2.3.2. 에이전트파일업로드 다운로드받은서버모니터링에이전트설치파일을설치하고자하는서버에접속하여업로드합니다. 2.3.3. 라이센스발급 설치페이지에서라이센스키와 IP 를발급받습니다. 2.3.4. 에이전트설치 서버에서업로드받은서버모니터링에이전트설치파일을실행합니다. 실행시다음과같은화면을볼수있습니다. 입력란에발급받은라이센스키와 IP 를입력하고진행합니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 9

3.1. Linux / FreeBSD Chapter 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 업그레이드된버전으로설치를진행합니다. 제거과정은불필요합니다. Copyright c 2019 WhaTap Labs Inc. All rights reserved. 11

4.1. Linux / FreeBSD Chapter 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" Copyright c 2019 WhaTap Labs Inc. All rights reserved. 12

5.1. MySQL 모니터링 Chapter 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 Copyright c 2019 WhaTap Labs Inc. All rights reserved. 13

5.4. Memcached 서버목록 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" Copyright c 2019 WhaTap Labs Inc. All rights reserved. 14