모니터링 에이전트 설치
Monitoring 서비스 사용에 앞서 모니터링 에이전트를 설치해야 합니다. 모니터링 에이전트 설치는 운영체제(OS)에 따라 Linux와 Windows로 구분됩니다. 운영체제별 모니터링 에이전트 설치 방법은 다음과 같습니다.
에이전트 설치 후 실제 데이터 수집까지 약 3분 정도 소요됩니다.
사용자 애플리케이션 사용률이 높을 경우, 모니터링 에이전트에서의 메트릭, 로그 수집이 안 될 수 있습니다.
모니터링 에이전트 v1.0.0 이하 사용자는 cgroup으로 사용자의 애플리케이션의 CPU와 메모리 사용률을 95% 이하로 설정하는 것을 권장합니다.
사전 작업
해당 가이드를 진행하기 위해서는 모니터링 에이전트를 설치할 인스턴스와 액세스 키 발급이 필요합니다.
자세한 설명은 각각 인스턴스 생성 및 연결 및 액세스 키 발급을 참고 하시기 바랍니다.
Linux 사용자
Linux OS가 설치된 인스턴스에서 모니터링 에이전트를 설치하는 방법은 다음과 같습니다.
- kr-central-1
- kr-central-2
-
프라이빗 키(
.Pem
형식)가 위치한 경로로 이동합니다. -
인스턴스의 OS를 확인 후, SSH로 해당 인스턴스에 접속합니다.
CentOS 명령어chmod 400 {PRIVATE_KEY}.pem # 읽기 권한 부여
ssh -i {PRIVATE_KEY}.pem centos@{INSTANCE_IP}ubuntu 명령어chmod 400 {PRIVATE_KEY}.pem # 읽기 권한 부여
ssh -i {PRIVATE_KEY}.pem ubuntu@{INSTANCE_IP}항목 설명 {PRIVATE_KEY}
프라이빗 키 파일 이름 {INSTANCE_IP}
Virtual Machine > 인스턴스에서 사전에 생성한 인스턴스 클릭 후, Network 탭에서 확인 가능
- 퍼블릭 IP를 할당하지 않을 경우, Bastion 등의 설정이 필요함 -
다음 명령어를 사용하여 에이전트를 설치합니다.
CentOS 명령어sudo yum localinstall https://objectstorage.kr-central-1.kakaocloud.com/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent-1.0.0.x86_64.rpm
Ubuntu 명령어wget https://objectstorage.kr-central-1.kakaocloud.com/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent_1.0.0_amd64.deb
sudo dpkg -i kic_monitor_agent_1.0.0_amd64.deb -
vi
명령어를 이용하여/etc/default/kic_monitor_agent
파일을 수정합니다.kic_monitor_agent 파일 열기sudo vi /etc/default/kic_monitor_agent
kic_monitor_agent 파일 수정KIC_MONITOR_ENDPOINT_URL="https://lma.kr-central-1.kakaoi.io"
# 발급받은 사용자 API 키의 ID
KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_ID=""
# 발급받은 사용자 API 키의 Secret
KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_SECRET=""
# 전송할 로그 파일 경로
KIC_LOG_FILE_PATH=""
## 호스트가 직접 Public 망에 접속하지 못할 경우, HTTP Proxy 서버를 지정할 수 있습니다.
#HTTP_PROXY=http://proxy
#HTTPS_PROXY=https://proxy
#NO_PROXY=169.254.169.254항목 설명 KIC_LOG_FILE_PATH 사용자가 전송할 로그 파일의 경로를 입력
- 선택사항이며 전송한 로그는 로그 탐색기를 통해 조회 가능
- 파일이 없다면 log 형식의 파일을 지정해야 함KIC_MONITOR_ENDPOINT_URL https://lma.kr-central-1.kakaoi.io
입력KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_ID 콘솔에서 발급받은 액세스 키 ID 입력
- 액세스 키 생성 시점 또는 액세스 키 목록에서 해당 액세스 키 항목을 클릭하여 조회 가능KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_SECRET 콘솔에서 발급받은 보안 액세스 키 입력
- 액세스 키 생성 시점에만 조회 가능 -
다음 명령어를 사용하여 에이전트를 실행합니다.
에이전트 실행 명령어sudo systemctl restart kic_monitor_agent // 에이전트 수동 시작
sudo systemctl enable kic_monitor_agent // enable로 설정하면, 컴퓨터 부팅 시 에이전트 자동 시작 -
에이전트가 정상적으로 실행되었는지 확인합니다.
에이전트 실행 확인sudo journalctl -u kic_monitor_agent -f
-
프라이빗 키(
.Pem
형식)가 위치한 경로로 이동합니다. -
인스턴스의 OS를 확인 후, SSH로 해당 인스턴스에 접속합니다.
CentOS 명령어chmod 400 {PRIVATE_KEY}.pem # 읽기 권한 부여
ssh -i {PRIVATE_KEY}.pem centos@{INSTANCE_IP}ubuntu 명령어chmod 400 {PRIVATE_KEY}.pem # 읽기 권한 부여
ssh -i {PRIVATE_KEY}.pem ubuntu@{INSTANCE_IP}항목 설명 {PRIVATE_KEY}
프라이빗 키 파일 이름 {INSTANCE_IP}
Virtual Machine > 인스턴스에서 사전에 생성한 인스턴스 클릭 후, Network 탭에서 확인 가능
-퍼블릭 IP를 할당하지 않을 경우, Bastion 등의 설정이 필요함 -
다음 명령어를 사용하여 에이전트를 설치합니다.
CentOS 명령어sudo yum localinstall https://objectstorage.kr-central-2.kakaocloud.com/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent-1.0.0.x86_64.rpm
Ubuntu 명령어wget https://objectstorage.kr-central-2.kakaocloud.com/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent_1.0.0_amd64.deb
sudo dpkg -i kic_monitor_agent_1.0.0_amd64.deb -
vi
명령어를 이용하여/etc/default/kic_monitor_agent
파일을 수정합니다.kic_monitor_agent 파일 열기sudo vi /etc/default/kic_monitor_agent
kic_monitor_agent 파일 수정KIC_MONITOR_ENDPOINT_URL="https://monitoring.kr-central-2.kakaocloud.com"
# 발급받은 사용자 API 키의 ID
KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_ID=""
# 발급받은 사용자 API 키의 Secret
KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_SECRET=""
# 전송할 로그 파일 경로
KIC_LOG_FILE_PATH=""
## 호스트가 직접 Public 망에 접속하지 못할 경우, HTTP Proxy 서버를 지정할 수 있습니다.
# HTTP_PROXY=http://proxy
# HTTPS_PROXY=https://proxy
# NO_PROXY=169.254.169.254항목 설명 KIC_LOG_FILE_PATH 사용자가 전송할 로그 파일의 경로를 입력
- 선택사항이며 전송한 로그는 로그 탐색기를 통해 조회 가능
- 파일이 없다면 log 형식의 파일을 지정해야 함KIC_MONITOR_ENDPOINT_URL https://monitoring.kr-central-2.kakaocloud.com
입력KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_ID 콘솔에서 발급받은 액세스 키 ID 입력
- 액세스 키 생성 시점 또는 액세스 키 목록에서 해당 액세스 키 항목을 클릭하여 조회 가능KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_SECRET 콘솔에서 발급받은 보안 액세스 키 입력
- 액세스 키 생성 시점에만 조회 가능 -
다음 명령어를 사용하여 에이전트를 실행합니다.
에이전트 실행 명령어sudo systemctl restart kic_monitor_agent // 에이전트 수동 시작
sudo systemctl enable kic_monitor_agent // enable로 설정하면, 컴퓨터 부팅 시 에이전트 자동 시작 -
에이전트가 정상적으로 실행되었는지 확인합니다.
에이전트 실행 확인sudo journalctl -u kic_monitor_agent -f
Windows 사용자
Windows OS가 설치된 인스턴스에 모니터링 에이전트를 설치하는 방법은 다음과 같습니다.
- kr-central-1
- kr-central-2
-
작업 표시줄에 위치한 검색창에
cmd
을 검색하여 관리자 권한으로 명령 프롬프트를 실행 후,powershell
명령어를 입력하여 실행합니다. -
Object Storage로부터 압축 파일(
.zip
)을 가져옵니다압축 파일 가져오기 명령어Invoke-WebRequest https://objectstorage.kr-central-1.kakaocloud.com/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent-1.0.0_windows_amd64.zip -OutFile kic_monitor_agent-1.0.0_windows_amd64.zip
-
다음 명령어를 사용하여 압축 파일을 해제합니다.
압축 파일 해제 명령어Expand-Archive -Path kic_monitor_agent-1.0.0_windows_amd64.zip
-
압축 파일을 푼 디렉터리로 이동합니다.
디렉터리 이동cd .\kic_monitor_agent-1.0.0_windows_amd64\kic_monitor_agent-1.0.0
-
다음 명령어를 사용하여 에이전트를 설치합니다. 에이전트 버전 업그레이드를 진행할 경우에는 기존 에이전트를 삭제 후 설치를 진행합니다.
에 이전트 삭제 (에이전트 버전 업그레이드를 진행하는 경우)./kic_monitor_agent_uninstall.ps1
에이전트 최초 실행powershell.exe ./kic_monitor_agent_install.ps1 "https://lma.kr-central-1.kakaoi.io" "발급받은 액세스 키의 ID" "발급받은 액세스 키의 Secret"
전송해야 할 로그파일이 있을 경우powershell.exe ./kic_monitor_agent_install.ps1 "https://lma.kr-central-1.kakaoi.io" "발급받은 액세스 키의 ID" "발급받은 액세스 키의 Secret" "로그 파일의 절대 경로"
에이전트 재부팅./kic_monitor_agent_ctl.ps1 -a stop
./kic_monitor_agent_ctl.ps1 -a start -
에이전트가 설치된 이후, 에이전트가 정상적으로 실행되었는지 확인합니다.
에이전트 실행 확인Get-Content 'C:\Program Files\KicMonitorAgent\kic_monitor_agent.log' -Wait -Tail 10
-
작업 표시줄에 위치한 검색창에
cmd
을 검색하여 관리자 권한으로 명령 프롬프트를 실행 후,powershell
명령어를 입력하여 실행합니다. -
Object Storage로부터 압축 파일(
.zip
)을 가져옵니다압축 파일 가져오기 명령어Invoke-WebRequest https://objectstorage.kr-central-2.kakaocloud.com/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent-1.0.0_windows_amd64.zip -OutFile kic_monitor_agent-1.0.0_windows_amd64.zip
-
다음 명령어를 사용하여 압축 파일을 해제합니다.
압축 파일 해제 명령어Expand-Archive -Path kic_monitor_agent-1.0.0_windows_amd64.zip
-
압축 파일을 푼 디렉터리로 이동합니다.
디렉터리 이동cd .\kic_monitor_agent-1.0.0_windows_amd64\kic_monitor_agent-1.0.0
-
다음 명령어를 사용하여 에이전트를 설치합니다. 에이전트 버전 업그레이드를 진행할 경우에는 기존 에이전트를 삭제 후 설치를 진행합니다.
에이전트 삭제 (에이전트 버전 업그레이드를 진행하는 경우)./kic_monitor_agent_uninstall.ps1
에이전트 최초 실행powershell.exe ./kic_monitor_agent_install.ps1 "https://monitoring.kr-central-2.kakaocloud.com" "발급받은 액세스 키의 ID" "발급받은 액세스 키의 Secret"
전송해야 할 로그파일이 있을 경우powershell.exe ./kic_monitor_agent_install.ps1 "https://monitoring.kr-central-2.kakaocloud.com" "발급받은 액세스 키의 ID" "발급받은 액세스 키의 Secret" "로그 파일의 절대 경로"
에이전트 재부팅./kic_monitor_agent_ctl.ps1 -a stop
./kic_monitor_agent_ctl.ps1 -a start -
에이전트가 설치된 이후, 에이전트가 정상적으로 실행되었는지 확인합니다.
에이전트 실행 확인Get-Content 'C:\Program Files\KicMonitorAgent\kic_monitor_agent.log' -Wait -Tail 10