본문으로 건너뛰기

모니터링 에이전트 설치

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

안내

에이전트 설치 후 실제 데이터 수집까지 약 3분 정도 소요됩니다.
사용자 애플리케이션 사용률이 높을 때에는 모니터링 에이전트에서의 메트릭, 로그 수집이 안될 수 있습니다.
모니터링 에이전트 0.9.5 이하 사용자는 cgroup으로 사용자의 애플리케이션의 CPU와 메모리 사용률을 95%로 이하로 설정하는 것을 권장드립니다.

사전 작업

해당 가이드를 진행하기 위해서는 모니터링 에이전트를 설치할 인스턴스와 사용자 액세스 키 발급이 필요합니다.
자세한 설명은 각각 인스턴스 생성 및 연결사용자 액세스 키 발급을 참고하시기 바랍니다.

Linux 사용자

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

  1. 프라이빗 키(.Pem 형식)가 위치한 경로로 이동합니다.

  2. 인스턴스의 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}VM > Instance 탭에서 사전에 생성한 인스턴스 클릭 후, Network 탭에서 확인 가능
    -퍼블릭 IP를 할당하지 않을 경우, Bastion 등의 설정이 필요함
  3. 다음 명령어를 사용하여 에이전트를 설치합니다.

    CentOS 명령어
    sudo yum localinstall https://objectstorage.kr-central-2.kakaoi.io/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent-0.9.5.x86_64.rpm
    Ubuntu 명령어
    wget https://objectstorage.kr-central-2.kakaoi.io/v1/52867b7dc99d45fb808b5bc874cb5b79/kic-monitoring-agent/package/kic_monitor_agent_0.9.5_amd64.deb
    sudo dpkg -i kic_monitor_agent_0.9.5_amd64.deb
  4. vi 명령어를 이용하여 /etc/default/kic_monitor_agent 파일을 수정합니다.

    kic_monitor_agent 파일 열기
    sudo vi /etc/default/kic_monitor_agent
    kic_monitor_agent 파일 수정
    KIC_LOG_FILE_PATH="전송할 로그 파일 경로"
    KIC_MONITOR_ENDPOINT_URL="https://monitoring.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_LOG_FILE_PATH사용자가 전송할 로그 파일의 경로를 입력
    - 선택사항이며 전송한 로그는 로그 탐색기를 통해 조회 가능
    - 파일이 없다면 log 형식의 파일을 지정해야 함
    KIC_MONITOR_ENDPOINT_URLhttps://monitoring.kr-central-2.kakaoi.io 입력
    KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_ID콘솔에서 발급받은 사용자 액세스 키 ID 입력
    - 액세스 키 생성 시점 또는 사용자 액세스 키 목록에서 해당 액세스 키 항목을 클릭하여 조회 가능
    KIC_MONITOR_AGENT_AUTH_APPLICATION_CREDENTIAL_SECRET콘솔에서 발급받은 사용자 액세스 보안 키 입력
    - 액세스 키 생성 시점에만 조회 가능
  5. 다음 명령어를 사용하여 에이전트를 실행합니다.

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

    에이전트 실행 확인
    sudo journalctl -u kic_monitor_agent -f

Windows 사용자

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

  1. 작업 표시줄에 위치한 검색창에 cmd을 검색하여 관리자 권한으로 명령 프롬프트를 실행 후, powershell 명령어를 입력하여 실행합니다.

  2. Object Storage로부터 압축 파일(.zip)을 가져옵니다

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

    압축 파일 해제 명령어
    Expand-Archive -Path kic_monitor_agent-0.9.5_windows_amd64.zip
  4. 압축 파일을 푼 디렉터리로 이동합니다.

    디렉터리 이동
    cd .\kic_monitor_agent-0.9.5_windows_amd64\kic_monitor_agent-0.9.5
  5. 다음 명령어를 사용하여 에이전트를 설치합니다. 에이전트 버전 업그레이드를 진행할 경우에는 기존 에이전트를 삭제 후 설치를 진행합니다.

    에이전트 삭제 (에이전트 버전 업그레이드를 진행하는 경우)
    ./kic_monitor_agent_uninstall.ps1
    에이전트 최초 실행
    powershell.exe ./kic_monitor_agent_install.ps1 "https://monitoring.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 // 에이전트를 정지