설치

Telegraf에서 수집하는 메트릭스를 와탭 수집서버로 전달할 수 있습니다.
수집된 데이터는 whatap의 프로젝트 내부에서 확인 가능합니다.

이 페이지에서는 whatap-telegraf 에이전트를 설치하여 Telegraf에서 전달받은 데이터를 수집 서버로 중계하는 방법을 설명합니다.
기존에 설치된 Telegraf의 socket_writer output plugin을 활성화하여 whatap-telegraf(Local TCP) 에이전트로 데이터를 전달합니다.

설치에 앞서 telegraf 에이전트 구성 파일과 에이전트 이름 식별 방법이 궁금하시면 배워보기 > Telegraf를 확인해 보세요.

절차

  1. 와탭 저장소(Repository)를 설치합니다.

  2. whatap-telegraf 리눅스 패키지(yum, apt-get)를 설치합니다.

  3. 라이센스 및 와탭 서버 정보를 설정합니다.

  4. Telegraf의 socket_writer output plugin을 설정하여 데이터를 연동합니다.

패키지 설치

Redhat/CentOS

와탭 저장소(Repository)를 등록합니다.

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

아래 명령어를 통해 패키지를 설치합니다.

$ sudo yum install whatap-telegraf

설정 스크립트를 실행하여 서비스를 시작합니다.

echo "license=[발급받은 라이센스]" |sudo tee /usr/whatap/telegraf/whatap.conf
echo "whatap.server.host=[와탭 서버 주소]" |sudo tee -a /usr/whatap/telegraf/whatap.conf
sudo service whatap-telegraf restart
Debian/Ubuntu

와탭 저장소(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

아래 명령어를 통해 패키지를 설치합니다.

$ sudo apt-get install whatap-telegraf

설정 스크립트를 실행하여 서비스를 시작합니다.

echo "license=[발급받은 라이센스]" |sudo tee /usr/whatap/telegraf/whatap.conf
echo "whatap.server.host=[와탭 서버 주소]" |sudo tee -a /usr/whatap/telegraf/whatap.conf
sudo service whatap-telegraf restart
Amazon Linux

와탭 저장소(Repository)를 등록합니다.

$ 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

아래 명령어를 통해 패키지를 설치합니다.

$ sudo yum install whatap-telegraf

설정 스크립트를 실행하여 서비스를 시작합니다.

echo "license=[발급받은 라이센스]" |sudo tee /usr/whatap/telegraf/whatap.conf
echo "whatap.server.host=[와탭 서버 주소]" |sudo tee -a /usr/whatap/telegraf/whatap.conf
sudo service whatap-telegraf restart
FreeBSD

아래 명령어를 통해 패키지를 설치합니다.

$ wget https://s3.ap-northeast-2.amazonaws.com/repo.whatap.io/freebsd/10/whatap-telegraf-0.0.4.txz
$ pkg install whatap-telegraf-0.0.4.txz

설정 스크립트를 실행하여 서비스를 시작합니다.

echo "license=[발급받은 라이센스]" | tee /usr/whatap/telegraf/whatap.conf
echo "whatap.server.host=[와탭 서버 주소]" | tee -a /usr/whatap/telegraf/whatap.conf
sudo service whatap_telegraf restart

Telegraf 연동

Telegraf.conf에 socket_writer output plugin 설정을 하여 whatap-telegraf로 수집된 정보를 전달합니다.

  • [[outputs.socket_writer]] 주석을 해제합니다.

  • address 항목에 tcp 연결을 설정합니다.

  • 데이터 유형은 json 형식으로 설정합니다.

# # Generic socket writer capable of handling multiple socket types.
 [[outputs.socket_writer]]

#   ## URL to connect to
    address = "tcp://127.0.0.1:6600"

#   # data_format = "influx"
    data_format = "json"