Monitoring service migration guides

Available in Classic and VPC

The Monitoring service, which was available in the Classic environment of NAVER Cloud Platform, will only be available until October 20, 2023. After October 19, 2023, monitoring of server and auto scaling services in the classic environment can only be performed with Cloud Insight, an integrated monitoring service of NAVER Cloud Platform.

Use this guide to learn how to migrate the monitoring to Cloud Insight. To avoid any disruption to your service, migrate it before October 19, 2023.

Server(Classic)

Monitoring and Cloud Insight install an agent on the server to collect performance information. The agents used by monitoring and Cloud Insight are different and not compatible with each other. Therefore, you need to remove the monitoring service's agent from your existing server and install the Cloud Insight Agent according to the following guide.

You don't need to reboot the server for the migration.

How to check the version of agent installed on your server

You can check whether the agent for the monitoring service is installed in the following way.
If the agent for the monitoring service is installed, you will need to remove that agent and install the Cloud Insight agent to be able to monitor with Cloud Insight.

Linux

If you execute the following command to run the noms_nsight -start process, the agent of monitoring service is working and needs to be updated.

#ps -ef | grep noms_nsight 

Windows

Check the status of the Windows service.

• Check the service status of noms_nsight. If the service is running, the Agent of monitoring service is working and needs to be updated.

Removing monitoring agent and installing Cloud Insight agent

You can remove the monitoring agent and install the Cloud Insight agent in the following way.

Linux

For the Linux environment, see the following:

Deleting monitoring agent and installing Cloud Insight agent
To delete the monitoring agent and install the Cloud Insight agent, follow these steps:

Save the content of the following script as a file inside your server and run the file. The entire process must be done with root privileges.

% bash uninstall_nsight1_install_nsight2.sh

Or you can download it as a file from the following path.

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

Check normal operation
Run the following command to verify that the Agent process is running.

% ps -ef | grep agent

If agent_updater.py, agent.py process is running, the Agent is functioning properly.
Use Cloud Insight to confirm whether the metric data for the server is displayed.

Windows

For the Windows environment, see the following:

Deleting Monitoring agent and installing Cloud Insight agent
To delete the Monitoring agent and install the Cloud Insight agent, follow these steps:

1. How to use Powershell script
You can also download it as a file from the following path.
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. How to perform manually

Delete Monitoring agent

1. In service, terminate the NOMS Nsight service

    sc.exe stop noms_nsight
   

2. Delete the C:\Program Files (x86)\NBP\NSight folder
3. Remove nsight from the task scheduler
4. Remove from the program

   sc.exe delete noms_nsight
   

Install Cloud Insight Agent

1. Move to the folder where you want to install the agent: C:\Program Files (x86)\NBP
   If the folder does not exist, create it.
2. Download the package to the above folder
   • VM :

     Paste https://repo-nsight.ncloud.com/agent_controller_windows_ncp.zip into your browser to download the file
     
     or
     
     wget https://repo-nsight.ncloud.com/agent_controller_windows_ncp.zip --no-check-certificate 
     

   • Bare Metal

     Paste https://repo-nsight.ncloud.com/agent_controller_windows_pub_bm.zip into your browser to download the file
     
     or
     
     wget https://repo-nsight.ncloud.com/agent_controller_windows_pub_bm.zip --no-check-certificate          
     

3. Unzip the downloaded package file with the unzip command
4. Move the agent_controller_windows folder under C:\Program Files (x86)\NBP
5. Run the unzipped package file (be careful when entering parameters after the executable file)
   • VM

     agent_controller_windows\install_agent.bat pub-classic
     

   • Bere Metal

     agent_controller_windows\install_agent.bat classic
     

3. Check normal operation
Check the status of the Windows service.

• Check the service status of nsight2_agent. If the service is running, the agent is functioning properly.

Troubleshooting Cloud Insight agent

This document details problematic situations users may face while using Cloud Insight agent, as well as their causes and resolutions.

Q1. My server is hanging. Metric collection is not happening, and I am not getting notifications, either.

A. When there is a server hang, the agent does not work because it cannot get the CPU assigned. The problem may continue until the process causing the hang releases the hanged status on its own, or until you forcibly end the process. If you can't input anything to the server, then the server may need to be forcibly restarted. If a server is not working normally due to hangs or issues in the agent or network, use agent_status metric from Server (Classic) or Server (VPC) to perform a check.

Q2. The agent is running properly, but no data is collected in Cloud Insight.

A. The outbound communication from agent to Cloud Insight may be blocked due to reasons such as internal firewall settings of the server, installation of security solutions, and so on, even if the agent is running normally. See the following port list and check if the firewall is down.

Classic environment

VPC environment

Q3. How do I stop or restart the Cloud Insight agent?

A. Depending on your operating system, check out the following methods to stop/start/restart the agent.

• Linux
  • Stop the agent: run /home1/nbpmon/agent_controller_linux/stop_agent.sh.
  • Start the agent: run /home1/nbpmon/agent_controller_linux/start_agent.sh.
  • Restart the agent: run /home1/nbpmon/agent_controller_linux/restart_agent.sh.
• Window
  • Stop the agent: run C:\Program Files(x86)\NBP\agent_controller_windows\agent.bat stop.
  • Start the agent: run C:\Program Files(x86)\NBP\agent_controller_windows\agent.bat start.

Q4. How do I check the agent's logs?

A. Depending on your operating system, check out the following methods to stop/start/restart the agent.

• Linux: you can check log files in /home1/nbpmon/agent_controller_linux/logs.
• Windows: you can check log files in C:\Program Files (x86)\NBP\agent_controller_windows\logs.

Compare metrics of Monitoring and Cloud Insight

Observation, Observation Template

This is a guide to Cloud Insight's response metrics for each monitoring item that can be set up through observation of the Monitoring service.

This is a guide to the corresponding metrics of Cloud Insight for each item that can be added to my chart in the Monitoring service.

The log monitoring feature provided through the Monitoring service is not available in Cloud Insight.
You can use the log monitoring feature through Cloud Log Analytics service.

Cloud Log Analytics is an integrated log management platform service provided by NAVER Cloud Platform that can collect, analyze, and store various logs. For more information on Cloud Log Analytics and how to use it, see the following guides.

• About Cloud Log Analytics
• Collecting Server logs through Cloud Log Analytics
  • To collect logs through Cloud Log Analytics, you need to install an additional agent for collecting logs from Cloud Log Analytics on the Server.
• Using Cloud Log Analytics > Alarm user guides