Infrastructure Monitoring Agent install Guide 이문서는와탭 APM 서비스사용자가에이전트설치를돕기위해작성된문서입니다. 이문서는와탭랩스의고유한자산으로재배포또는사용을위해서는 와탭랩스 (support@whatap.io) 에연락주시기바랍니다. 와탭 R2
목차 1.1. 인프라모니터링... 4 1.1.1. 에이전트실행및모니터링개요... 4 1.1.1.1. 구성파일... 4 1.1.1.1.1. 공통구성파일... 4 1.1.1.1.2. Linux 구성파일... 4 1.1.1.1.3. Windows 구성파일... 4 1.1.1.2. 에이전트이름식별... 5 1.1.2. 에이전트설치및패키지업데이트 / 제거... 5 1.1.2.1. 공통... 5 1.1.2.1.1. 프로젝트생성... 5 1.1.2.1.2. 라이선스발급... 7 1.1.2.2. Debian/Ubuntu... 8 1.1.2.2.1. 패키지저장소 (Repository) 등록... 8 1.1.2.2.2. 인프라모니터링설치... 8 1.1.2.2.3. 라이선스키및수집서버설정... 8 1.1.2.3. Redhat/CentOS/Amazon-Linux... 8 1.1.2.3.1. 패키지저장소 (Repository) 등록... 8 1.1.2.3.2. 인프라모니터링설치... 9 1.1.2.4. Windows... 9 1.1.2.4.1. 에이전트다운로드... 9 1.1.2.4.2. 에이전트업로드... 10 1.1.2.4.3. 에이전트설치... 10 1.1.2.5. 알림일시정지... 11 1.1.2.6. 알림재시작... 12 1.1.2.7. 해지... 12 1.1.2.8. 제거... 13 1.1.2.8.1. Debian/Ubuntu... 13 1.1.2.8.2. Redhat/CentOS/Amazon-Linux... 13 1.1.2.8.3. Windows... 13 1.1.3. FAQ... 13 1.1.4. 설치에러대응... 15 1.1.4.1 설치후서버목록에표시되지않을때... 15 1.1.5. 제약사항... 15
목차 1.1.6. 호환성목록... 15
1.1. 인프라모니터링 1.1.1. 에이전트실행및모니터링개요 와탭인프라스트럭처모니터링은서버성능모니터링서비스를제공합니다. 1.1.1.1. 구성파일 1.1.1.1.1. 공통구성파일 파일명 ChangeLog.txt whatap.conf 설명 에이전트의버전패치내역 서버의데이터를수집할서버의주소와서버의프로젝트라이선스키가입력되는파일 1.1.1.1.2. Linux 구성파일 파일명 whatap_infrad whatap_infrad.pid VERSION 설명데이터수집및전송용에이전트실행중인에이전트의 PID 값을기록한파일현재설치된에이전트의버전이기록된파일 1.1.1.1.3. Windows 구성파일 파일명 whatap_infra.exe unins000.* whatap.ico 설명 정보를수집하고수집된정보를서버로전송하는프로그램 에이전트삭제파일 와탭인프라의아이콘이미지
1.1.1.2. 에이전트이름식별 와탭은모니터링정보수집대상인인프라서버식별을위한정보로기본적으로서버로부터수집한정보를활용합니다. 기본적으로활용하는정보는서버의호스트명 (hostname) 이됩니다. default: hostname 1.1.2. 에이전트설치및패키지업데이트 / 제거 와탭인프라스트럭처모니터링서비스를이용하기위해서는모니터링대상서버에와탭인프라모니터링에이전트설치해야합니다. 와탭인프라스트럭처모니터링에이전트설치방법은 whatap.io 사이트에서제공하는명령어를수행하는것만으로설치가완료됩니다. 1.1.2.1. 공통 1.1.2.1.1. 프로젝트생성
서버를등록하기위해우선프로젝트를생성합니다. 추가버튼을선택하면아래와같이프로젝트생성창이나타납니다. INFRASTRUCTURE 아이콘을선택한뒤, 희망하는프로젝트명과데이터서버지역, 소속하게될그룹을선택한뒤프로젝트를생성합니다.
1.1.2.1.2. 라이선스발급 에이전트설치화면에서라이선스를발급받습니다. 라이선스키는프로젝트별로 귀속되기때문에, 유출되거나배포되어서는안됩니다. 반드시본인프로젝트에 서버를등록할때에만이용하시기바랍니다.
1.1.2.2. Debian/Ubuntu 1.1.2.2.1. 패키지저장소 (Repository) 등록 와탭저장소 (Repository) 를추가합니다. $ 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 1.1.2.2.2. 인프라모니터링설치 아래의명령어를입력하여와탭인프라모니터링을설치합니다. $ sudo apt-get install whatap-infra 1.1.2.2.3. 라이선스키및수집서버설정 아래의명령어에발급받은라이선스키와수집서버 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 에이전트설치페이지에서발급받은명령문에는라이선스키가포함되어 있기때문에유출되거나, 배포되지않도록주의하시길바랍니다. 에이전트는수집서버주소로정보를전송합니다. 그러므로에이전트가 설치된서버는 TCP 아웃바운드포트 (6600) 가열려있어야합니다. 1.1.2.3. Redhat/CentOS/Amazon-Linux 1.1.2.3.1. 패키지저장소 (Repository) 등록 와탭저장소 (Repository) 를추가합니다.
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 1.1.2.3.2. 인프라모니터링설치 아래의명령어를입력하여와탭인프라모니터링을설치합니다. sudo yum install whatap-infra 라이선스수집서버설정 $ 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 에이전트설치페이지에서발급받은명령문에는라이선스키가포함되어 있기때문에유출되거나, 배포되지않도록주의하시길바랍니다. 에이전트는수집서버주소로정보를전송합니다. 그러므로에이전트가 설치된서버는 TCP 아웃바운드포트 (6600) 가열려있어야합니다. 1.1.2.4. Windows 1.1.2.4.1. 에이전트다운로드 에이전트설치페이지에서 WINDOWS 를클릭합니다. whata_infra.exe 파일을다운받습니다. 보안설정으로인해.exe 형식의파일을받지 못할경우를대비하여.zip 형식의파일로도다운받을수있습니다.
서버보안을위해브라우저를통한직접설치보다다운로드받은설치 파일을실행시키는것을권장합니다. 1.1.2.4.2. 에이전트업로드 인프라모니터링을설치할서버에접속하고, 다운로드받은에이전트파일을 업로드합니다. 1.1.2.4.3. 에이전트설치 서버에서업로드받은파일을실행합니다. 해당입력란에발급받은라이선스키와데이터서버주소 (IP) 를입력합니다. 이후설치가완료되면아래그림과같은화면을볼수있으며, 에이전트가자동적으로모니터링을시작합니다. 버튼을눌러설치를완료합니다. 에이전트는수집서버주소로정보를전송합니다. 그러므로수집서버주소로가는 TCP 아웃바운드포트 (6600) 가차단되어있으면안됩니다.
1.1.2.5. 알림일시정지 서버는운영중에확장 / 유지보수 / 문제해결 / 단순재시작등의이유로잠시정지해야할필요가있습니다. 이럴경우불필요한오탐을방지하기위해서비스를잠시일시정지가가능합니다. 주의 : 서비스일시정지시에도요금은청구됩니다, 모니터링중인서버들중일시정지하고자하는서버를선택합니다.
일시정지하고자하는서버선택후우측상단에있는액션을클릭하면드롭다운메뉴가나오는것이확인가능합니다. 해당메뉴에서일시정지버튼을클릭할경우알림이나가지않습니다. 일시정지기간동안에는데이터가수집되지만알림이발생하지않습니다. 1.1.2.6. 알림재시작 서버작업완료후알림발송을재개하기위해서는재시작하길원하는서버를선택후액션을클릭하여나오는드롭다운메뉴에서재시작버튼을클릭하여알림발송을재개합니다. 1.1.2.7. 해지 모니터링이더이상필요하지않을경우와탭에이전트를손쉽게해지할수있습니다. 해지를희망하는서버를선택한후, 액션버튼을클릭하여나오는드롭다운메뉴에서해지버튼을누르면아래그림과같은팝업창을확인할수있습니다. 해당팝업창에서해지를누를경우서버가해지됩니다. 주의 : 모니터링해지시해당되는수집서버에저장된데이터가즉시사라져보고서와같은서비스를받으실수없습니다. 따라서삭제전신중하게결정하여해지해주시길바랍니다.
1.1.2.8. 제거 와탭콘솔상에서서버해지를완료하였다면, 서버상에서도에이전트삭제가 필요합니다. 1.1.2.8.1. Debian/Ubuntu $ apt-get remove whatap-infra 남아있는설정파일은 /usr/whatap 에있습니다. 해당 whatap 폴더를지워주시면됩니다. 1.1.2.8.2. Redhat/CentOS/Amazon-Linux $ yum remove whatap-infra 남아있는설정파일은 /usr/whatap 에있습니다. 해당 whatap 폴더를지워주시면됩니다. 1.1.2.8.3. Windows 제어판 -> 프로그램추가 / 제거에서인프라모니터링을찾아서삭제하시거나와탭설치경로인 C:\Program Files\WhatapInfra 에서 unins000.exe 를실행하여삭제하셔도됩니다. 1.1.3. FAQ 1.1.3.1 업그레이드 1.1.3.1.1 윈도우버전업그레이드 기존와탭인프라에이전트프로그램을삭제하지말고설치파일을실행하면자동으로업그레이드됩니다.
1.1.3.1.2 Ubuntu 계열 아래와같이실행합니다. apt-get update apt-get install whatap-infra 1.1.3.1.3 Ubuntu 계열 아래와같이실행합니다. yum check-update yum install whatap-infra 1.1.3.2 인터넷연결이안되는서버에설치 1.1.3.2.1 Windows OS 아래주소에서다운받으실수있습니다. http://repo.whatap.io/windows/whatap.zip 1.1.3.2.2 Ubuntu OS http://repo.whatap.io/debian/unstable/whatap-infra_{x}.{x}.{x}_amd64.deb http://repo.whatap.io/debian/unstable/whatap-infra_{x}.{x}.{x}_i386.deb 1.1.3.2.3 CentOS/RedHat/AmazonLinux http://repo.whatap.io/centos/6/x86_64/ whatap-infra-{x}.{x}-{x}.86_64.rpm http://repo.whatap.io/centos/6/i386/ whatap-infra-{x}.{x}-{x}.i386.rpm http://repo.whatap.io/centos/7/x86_64/ whatap-infra-{x}.{x}-{x}.86_64.rpm 1.1.3.3 최신버젼확인 1.1.3.3.1 Ubuntu/Debian 아래명령을터미널에서실행합니다.
apt-cache showpkg whatap-infra 1.1.3.3.2 CentOS/RedHat/AmazonLinux 아래명령을터미널에서실행합니다. yum info whatap-infra 1.1.4. 설치에러대응 1.1.4.1 설치후서버목록에표시되지않을때 1.1.4.1.1 Windows Cmd 창에서아래명령을수행하면오류원인을파악할수있습니다. C:\Program Files\WhatapInfra\whatap_infra.exe whatapip { 수집서버 IP} license { 라이선스문자열 } test 1.1.4.1.2 Linux 터미널에서아래명령을수행하면오류원인을파악할수있습니다. /usr/whatap/infra/whatap_infrad whatapip { 수집서버 IP} license { 라이선스문자열 } test 1.1.5. 제약사항 제약사항없음 1.1.6. 호환성목록 Debian 7.0 이상 Ubuntu 12.04 이상 CentOS 6 이상 RHEL 6 이상 Amazon Linux
Windows Server 2008 R2 SP2 이상
Thank you support@whatap.io ( 주 ) 와탭랩스 www.whatap.io 서울특별시강남구테헤란로 69 길 5 유기타워 11F (06160) Tel. 02.565.1803 Fax. 0504.848.1803