Monitoring 서비스 이전 가이드

Classic/VPC 환경에서 이용 가능합니다.

네이버 클라우드 플랫폼의 Classic 환경에서 제공되던 Monitoring은 2023년 10월 20일까지만 제공될 예정입니다. 2023년 10월 19일 이후에는 Classic 환경의 Server, Auto Scaling 서비스의 모니터링은 네이버 클라우드 플랫폼의 통합 모니터링 서비스인 Cloud Insight로만 모니터링이 가능합니다.

이 가이드를 통해 Monitoring을 Cloud Insight로 이전하는 방법을 확인하여 서비스 이용에 불편이 없도록 2023년 10월 19일 이전에 서비스를 이전해 주시기 바랍니다.

Server(Classic)

Monitoring, Cloud Insight는 Agent를 서버에 설치하여 성능 정보를 수집합니다. Monitoring, Cloud Insight에서 사용하고 있는 Agent는 서로 상이하여 호환이 불가능합니다. 따라서 아래 가이드를 참고하시어 기존에 운영하시던 서버에서 Monitoring 서비스의 Agent를 삭제하고, Cloud Insight Agent를 설치해야 합니다.

해당 이전 작업으로 인한 서버 재부팅은 필요하지 않습니다.

서버에 설치된 Agent 버전 확인 방법

아래와 같은 방법으로 Monitoring 서비스의 Agent가 설치되었는지 확인할 수 있습니다.
Monitoring 서비스의 Agent가 설치되어 있는 경우, Cloud Insight를 통해 모니터링할 수 있도록 해당 Agent를 삭제하고 Cloud Insight Agent의 설치가 필요합니다.

Linux

아래의 명령을 실행하여 noms_nsight -start 프로세스가 실행 중인 경우, Monitoring 서비스의 Agent 가 작동 중이므로 Agent의 업데이트가 필요합니다.

#ps -ef | grep noms_nsight 

Windows

Windows 서비스 상태를 확인합니다.

• noms_nsight의 서비스 상태를 확인합니다. 해당 서비스가 실행 중인 경우 Monitoring 서비스의 Agent 가 작동 중이므로 Agent의 업데이트가 필요합니다.

Monitoring Agent 제거 및 Cloud Insight Agent 설치

아래와 같은 방법으로 Monitoring Agent를 제거하고, Cloud Insight Agent를 설치할 수 있습니다.

Linux

Linux 환경인 경우 다음 내용을 참고해 주십시오.

Monitoring Agent 삭제, Cloud Insight Agent 설치
Monitoring Agent 삭제하고 Cloud Insight Agent 설치하는 방법은 다음과 같습니다.

아래 스크립트 내용을 서버 내부에 파일로 저장한 뒤 실행해 주십시오. 전 과정을 root 권한으로 수행해야 합니다.

% bash uninstall_nsight1_install_nsight2.sh

또는 아래 경로에서 파일로 다운로드할 수 있습니다.

uninstall_nsight1_install_nsight2.sh

#!/bin/bash

# variable
if [ -f /etc/redhat-release ]; then
    OS=$( cat /etc/redhat-release | awk '{print $1}' )
    OS_MAJOR=$( cat /etc/redhat-release | grep -Po '(?<=release )\d+' )
elif [ $( command -v lsb_release ) ]; then
    OS=$( lsb_release -i 2> /dev/null | awk '{print $3}' )
    OS_MAJOR=$( /bin/cat /etc/lsb-release | grep "DISTRIB_RELEASE" | cut -d '=' -f2 | cut -d '.' -f1 )
fi

if [ "$( dmidecode -s system-manufacturer )" == "Xen" ] || [ $(/usr/sbin/virt-what 2> /dev/null | grep -i -c xen) -ge 1 ] || [ -d /sys/bus/xen/devices/vif-0 ] || [ $(ps -ef |grep /usr/sbin/xe-daemon | grep -v grep | wc -l ) -ge 1 ]; then
    AGENT_DIR="/home1/nbpmon"
    if [ "$OS_MAJOR" = 12 ] || [ "$OS_MAJOR" = 6 ] || [ "$OS" = "Debian" ] ; then # eol
        AGENT_FILE="agent_controller_linux_ncp_eol.tar.gz"
    else
        AGENT_FILE="agent_controller_linux_ncp.tar.gz"
    fi
    AGENT_INSTALL_PARAMETER="pub-classic"
else
    AGENT_DIR="/"
    if [ "$OS_MAJOR" = 12 ] || [ "$OS_MAJOR" = 6 ] || [ "$OS" = "Debian" ] ; then # eol
        AGENT_FILE="agent_controller_linux_pub_eol_bm.tar.gz"
    else
        AGENT_FILE="agent_controller_linux_pub_common_bm.tar.gz"
    fi
    AGENT_INSTALL_PARAMETER="classic"
fi

AGENT_INSTALLER="https://repo-nsight.ncloud.com/$AGENT_FILE"

# rc.local modify
function rc_local_remove() {
    RC_LOCAL=$( cat /etc/rc.local | grep nsight )
    if [ -n "$RC_LOCAL" ]; then
        sed --follow-symlinks -i '/nsight/d' /etc/rc.local
        echo
        echo "Delete nsight_updater in /etc/rc.local >> Success"
        echo
    fi
}

# nsight service remove
function nsight_remove() {
    [ -f /home1/nbpmon/noms/nsight/bin/noms_nsight ] && /home1/nbpmon/noms/nsight/bin/noms_nsight -stop
    [ -f /etc/systemd/system/noms_nsight.service ] && systemctl stop noms_nsight.service
    [ -f /etc/systemd/system/noms_nsight.service ] && systemctl disable noms_nsight.service
    rm -rf /home1/nbpmon/noms
    [ -f /home1/nbpmon/nsight_agent_installer.bin ] && rm -f /home1/nbpmon/nsight_agent_installer.bin
    [ -f /home1/nbpmon/nsight_linux_agent_setup.sh ] && rm -f /home1/nbpmon/nsight_linux_agent_setup.sh
    [ -f /home1/nbpmon/nsight_agent_installer.bin.backup ] && rm -f /home1/nbpmon/nsight_agent_installer.bin.backup
    [ -f /home1/nbpmon/nsight_linux_agent_setup.sh.backup ] && rm -f /home1/nbpmon/nsight_linux_agent_setup.sh.backup
    [ -f /etc/init.d/noms_nsight ] && rm -f /etc/init.d/noms_nsight
    [ -f /usr/sbin/nsight_updater ] && rm -f /usr/sbin/nsight_updater
    echo
    echo "Delete NSight Agent(V1) Files >> Success"
    echo
}

# nsight updater cronjob remove
function nsight_updater_remove() {
    if [ $OS == "CentOS" ]; then
        sed -i '/nsight\|MAILTO/d' /var/spool/cron/root
        echo
        echo "Delete nsight_updater in crontab >> Success"
        echo
    elif [ $OS == "Ubuntu" ]; then
        sed -i '/nsight\|MAILTO/d' /var/spool/cron/crontabs/root
        echo
        echo "Delete nsight_updater in crontab >> Success"
        echo
    fi
}


# cloud insight install
function cloud_insight_install() {
   if [ -d /home1/nbpmon/agent_controller_linux ]; then
       systemctl stop nsight-agent
       rm -rf /home1/nbpmon/agent_controller_linux
   fi
   wget -t 1 --timeout=5 --spider ${AGENT_INSTALLER} --no-check-certificate
   if [[ 0 -eq $? ]]; then
        wget -nv -t 1 --timeout=5 -O ${AGENT_DIR}/${AGENT_FILE} ${AGENT_INSTALLER} --no-check-certificate
        tar zxvf ${AGENT_DIR}/${AGENT_FILE} -C ${AGENT_DIR}
        bash ${AGENT_DIR}/agent_controller_linux/install_agent.sh ${AGENT_INSTALL_PARAMETER}
        echo
        echo "Install Cloud Insight(V3) Agent Files >> Success"
        echo
   fi
}

function cleansing() {

    local NOMS_NSIGHT="K01noms_nsight"

    REMOVE_FILE_LIST="$AGENT_DIR/$AGENT_FILE"
    for REMOVE_FILE in $REMOVE_FILE_LIST
    do
        rm -f $REMOVE_FILE
    done

    if [ $OS == "CentOS" ]; then
        for ((i=0; i<=6; i++))
        do
            rm -f /etc/rc.d/rc$i.d/$NOMS_NSIGHT
        done
    elif [ $OS == "Ubuntu" ]; then
        for ((i=0; i<=6; i++))
        do
            rm -f /etc/rc$i.d/$NOMS_NSIGHT
        done
    fi
}

# ====================
# | Main Logic Start |
# ====================
rc_local_remove
nsight_remove
nsight_updater_remove
cloud_insight_install
cleansing

정상 동작 확인
아래 명령을 실행하여 Agent process가 실행 중인지 확인합니다.

% ps -ef | grep agent

agent_updater.py, agent.py process가 실행 중인 경우, Agent는 정상 작동 중입니다.
Cloud Insight를 통해 해당 서버의 Metric Data가 표시되는지 최종 확인합니다.

