ZCM(ZMON Config Manager)을 통한 Telegraf Config 설정안내

Print

개요

ZMON Telegraf설치 및 Cloud Z Monitoring 시스템 연동설정 이후 ZCM(ZMON Config Manager)를 통해
ZMC(ZMON Management Console)에서 Telegraf Config를 직접 설정하여 적용할 수 있다.

2020년 7월 9일 이후 버전의 ZMON 설치의 경우 ZCM이 Telegraf 와 같이 설치되므로 따로 설치하지 않아도 되나, 이전 버전의 ZMON 이 설치된 경우, ZCM agent 를 추가로 설치해야 사용가능하다.

ZCM 설치

2020년 7월 9일 이후 버전의 ZMON Telegraf 설치 시 install 명령으로 설치하면 자동으로 같이 설치되므로, 기존에 이미 ZMON을 설치하여 별도로 ZCM 설치를 해야하는 경우에만 아래의 방법을 사용하다.

설치 후 telegraf 및 ZCM은 자동으로 시작된다.

  • for Linux:

    $ curl -fsSL http://agent.zmon.cloud/agents/installers/zmon-installer -o zmon-installer
    $ chmod +x zmon-installer
    $ sudo ./zmon-installer install-manager-only -u {account_id} -p {account_password}
  • for Windows (관리자 권한의 powershell 에서 실행) :

    PS> curl http://agent.zmon.cloud/agents/installers/zmon-installer.exe -o zmon-installer.exe
    PS> zmon-installer.exe install-manager-only -u {account_id} -p {account_password}

Linux OS 사용자는 ZCM start / stop / restart / reinstall / uninstall 등의 사용을 위해 최초 한 번 실행권한을 준다.

$ cd /etc/zmon-manager
$ chmod +x zmon-manager 

설치가 완료후 ZCM start / stop / restart 실행 시 아래의 방법을 이용한다.

  • for Linux:

    $ cd /etc/zmon-manager 
    $ sudo ./zmon-manager start | restart | stop
  • for Windows (관리자 권한의 powershell 에서 실행) :

    PS> zmon-manager.exe start | restart | stop 

ZCM 만을 재설치 할 경우 아래의 방법을 이용한다.

  • for Linux:

    $ sudo /etc/zmon-manager/zmon-manager -u {account_id} -p {account_password} reinstall
  • for Windows (관리자 권한의 powershell 에서 실행) :

    PS> zmon-installer.exe -u {account_id} -p {account_password} reinstall

ZCM만을 삭제 할경우 아래의 방법을 이용한다.

  • for Linux:

    $ sudo /etc/zmon-manager/zmon-manager uninstall
  • for Windows (관리자 권한의 powershell 에서 실행) :

    PS> zmon-installer.exe uninstall

ZCM 연동확인(ZMON Management Console 에서 확인)

  1. ZMC(ZMON Management Console)에 접속해 Telegraf Config 메뉴를 클릭한다.

  2. ZCM 이 정상적으로 설치되면 Mapping 탭의 Agent 관리목록에 서버 및 Telegraf 상태가 표시된다.
    ※ 주의사항 : ZCM을 여러 번 재설치 하는경우 Agent관리목록에 동일한 서버가 여러 개 생성될 수 있으므로 garbage로 생성된 host는 체크박스 선택 후 Delete 버튼을 클릭하여 삭제한다. 만약 잘못 삭제한 경우 ZCM agent를 재설치 해야하므로 주의하여 삭제한다.

Telegraf 설정 적용

◎ Mapping 탭

ZCM agent 가 정상적으로 설치된경우 Mapping 탭에서 Host 를 확인 할 수 있다.

Host 와 Config(Property)를 매핑하여 Telegraf 에 Update 하거나, 현재 Telegraf 의 설정 내용을 확인 할 수 있다.

1. Agent관리목록

  • Name : Host Name을 표기한다. Name의 link 클릭시 Last Config 팝업을 호출한다. Last Config 팝업에서는 해당 Host의 telegraf.conf 파일의 설정 내용을 확인할 수 있다.

    • Title 에 최종적으로 sync 된 설정 내용의 일자가 표기된다.

    • 팝업 하단의 Sync 버튼을 클릭하면 다음 Polling 시 Host의 telegraf.conf 파일의 내용을 가져온다.
      ※ ZCM agent 와 ZMC가 일정주기로 Polling 하므로 Sync 버튼을 클릭 후 바로 data 를 가져오는 것이 아닌 Polling 주기에 따라 지연이 발생될 수 있다. (Default Polling 주기는 15초이므로, Sync 버튼 클릭 후 최대 15초 이후에 확인한다.)

  • Status : Host 의 Telegraf 상태를 나타낸다.

  • OS : Host 의 OS 를 표기한다.

  • Update Time : Mapping 된 Config 를, 실제 Host의 telegraf.conf 에 마지막으로 Update 한 일자 및 시간을 표기한다.

  • Config : Host 에 Mapping 된 Config 를 확인 할 수 있고, 이미 Mapping 되어 있는 Config Property 를 클릭시 Mapping 해제할 수 있다. ZMON Default Config Property는 파란색으로 표현되며, 사용자 설정 Config Property는 회색으로 표현된다.

2. Config 매핑

Agent관리 목록에 Host가 추가되면 ZMON Default Config Property 가 자동으로 매핑된다.

이 ZMON Default Config Property는 수정/삭제가 불가 하므로, default 와 다르게 설정하고자 할 때는

