Quick Installation Guide on Windows Agent node
Salt Minion Install
Installer Download: https://github.com/snetsystems/salt/releases/download/v3001.4-5/Salt-Minion-3001.4-Py3-x86-Setup.exe
Salt-Minion-3001.4-Py3-x86-Setup.exe을 실행한 후, 아래 화면에서 Minion Name은 비워둡니다.
아래 화면이 나오면 “예(Y)”를 클릭합니다.
Minion config 설정을 위해 minion 실행은 하지 않고 “Finish”를 클릭하여 종료합니다.
Config Path:
C:\salt\conf\minion
(default salt root path:c:\salt
)
주의 아래 설정 파일에는 주석 포함하여 영문 외 2 Byte 문자(예, 한글, 일본어, 중국어 등)가 포함되지 않도록 주의해야 합니다.## log_level ## # One of 'garbage', 'trace', 'debug', info', 'warning'(default), 'error', 'critical'. log_level: info master: <master ip address> id: <유일한 minion id 설정해야 하며, 생략 시, hostname = minion id> multiprocessing: False # The maximum number of bytes a single log file may contain before it is rotated. # A value of 0 disables this feature. # Currently only supported on Windows. # On other platforms, use an external tool such as 'logrotate' to manage log files. log_rotate_max_bytes: 314572800 #300MB # The number of backup files to keep when rotating log files. # Only used if log_rotate_max_bytes is greater than 0. # Currently only supported on Windows. # On other platforms, use an external tool such as 'logrotate' to manage log files. log_rotate_backup_count: 7
윈도우 서비스에서 salt-minion 시작.
CloudHub Portal 로그인 →“Agent Configuration > Minions” 메뉴 화면에서 새로 등록된 minion을 Operation 버튼을 통해 “Accept”합니다.
Telegraf Install
윈도우 버전 설치에 관한 자세한 내용은 https://github.com/snetsystems/telegraf/blob/release-1.19-snet/docs/WINDOWS_SERVICE.md를 참고 바랍니다.
Installer Download: https://github.com/snetsystems/telegraf/releases 에서 최신 버전의 telegraf-xxx_windows_amd64.zip를 다운로드 후 압축 해제 합니다.
C:\Program Files\Telegraf 디렉터리를 만듭니다(다른 위치에 설치하는 경우 원하는 위치에 --config 매개변수를 지정하기만 하면 됩니다).
telegraf.exe
및telegraf.conf
구성 파일을C:\Program Files\Telegraf
에 넣습니다.Windows 서비스 관리자에 서비스를 설치하려면 PowerShell에서 관리자 모드로 다음을 실행합니다(필요한 경우 파일 경로의 공백을 큰따옴표 ""로 묶을 수 있음).
> C:\"Program Files"\Telegraf\telegraf.exe --service install
telegraf.conf
을 편집합니다.
노트 Telegraf on Windows 설정에 관한 자세한 내용은 Telegraf Configuration 항목을 참고 바랍니다.윈도우 서비스에서 “Telegraf Data Collector Service”를 시작합니다.
정상 작동 확인을 위해 아래와 같이 윈도우 이벤트 뷰어를 실행 > “사용자 지정 보기 만들기”를 설정합니다.
아래와 같이 적당한 이름을 넣고 [확인]을 클릭합니다.
아래 화면과 같이 에러 로그 등의 비정상 로그가 없다면 정상 작동 하고 있을 것 입니다.
설정한 Configuration에 대한 validation check를 위해 다음 실행할 수 있습니다.> .\telegraf.exe --test --debug --config C:"Program Files"\Telegraf\telegraf.conf
단, 이 경우는 telegraf.conf에서 logtarget = "eventlog"
→ # logtarget = "eventlog"
로 주석 처리하고 위 명령을 실행해야 에러 로그 등이 정상 출력 됩니다.
주의 테스트가 끝난 후, 반드시 logtarget = "eventlog"
로 다시 복원하여 주십시오.
Troubleshoot: inputs.win_perf_counters 관련 수집이 되지 않는 경우 참고.