whatap output plugin

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

이 페이지에서는 Telegraf의 whatap output plugin(tcp)을 사용하는 방법을 설명합니다.

Telegraf 오픈 소스 내에 whatap plugin 리뷰가 진행 중입니다.
정식 배포 전에는 whatap plugin을 포함하는 Telegraf를 교체해서 사용하세요.

다운로드 설치

Telegraf release 버전을 기준으로 whatap plugin을 추가하여 미리 생성한 설치 파일입니다.

Telegraf가 이미 설치된 경우에는 실행파일만 교체하여 whatap plugin을 활성화할 수 있습니다.

다운로드 설치는 아래 목록에 있는 운영체제에서 가능합니다.
다른 운영체제는 컴파일 설치로 진행해 주세요.

  • macOS

  • RedHat & CentOS

  • Ubuntu & Debian

  • FreeBSD

  • windows

Telegraf release 버전

1.16.0
1.15.4
1.14.5
1.13.2
1.12

컴파일 설치

사전 준비 사항

  • Golang SDK 구성.

  • go dep 설치

  • 소스파일
    Telegraf release 버전에 whatap plugin을 포함한 소스파일입니다.

${GOPATH}/src/github.com/influxdata/telegraf/ 디렉토리 밑에 압축을 해제합니다.

절차

${GOPATH}/src/github.com/influxdata/telegraf 이하 Makefile로 빌드를 진행합니다.

  1. 의존성 설치를 진행합니다. 의존성 설치는 go dep을 사용하기 때문에 go dep이 먼저 설치되어야 합니다.

    # make deps
  2. 실행파일을 빌드합니다.
    ${GOPATH}/bin 디렉토리에 실행파일(telegraf)이 생성됩니다.

    # make go-install

설치 패키지가 필요하다면 make package 명령어로 생성할 수 있습니다. 크로스 컴파일을 진행하여 운영체제 별로 패키지 파일을 생성합니다.

# make package
상세한 빌드의 설명은 Telegraf github 내용을 참고해 주세요
https://github.com/influxdata/telegraf

설정

Telegraf의 config 파일(telegraf.conf)에 아래 outputs.whatap 설정을 활성화합니다.

whatap plugin이 포함된 config 파일은 아래와 같이 생성할 수 있습니다.

# telegraf --sample-config > telegraf.conf

whatap 프로젝트 정보

http://whatap.io에서 프로젝트의 정보를 설정합니다. 연결할 프로젝트의 에이전트 설치 안내에서 확인 가능합니다.

  • 프로젝트 라이선스 키 : 프로젝트를 식별하는 라이선스 키입니다.

  • 프로젝트 코드: 프로젝트를 식별하는 숫자형 코드입니다.

  • 수집서버 정보 (아이피, 포트): 수집 정보를 전달할 와탭 수집 서버의 아이피와 포트입니다.

config 설정(toml)

  • [[outputs.whatap]] 주석(#)을 삭제합니다.

  • license의 주석(#)을 삭제합니다. 프로젝트의 라이선스 키 정보를 입력합니다. (문자형으로 입력합니다.)

  • pcode의 주석(#)을 삭제합니다. 프로젝트 코드를 입력합니다. (숫자형으로 입력합니다.)

  • servers의 주석(#)을 삭제합니다. 수집서버 정보(아이피,포트)를 설정합니다.
    프로토콜은 tcp만 지원합니다. 문자 형식으로 "tcp://아이피:포트"를 등록합니다.
    배열 형식으로 등록합니다. 콤마(,)로 구분하여 배열 형식으로 등록합니다.

/etc/telegraf/telegraf.conf
# # Configuration for WhaTap
[[outputs.whatap]]
#   ## You can create a project on the WhaTap site(https://www.whatap.io)
#   ## to get license, project code and server IP information.
#
#   ## WhaTap license. Required
license = "x2tggtnopk2t9-xxxxxxxxxx-aaaaaaaaaa"
#
#   ## WhaTap project code. Required
pcode = 118
#
#   ## WhaTap server IP. Required
#   # Put multiple IPs with / as delimiters. e.g. "1.1.1.1/2.2.2.2"

servers = ["tcp://1.2.3.4:6600", "tcp://5.6.7.8:6600"]

#   ## Connection timeout.
#   # timeout = "60s"
Telegraf를 다시 시작해야 변경된 설정이 적용됩니다.