본문으로 건너뛰기

에이전트 설치

와탭 Telegraf 에이전트 이용을 위한 기본 설치 방법을 안내합니다.

Telegraf에서 수집하는 메트릭스를 와탭 수집서버로 전달할 수 있습니다. 수집된 데이터는 whatap의 프로젝트 내부에서 확인 가능합니다. 이 페이지에서는 whatap-telegraf 에이전트를 설치하여 Telegraf에서 전달받은 데이터를 수집 서버로 중계하는 방법을 설명합니다.

기존에 설치된 Telegraf의 socket_writer output plugin을 활성화하여 whatap-telegraf(Local TCP) 에이전트로 데이터를 전달합니다.

와탭 서비스를 사용하기 위해서는 회원 가입 후 프로젝트를 생성하고 대상 서버에 에이전트를 설치해야 합니다. 회원 가입에 관한 자세한 내용은 다음 문서를 참조하세요.

노트

Telegraf 에이전트는 사용자가 해당 서비스에 직접 설치하고 설정해야 합니다.

프로젝트 생성하기​

에이전트를 설치하기 전에 먼저 프로젝트를 생성하세요.

  1. 와탭 모니터링 서비스로 이동한 다음 로그인하세요.

  2. 프로젝트를 생성하려면 화면 왼쪽 사이드 메뉴에서 전체 프로젝트 > + 프로젝트 버튼을 선택하세요.

  3. 상품 선택 화면에서 프로젝트에 설치할 상품을 선택하세요.

  4. 프로젝트 이름, 데이터 서버 지역, 타임 존 항목을 차례로 설정하세요.

    프로젝트 생성

  5. 알림 언어 설정에서 경고 알림 메시지의 언어를 선택하세요.

  6. 모든 설정을 완료한 다음에는 프로젝트 생성하기 버튼을 선택하세요.

노트

  • 데이터 서버 지역은 리전(클라우드 서비스를 제공하기 위해 설치한 데이터 센터의 묶음)을 의미합니다. 특정 리전을 선택하면 해당 리전에 속한 데이터 센터에 사용자의 데이터를 저장합니다.

  • 타임 존은 알림, 보고서를 생성하는 기준 시간입니다.

  • 여러 개의 프로젝트를 그룹으로 묶어 관리하려면 프로젝트 그룹에서 그룹을 선택하거나 그룹을 추가하세요. 그룹에 대한 자세한 설명은 다음 문서를 참조하세요.

  • 조직을 선택한 상태에서 프로젝트를 추가할 경우 조직 하위 그룹을 필수로 설정해야 합니다.

프로젝트 액세스 키 확인​

프로젝트 액세스 키는 와탭 서비스 활성화를 위한 고유 ID입니다.

설치 안내 섹션에서 프로젝트 액세스 키 발급받기 버튼을 선택하세요. 프로젝트 액세스 키를 자동으로 발급 받은 후 다음 단계를 진행합니다.

팁

프로젝트를 생성한 다음에는 자동으로 에이전트 설치 페이지로 이동합니다. 에이전트 설치 페이지로 이동하지 않는다면 왼쪽 메뉴에서 전체 프로젝트를 선택한 다음 새로 생성한 프로젝트를 선택하세요.

설치 순서와 파일 구성​

  1. 와탭 리포지토리를 설치하세요.
  2. whatap-telegraf 리눅스 패키지(yum, apt-get)를 설치하세요.
  3. 프로젝트 액세스 키 및 와탭 서버 정보를 설정하세요.
  4. Telegraf의 socket_writer output plugin을 설정하여 데이터를 연동하세요.
Telegraf 에이전트 파일 구성

  • whatap_telegraf

    서비스 실행 파일로 Telegraf에서 전달된 정보를 수집 서버로 전송하는 프로그램입니다.

  • /etc/init.d/whatap-telegraf (FreeBSD /usr/local/etc/whatap_telegraf)

    서비스 스크립트입니다.

  • whatap.conf

    설정 파일입니다. 수집 서버의 주소와 서버의 프로젝트 액세스 키가 입력되는 파일입니다.

  • whatap-telegraf-#.log

    에이전트 로그 파일입니다. (/usr/whatap/telegraf/logs)

패키지 설치​

  1. 와탭 리포지토리를 설치하세요.

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

  2. 다음 명령어를 통해 패키지를 설치하세요.

    $ sudo yum install whatap-telegraf

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

    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

Telegraf 연동​

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

TOML
# # 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"
  • [[outputs.socket_writer]] 주석을 해제합니다.
  • address 항목에 tcp 연결을 설정합니다.
  • 데이터 유형은 json 형식으로 설정합니다.

Telegraf 에이전트 설치를 완료했습니다. 다음 문서에서 설치 문제 해결 방법을 확인하세요.