Windows

Windows 환경인 경우 다음 내용을 참고해 주십시오.

Monitoring Agent 삭제, Cloud Insight Agent 설치
Monitoring Agent 삭제하고 Cloud Insight Agent 설치하는 방법은 다음과 같습니다.

1. Powershell Script를 활용하는 방법
아래 경로에서 파일로 다운로드 하실 수도 있습니다.
uninstall_nsight1_install_nsight2.ps1

Function Uninstall_Nsight()
{
    # nsight uninstall
    if(Test-Path "C:\Program Files (x86)\NBP\NSight\uninst.exe") {
        Start-Process "C:\Program Files (x86)\NBP\NSight\uninst.exe" -PassThru -Verbose -NoNewWindow -Wait -ErrorAction Ignore
    }

    # Unregister - Nsight ScheduledTask
    if ($(Get-ScheduledTask -TaskName "nsight" -ErrorAction SilentlyContinue).TaskName -eq "nsight") {
        Unregister-ScheduledTask -TaskName "nsight" -Confirm:$False
    }
}



Function Install_CloudInsight()
{
    if(!(Test-Path "C:\Program Files (x86)\NBP\agent_controller_windows\agent.bat")) {
        #Performance Table Restore
        Start-Process "C:\Windows\SysWOW64\lodctr.exe" -ArgumentList "/R"
        Invoke-WebRequest -uri https://repo-nsight.ncloud.com/agent_controller_windows_ncp.zip | Out-Null

        # Install CloudInsight
        if ((Get-CimInstance -ClassName Win32_BIOS).Manufacturer -eq 'Xen') {
            $nsight_source = "https://repo-nsight.ncloud.com/agent_controller_windows_ncp.zip"
            $nsight_opt = "/pub-classic"
            $wget = "C:\Windows\System32\wget.exe"
        }

        else {
            $nsight_source = "https://repo-nsight.ncloud.com/agent_controller_windows_pub_bm.zip"
            $nsight_opt = "/classic"
            $wget = "C:\Windows\System32\GroupPolicy\Machine\Scripts\startup\wget.exe"
        }

        if(!(Test-Path "C:\Program Files (x86)\NBP")) {
            New-Item "C:\Program Files (x86)\NBP" -ItemType Directory
        }

        $sourceFile = "C:\Program Files (x86)\NBP\agent_controller_windows.zip"
        $targetFile = 'C:\Program Files (x86)\NBP'

        Start-Process $wget -NoNewWindow -PassThru -Wait -ArgumentList "$nsight_source -q -O ""$sourceFile"" --no-check-certificate"
        $file = Get-ChildItem -Path $sourceFile
        $shell = new-object -com shell.application
        $destination = $shell.Namespace($targetFile)
        $zip = $shell.NameSpace($file.FullName)
        foreach($item in $zip.items()) {
            $destination.copyhere($item, 0x14)
        }

        Set-Location "$targetFile\agent_controller_windows"
        Start-Process "C:\Program Files (x86)\NBP\agent_controller_windows\install_agent.bat" -ArgumentList $nsight_opt -passthru -wait
        Remove-Item -Path $sourceFile -ErrorAction Ignore
    }
}

Uninstall_Nsight
Install_CloudInsight

2. Manual하게 수행하는 방법

Monitoring Agent 삭제

1. Service에서 NOMS Nsight Service 종료

    sc.exe stop noms_nsight
   

2. C:\Program Files (x86)\NBP\NSight 폴더 삭제
3. Task Scheduler 에서 nsight 제거
4. 프로그램에서 제거

   sc.exe delete noms_nsight
   

Cloud Insight Agent 설치

1. Agent를 설치할 폴더로 이동 : C:\Program Files (x86)\NBP
   만약 해당 폴더가 존재하지 않을 시 생성해 주십시오.
2. 위의 폴더에서 패키지 다운로드
   • VM :

     https://repo-nsight.ncloud.com/agent_controller_windows_ncp.zip 를 브라우저에 붙여넣어 파일 다운로드
     
     또는
     
     wget https://repo-nsight.ncloud.com/agent_controller_windows_ncp.zip --no-check-certificate 
     

   • Bare Metal

     https://repo-nsight.ncloud.com/agent_controller_windows_pub_bm.zip 를 브라우저에 붙여넣어 파일 다운로드
     
     또는
     
     wget https://repo-nsight.ncloud.com/agent_controller_windows_pub_bm.zip --no-check-certificate          
     

