Monitoring service migration guide

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 collect performance information by installing the Agent on the server. The Agents used by Monitoring and Cloud Insight are different and are not compatible with each other. Therefore, refer to the following guide to remove the Monitoring Agent from your existing server and install the Cloud Insight Agent:

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

How to check the Agent version installed on the server

You can check whether the Monitoring Agent is installed as follows.
If the Monitoring Agent is installed, you need to remove it and install the Cloud Insight Agent to enable monitoring through Cloud Insight.

Linux

Run the following command. If the noms_nsight -start process is running, the Monitoring Agent is operating 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 Monitoring Agent is operating and needs to be updated.

Removing the Monitoring Agent and installing the Cloud Insight Agent

You can remove the Monitoring Agent and install the Cloud Insight Agent as follows:

Linux

For Linux, see the following:

Remove the Monitoring Agent and install the Cloud Insight Agent
To remove the Monitoring Agent and install the Cloud Insight Agent:

Save the following script as a file on the server, and then run it. The entire process must be performed with root permissions.

% bash uninstall_nsight1_install_nsight2.sh

Alternatively, you can download the 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 the agent_updater.py, agent.py processes are running, the Agent is working normally.
Use Cloud Insight to confirm that Metric Data for the server is displayed.

Windows

For Windows, see the following:

Remove the Monitoring Agent and install the Cloud Insight Agent
To remove the Monitoring Agent and install the Cloud Insight Agent:

1. Using a PowerShell script
You can also download the 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 the Monitoring Agent

1. In Services, stop 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 the Cloud Insight Agent

1. Navigate to the Agent installation folder: C:\Program Files (x86)\NBP.
   Create a folder if it does not exist.
2. Download the package to the above folder.
   • VM:

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

   • Bare Metal

     Copy and paste https://repo-nsight.ncloud.com/agent_controller_windows_pub_bm.zip into the 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.

Cloud Insight Agent troubleshooting

Learn how to resolve issues with Cloud Insight Agent.

Q1. My server is hanging, and Metrics are not being collected or notifications sent.

A. When the server hangs, the Agent cannot run because it is not allocated CPU resources. 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.

My Chart

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.

Items that can't be migrated to Cloud Insight

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:

• Cloud Log Analytics overview
• Collect 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 guide