Default Config Property 를 매핑 해제하고 사용자 설정 Config Property를 추가하여 매핑한다.

  • (1) Agent 관리 목록에서 설정할 Host 의 Checkbox 를 선택한다. 이 때 여러 Host 를 중복 선택할 수 있다.

  • (2) 상단의 Property Name Selectbox 에서 Host에 매핑할 Config Property 를 선택한다. Property 도 여러 개의 추가 선택이 가능하다.

  • 선택한 Host 의 목록과 적용한 Config 를 확인하고 (3)Apply 버튼을 클릭한다.
    Apply 클릭 시 (1)Agent 관리 목록에 체크했던 Host 의 Config Property 가 추가된다.

  • Host - Config 의 매핑을 확인한 후, 매핑된 Config 를 실제 Host의 telegraf.conf 에 적용하려면 (1)의 Host를 선택후 (4)Update 버튼을 클릭한다.

  • (4)Update 버튼 클릭 후 ZCM agent 에 의해 자동으로 ZMON Telegraf 가 재시작되어 변경한 사항을 적용한다.

Apply 만 했을 경우 실제 Host의 telegraf.conf 에 적용되지 않는다. 실제 telegraf.conf 에 적용을 위해서는 Update 버튼을 클릭하여야 한다.

Update 클릭 시, 각 Config Property 들이 올바르게 설정되었는지 프로세스에 의해 확인 후 Update 를 한다.

Update 버튼 클릭 후 최대 15초 이내 telegraf.conf 에 적용된다. 적용 후 (1)Agent 관리 목록의 Update 시간이 변경되므로 해당 시간을 확인한다.

  • (1)Agent 관리 목록에 garbage 로 생성된 Host 의 경우, (5)Delete 버튼을 클릭하여 삭제한다.
    * Host 삭제 시 다시 Host를 목록에 표시하려면 ZCM agent 를 재설치해야하므로 주의하여 삭제한다.

◎ Config 탭

Telegraf 에서 제공되는 Property 단위로 Config 를 추가, 편집할 수 있다.

1. Config 목록

  • 조회조건 : 각 Selectbox 선택 시 선택된 조건이 바로 적용되어 조회된다. 단, Name 의 경우 입력 후 Enter 키 입력을 하여 조회하거나 Search 버튼을 클릭하여 조회할 수 있다.

  • OS : Config Property 의 적용 OS

  • Config : Config 구분(global_tags / agent / outputs / procssors / aggregators / inputs 등)
    Config 클릭 시 해당 Row 의 Config Property 의 상세 설정 내용을 확인 및 편집할 수 있다.
    (단, Name이 녹색으로 표기되는 ZMON Default Config Property 의 경우 수정할 수 없다. )

  • Property : Config Property 구분
    ※ 참고 : https://docs.influxdata.com/telegraf/v1.14/plugins/plugin-list/#input-plugins

  • Name : Config Property 의 사용자 정의 설정명

  • Mapping Count : Host에 매핑된(Apply 기준) Count

  • Action : X 버튼 클릭 시 해당 Row의 Config Property가 삭제된다. 단, Default Property 는 삭제가 불가능하다. Mapping Count가 0인 경우에만 삭제 가능하다.

Name 이 녹색으로 표기되는 Config Property 는 ZMON agent 설치 시 기본으로 셋팅되는 Config Property 들로 삭제 / 편집이 불가능하다.

2. Config 추가 / 편집 / 삭제

▶ Add

Add 버튼 클릭 시 Config Property 를 추가하는 화면이 뜬다.

▶ Edit

Edit 버튼 클릭시 Config Property 를 편집하는 화면이 뜬다.

Config 목록의 Config 클릭시 해당 Row 의 Config Property 의 상세 설정 내용을 확인 및 편집할 수 있다.

Config 목록에서 Name 이 녹색으로 표기되는 ZMON default Config Property 의 경우 수정 / 삭제할 수 없다.

  • OS > Config 순서로 선택하면 이에 관련된 Property가 Properties 항목에 Selectbox 로 표기되고 Property 를 입력하여 조회하여 선택할 수 있다. Property 를 선택하면 Telegraf 에서 제공하는 기본 Sample 설정이 우측창에 표시된다.

  • Name 은 ZCM 에서 사용자가 해당 Config Property 에 대해 인지하기 쉽도록 변경할 수 있다.

  • 기본 Sample 설정이 표기된 Textbox에 변경할 설정을 입력한다. 단, “[[ ]]” 표시안의 Config Property 항목은 변경하지 않는다. 해당 항목이 없을 경우 Telegraf 가 정상적으로 동작하지 않을 수 있다.
    ”#” 로 시작되는 열은 Telegraf 설정 내에서 주석으로 처리된다.
    (Telegraf 설정참고 : https://docs.influxdata.com/telegraf/v1.14/plugins/plugin-list)

  • Save 버튼을 클릭하여 저장한다.

▶ Delete

Config 목록의 가장 마지막 열인 Action 항목의 X 버튼 클릭 시 해당 열의 Config Property 가 삭제된다.

Action 항목에 X 버튼이 나타나지 않는 Config 는 ZMON Default Config Property 들로 삭제가 불가능하다.

또한 X 버튼이 있더라도 Mapping Count 가 0인 경우에만 삭제가 가능하다.

이 답변이 유용합니까? 아니오

Send feedback
도움을 드리지 못해 죄송합니다. 피드백을 주시면 이 문서의 품질을 높이겠습니다.