3. unzip 명령어로 다운로드 받은 패키지 파일의 압축 해제
4. C:\Program Files (x86)\NBP 하위로 agent_controller_windows 폴더 이동
5. 압축 해제한 패키지 파일 실행 (실행 파일 뒤 Parameter 입력에 주의)
   • VM

     agent_controller_windows\install_agent.bat pub-classic
     

   • Bere Metal

     agent_controller_windows\install_agent.bat classic
     

3. 정상 동작 확인
Windows 서비스 상태를 확인합니다.

• nsight2_agent의 서비스 상태를 확인합니다. 해당 서비스가 실행 중인 경우 Agent는 정상 작동 중입니다.

Cloud Insight Agent 문제 해결

Cloud Insight Agent를 이용하면서 사용자가 만날 수 있는 문제 상황과 원인 및 해결 방법을 안내합니다.

Q1. 서버가 Hang이 걸려 Metric 수집도 되지 않고, 알림도 오지 않습니다.

A. 서버가 Hang이 걸리면 Agent가 CPU를 할당받지 못하기 때문에 동작하지 않습니다. Hang을 발생시키고 있는 원인인 프로세스가 Hang 상태를 스스로 해제하거나 해당 프로세스를 강제로 종료할 때까지 이 문제가 지속될 수 있습니다. 만약 서버에 아무런 입력이 되지 않을 경우, 서버를 강제로 재기동해야 할 수 있습니다. 서버가 Hang, Agent, 네트워크 이슈 등으로 정상 동작하지 않을 경우, Server(Classic) 또는 Server(VPC)의 agent_status Metric을 사용하여 확인해 주십시오.

Q2. Agent가 정상적으로 실행 중인데 Cloud Insight에 데이터가 수집되지 않습니다.

A. Agent가 정상적으로 실행 중이더라도 서버 내부 방화벽 설정, 보안 솔루션 설치 등으로 인해 Agent에서 Cloud Insight로 Outbound 통신이 막혀있을 수 있습니다. 다음 Port 목록을 확인한 후 방화벽 해제 여부를 확인해 주십시오.

Classic 환경

VPC 환경

Q3. Cloud Insight Agent를 중단하거나 재시작하려면 어떻게 해야 합니까?

A. 운영체제에 따라 아래의 Agent 중단/시작/재시작 방법을 확인해 주십시오

• Linux
  • Agent 중단: /home1/nbpmon/agent_controller_linux/stop_agent.sh를 실행해 주십시오.
  • Agent 시작: /home1/nbpmon/agent_controller_linux/start_agent.sh를 실행해 주십시오.
  • Agent 재시작: /home1/nbpmon/agent_controller_linux/restart_agent.sh를 실행해 주십시오.
• Window
  • Agent 중단: C:\Program Files(x86)\NBP\agent_controller_windows\agent.bat stop을 실행해 주십시오.
  • Agent 시작: C:\Program Files(x86)\NBP\agent_controller_windows\agent.bat start를 실행해 주십시오.

Q4. Agent의 로그를 확인하려면 어떻게 해야 합니까?

A. 운영체제에 따라 아래의 Agent 중단/시작/재시작 방법을 확인해 주십시오

• Linux: /home1/nbpmon/agent_controller_linux/logs 에서 로그 파일을 확인할 수 있습니다.
• Window: C:\Program Files (x86)\NBP\agent_controller_windows\logs 에서 로그 파일을 확인할 수 있습니다.

Monitoring, Cloud Insight의 Metric 비교

Observation, Observation Template

Monitoring 서비스의 Observation을 통해 설정 가능한 감시 항목 별 Cloud Insight의 대응 Metric 안내 드립니다.

My Chart

Monitoring 서비스의 My Chart에 추가 가능한 항목 별 Cloud Insight의 대응 Metric 안내 드립니다.

Cloud Insight로 이전이 불가능한 항목

Monitoring 서비스를 통해 제공되던 Log 감시 기능은 Cloud Insight에서는 사용할 수 없습니다.
Cloud Log Analytics 서비스를 통해 Log 감시 기능을 계속 사용할 수 있습니다.

Cloud Log Analytics는 네이버 클라우드 플랫폼에서 제공하는 통합 로그 관리 플랫폼 서비스로, 다양한 로그에 대한 수집, 분석, 저장 기능을 제공합니다. Cloud Log Analytics의 설명 및 사용 방법은 아래 가이드를 참고해 주십시오.

• Cloud Log Analytics 소개
• Cloud Log Analytics를 통한 Server 로그 수집
  • Cloud Log Analytics를 통해 Log를 수집하고자 할 경우, Server 내 Cloud Log Analytics의 로그 수집을 위한 Agent가 추가 설치되어야 합니다.
• Cloud Log Analytics 사용 > Alarm 사용자 가이드