모니터링 에이전트 설치하기

페이지 이동경로

모니터링 에이전트 설치하기

Monitoring 서비스 사용에 앞서 모니터링 에이전트를 설치해야 합니다. 모니터링 에이전트 설치는 운영체제(OS)에 따라 Linux와 Windows로 구분됩니다. 운영체제별 모니터링 에이전트 설치 방법은 다음과 같습니다.

안내
금융리전(kr-central-2) 사용 시, 별도의 엔드포인트(Endpoint)에 접근하여 에이전트를 설치해야 합니다.
에이전트 설치 후 실제 데이터 수집까지 약 3분 정도 소요됩니다.

사전 작업

모니터링 에이전트를 설치하기 위해서는 사용자 액세스 키를 발급받아야 합니다.
자세한 설명은 Kakado i Cloud console > 설정 가이드 문서의 사용자 액세스 키 발급하기를 참고하시기 바랍니다.

Linux 사용자

Linux OS가 설치된 인스턴스에서 모니터링 에이전트를 설치하는 방법은 다음과 같습니다.

  1. 인스턴스의 OS를 확인 후, SSH로 접속합니다.
  2. 다음 명령어를 사용하여 에이전트를 설치합니다.

    코드 예제 CentOS 명령어

     sudo yum localinstall https://objectstorage.kr-central-1.kakaoi.io/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent-0.8.7.x86_64.rpm
    

    코드 예제 CentOS 명령어 - 금융리전(kr-central-2)

     sudo yum localinstall https://objectstorage.kr-central-2.kakaoi.io/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent-0.8.7.x86_64.rpm
    

    코드 예제 Ubuntu 명령어

     wget https://objectstorage.kr-central-1.kakaoi.io/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent_0.8.7_amd64.deb
     sudo dpkg -i kic_monitor_agent_0.8.7_amd64.deb
    

    코드 예제 Ubuntu 명령어 - 금융리전(kr-central-2)

     wget https://objectstorage.kr-central-2.kakaoi.io/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent_0.8.7_amd64.deb
     sudo dpkg -i kic_monitor_agent_0.8.7_amd64.deb
    
  3. /etc/default/kic_monitor_agent 파일을 수정합니다.
    {전송할 로그 파일 경로}에 파일이 없을 시, log 형식의 파일을 새로 생성해야 합니다.

    코드 예제 kic_monitor_agent 파일 수정

     KIC_LOG_FILE_PATH="전송할 로그 파일 경로"
     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="사용자 액세스 보안 키"
     ## 호스트가 직접 Public 망에 접속하지 못할 경우, HTTP Proxy 서버를 지정할 수 있습니다.
     # HTTP_PROXY=http://proxy
     # HTTPS_PROXY=https://proxy
     # NO_PROXY=169.254.169.254
    

    코드 예제 kic_monitor_agent 파일 수정 - 금융리전 (kr-central-2)

     KIC_LOG_FILE_PATH="전송할 로그 파일 경로"
     KIC_MONITOR_ENDPOINT_URL="https://lma.kr-central-2.kakaoi.io"
     KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_ID="사용자 액세스 키 ID"
     KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_SECRET="사용자 액세스 보안 키"
     ## 호스트가 직접 Public 망에 접속하지 못할 경우, HTTP Proxy 서버를 지정할 수 있습니다.
     # HTTP_PROXY=http://proxy
     # HTTPS_PROXY=https://proxy
     # NO_PROXY=169.254.169.254
    

    kic_monitor_agent 파일 수정

    항목 설명
    KIC_LOG_FILE_PATH 전송할 로그 파일 경로 입력
    - 파일이 없다면 log 형식의 파일을 새로 생성해야 함
    KIC_MONITOR_ENDPOINT_URL https://lma.kr-central-1.kakaoi.io 입력
    - 단, 금융리전(kr-central-2) 사용 시 https://lma.kr-central-2.kakaoi.io 입력
    KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_ID 콘솔에서 발급받은 사용자 액세스 키 ID 입력
    - 액세스 키 생성 시점 또는 사용자 액세스 키 목록에서 해당 액세스 키 항목을 클릭하여 조회 가능
    KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_SECRET 콘솔에서 발급받은 사용자 액세스 보안 키 입력
    - 액세스 키 생성 시점에만 조회 가능
  4. 다음 명령어를 사용하여 에이전트를 실행합니다.

    코드 예제 에이전트 실행 명령어

     sudo systemctl start kic_monitor_agent // 에이전트 수동 시작
     sudo systemctl enable kic_monitor_agent // enable로 설정하면, 컴퓨터 부팅 시 에이전트 자동 시작
    
  5. 에이전트가 정상적으로 실행되었는지 확인합니다.

    코드 예제 에이전트 실행 확인

     sudo journalctl -u kic_monitor_agent -f
    

Windows 사용자

Windows OS가 설치된 인스턴스에 모니터링 에이전트를 설치하는 방법은 다음과 같습니다.

이미지 이미지 모니터링 에이전트 설치하기 - Windows 사용자

  1. 작업 표시줄에 위치한 검색창에 cmd을 검색하여 관리자 권한으로 명령 프롬프트를 실행 후, powershell 명령어를 입력하여 실행합니다.
  2. Object Storage로부터 압축 파일(.zip)을 가져옵니다

    코드 예제 압축 파일 가져오기 명령어

     Invoke-WebRequest https://objectstorage.kr-central-1.kakaoi.io/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent-0.8.7_windows_amd64.zip -OutFile kic_monitor_agent-0.8.7_windows_amd64.zip
    

    코드 예제 압축 파일 가져오기 명령어 - 금융리전(kr-central-2) 사용

     Invoke-WebRequest https://objectstorage.kr-central-2.kakaoi.io/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent-0.8.7_windows_amd64.zip -OutFile kic_monitor_agent-0.8.7_windows_amd64.zip
    
  3. 다음 명령어를 사용하여 압축 파일을 해제합니다.

    코드 예제 압축 파일 해제 명령어

     Expand-Archive -Path kic_monitor_agent-0.8.7_windows_amd64.zip
    
  4. 압축 파일을 푼 디렉터리로 이동합니다.

    코드 예제 디렉터리 이동

     cd .\kic_monitor_agent-0.8.7_windows_amd64\kic_monitor_agent-0.8.7
    
  5. 다음 명령어를 사용하여 에이전트를 설치합니다.

    코드 예제 에이전트 최초 실행

     powershell.exe ./kic_monitor_agent_install.ps1 "https://lma.kr-central-1.kakaoi.io" "발급받은 사용자 액세스 키의 ID" "발급받은 사용자 액세스 키의 Secret"
    

    코드 예제 에이전트 최초 실행 - 금융리전(kr-central-2) 사용

     powershell.exe ./kic_monitor_agent_install.ps1 "https://lma.kr-central-2.kakaoi.io" "발급받은 사용자 액세스 키의 ID" "발급받은 사용자 액세스 키의 Secret"
    

    코드 예제 에이전트 재부팅

     ./kic_monitor_agent_ctl.ps1 -a start
    
  6. 에이전트가 설치된 이후, 에이전트를 컨트롤하는 명령어는 다음과 같습니다.

    코드 예제 에이전트 컨트롤 명령어

     ./kic_monitor_agent_ctl.ps1 -a status // 현재 상태를 확인
     ./kic_monitor_agent_ctl.ps1 -a start // 에이전트를 재부팅
     ./kic_monitor_agent_ctl.ps1 -a stop // 에이전트를 정지