본문으로 건너뛰기

에이전트 설치

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

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

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

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

노트

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

프로젝트 생성하기​

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

  1. 와탭 모니터링 서비스에 로그인합니다.

  2. 왼쪽 사이드 메뉴에서 전체 프로젝트 > + 프로젝트 버튼을 클릭합니다.

  3. 상품 선택 화면에서 설치할 제품을 선택합니다.

  4. 아래 항목을 입력하거나 선택합니다.

    • 프로젝트 이름: 프로젝트의 이름을 입력합니다.

    • 데이터 서버 지역: 데이터 서버가 위치한 리전을 선택합니다. 리전은 클라우드 서비스를 제공하는 데이터 센터의 묶음입니다. 선택한 리전에 사용자의 데이터가 저장됩니다.

    • 타임 존: 알림 및 보고서 생성 시 기준이 되는 시간을 설정합니다.

    • 알림 언어 설정: 경고 알림 메시지의 언어를 설정합니다. (한글, 영어 지원)

    • 프로젝트 그룹: 여러 프로젝트를 그룹으로 묶어 관리할 수 있습니다. 소속될 그룹이 있으면 선택하세요.

    • 프로젝트 설명: 프로젝트에 대한 추가 설명이나 세부 정보를 입력합니다.

  5. 모든 설정을 완료하면 프로젝트 생성하기 버튼을 클릭합니다.

노트

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

그룹에 대한 자세한 설명은 다음 문서를 참고하세요.

프로젝트 액세스 키 확인​

프로젝트 액세스 키는 와탭 서비스 활성화를 위한 고유 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 에이전트 설치를 완료했습니다. 다음 문서에서 설치 문제 해결 방법을 확인하세요.

최종 수정: