Monitoring サービス移行ガイド

Classic/VPC環境で利用できます。

NAVERクラウドプラットフォームの Classic環境で提供されていた Monitoringは、2023年10月20日までのみ提供される予定です。2023年10月19日以降は Classic環境の Serverと Auto Scalingサービスのモニタリングは、NAVERクラウドプラットフォームの統合モニタリングサービスである 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. OSに応じて、以下の 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. OSに応じて、以下の 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を説明します。

Monitoringサービスの My Chartに追加できる項目別 Cloud Insightの対応 Metricを説明します。

Monitoringサービスを通して提供されていた Log監視機能は Cloud Insightでは使用できません。
Cloud Log Analyticsサービスを利用すると、Log監視機能を続けて使用できます。

Cloud Log Analyticsは、NAVERクラウドプラットフォームで提供する統合ログ管理プラットフォームサービスであり、様々なログに対する収集、分析、保存機能を提供します。Cloud Log Analyticsの説明と使用方法は、以下のガイドをご参照ください。

• Cloud Log Analytics の紹介
• Cloud Log Analytics を用いた Serverログ収集
  • Cloud Log Analyticsを用いて Logを収集したい場合、Server内 Cloud Log Analyticsのログ収集のための Agentを追加インストールする必要があります。
• Cloud Log Analytics を使用する > Alarm ユーザーガイド