すべてのプロダクト
Search
ドキュメントセンター

:ローカルディスクを搭載した ECS ベアメタルインスタンスへのモニタリングプラグインのインストール

最終更新日:May 13, 2026

このトピックでは、ローカルディスクを搭載した ECS ベアメタルインスタンスに xdragon_hardware_detect_plugin モニタリングプラグインをインストールする方法を説明します。

前提条件

対象の ECS ベアメタルインスタンスは、次の要件を満たしている必要があります。

  • インスタンスが次のいずれかのリージョンにあること:中国 (北京)、中国 (上海)、中国 (杭州)、中国 (深圳)、または中国 (張家口)。

  • インスタンスで Linux オペレーティングシステムが実行されていること。

  • この要件は、OOS を使用してタグを照合し、モニタリングプラグインを一括インストールする場合にのみ適用されます。タグで ECS ベアメタルインスタンスを選択する場合は、対象のインスタンスにタグが付いていることを確認してください。詳細については、「タグの作成または追加」をご参照ください。

  • クラウドアシスタントエージェントがインストールされていること。詳細については、「クラウドアシスタントエージェントのインストール」をご参照ください。

    説明

    2017 年 12 月 1 日以降にパブリックイメージから作成された ECS インスタンスには、クラウドアシスタントエージェントがプリインストールされています。

背景情報

ローカルディスクを搭載した ECS ベアメタルインスタンスを使用する場合、ローカルディスクの状態を監視および診断する必要があります。

xdragon_hardware_detect_plugin プラグインは、ECS ベアメタルインスタンス上のローカルディスクの健全性を定期的にチェックします。プラグインがローカルディスクでエラーを検出すると、システムイベントが自動的に報告されます。対応するシステムイベントコードは SystemMaintenance.ReInitErrorDisk です。詳細については、ローカルディスクを備えたインスタンスのメンテナンスとシステムイベントをご参照ください。

OOS を使用した一括インストール

CloudOps Orchestration Service (OOS) のパブリックテンプレートを使用して、xdragon_hardware_detect_plugin モニタリングプラグインを自動的にインストールできます。

  1. OOS コンソールにログインします。

  2. 上部メニューで、対象リソースのリージョンとリソースグループを選択します。 地域

  3. 左側のナビゲーションペインで、自動タスク > パブリックテンプレート を選択します。ACS-ECS-InstallXDragonAndCloudMonitor を検索して X-Dragon モニタリングプラグインをインストールするためのテンプレートを見つけ、エグゼキューションの作成 をクリックします。

    批量安装神龙监控插件-创建执行

  4. エグゼキューションの作成 ダイアログボックスで、次の手順を実行します。

    1. 基本情報 ステップで、実行モード自動 に設定し、他のパラメーターはデフォルト値のままにします。次に、[次へ:パラメーターの設定] をクリックします。

    2. パラメーター設定 ステップで、次のパラメーターを設定し、他のパラメーターはデフォルト値のままにします。次に、[次へ:確認] をクリックします。

      • アクション[install] を選択してプラグインをインストールします。

        説明

        このテンプレートは、モニタリングプラグインのインストール、更新、またはアンインストールに使用できます。必要なアクションを選択してください。

      • [対象インスタンス]:モニタリングプラグインをインストールする ECS ベアメタルインスタンスを 1 つ以上選択します。

      • [レート制御]:同時実行制御 を選択します。同時実行率 で [%] を選択し、値を 100 に設定します。

      批量安装神龙监控插件-创建执行

    3. テンプレートの設定を確認し、作成 をクリックします。

    自動化タスクが作成された後、エグゼキューション ページで実行結果を確認できます。

    • O&Mタスクに対応する [実行ステータス] 列に [成功] が表示されている場合、O&Mタスクは完了しています。

    • O&Mタスクに対応する [実行ステータス] 列に [失敗] が表示されている場合、[操作] 列の [詳細] をクリックします。 [出力] セクションで [ログ] をクリックします。 その後、ログ情報に基づいて実行内容を分析し調整できます。

手動インストール

クラウドアシスタントエージェントが提供する aliyun_installer ツールを使用して、xdragon_hardware_detect_plugin モニタリングプラグインをダウンロードおよびインストールできます。

  1. root ユーザーとして ECS ベアメタルインスタンスに接続します。

  2. (任意) aliyun_installer -h コマンドを実行して、ツールのヘルプ情報を表示します。

  3. aliyun_installer コマンドを実行して、xdragon_hardware_detect_plugin モニタリングプラグインをインストールします。

    aliyun_installer -i xdragon_hardware_detect_plugin -e 1.0.0
  4. シェルスクリプトを保存して実行し、特定のバージョンの CloudMonitor エージェントをインストールします。スクリプトの内容については、以下の「サンプルスクリプト」をご参照ください。

    bash <nameOfTheScript>.sh
    説明

    CloudMonitor エージェントをインストールする前に、xdragon_hardware_detect_plugin モニタリングプラグインをインストールする必要があります。すでに CloudMonitor エージェントをインストールしている場合は、/usr/local/cloudmonitor/CmsGoAgent.linux-amd64 restart コマンドを実行して再起動してください。

  5. smartctl -V コマンドを実行して、smartctl ローカルディスク分析ツールがインストールされているかどうかを確認します。

    コマンドの出力にバージョン番号が含まれている場合、ツールはインストールされています。

  6. (任意) smartctl ツールがインストールされていない場合は、お使いのオペレーティングシステムに応じてインストールします。

    • CentOS:

      yum install smartmontools
    • Ubuntu:

      apt update &&  apt install smartmontools
    • その他の Linux ディストリビューションについては、smartmontools のドキュメントをご参照ください。

次のサンプルスクリプトは、特定のバージョンの CloudMonitor エージェントを手動でインストールします。

#!/bin/bash
echo "CMS エージェントをインストールしています"

if [ -z "${CMS_HOME}" ]; then
  CMS_HOME="/usr/local/cloudmonitor"
  [[ ! -z "`egrep -i coreos /etc/os-release`" ]] && CMS_HOME="/opt/cloudmonitor"
fi

if [ `uname -m` = "x86_64" ]; then
    ARCH="amd64"
else
    ARCH="386"
fi

VERSION="2.1.57"
ELF_NAME=CmsGoAgent.linux-${ARCH}
DOWNLOAD_PATH="cms-go-agent/${VERSION}/${ELF_NAME}"
DEST_UPDATE_FILE="$CMS_HOME/${ELF_NAME}"

current_cms_version="0"
# X-Dragon アーキテクチャは常に x86 であるため、バージョンのみをチェックします。
if [ -f /usr/local/cloudmonitor/CmsGoAgent.linux-amd64 ]; then
    current_cms_version="$($DEST_UPDATE_FILE version)"
fi

if [ $current_cms_version = "2.1.57" ]; then
    echo "CmsGoAgent はすでにインストールされています"
    echo "インストールに成功しました。"
    exit 0
fi

if [ -z "${REGION_ID}" ]; then
  REGION_ID="$(wget -q --timeout=1 -t 1 -O - 'http://100.100.100.200/latest/meta-data/region-id')"
fi


if [ -d $CMS_HOME ] ; then
  if [ -f $CMS_HOME/wrapper/bin/cloudmonitor.sh ] ; then
    $CMS_HOME/wrapper/bin/cloudmonitor.sh remove;
    rm -rf $CMS_HOME;
  elif [ -f $DEST_UPDATE_FILE ]; then
    $DEST_UPDATE_FILE stop
    #$DEST_UPDATE_FILE uninstall
    ps aux | grep -v grep | grep $ELF_NAME
  fi
fi

download()
{
  if [ -z "${REGION_ID}" ]; then
    echo "ネットワークタイプは classic です。"
    OSS_URL="http://cms-agent-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/$DOWNLOAD_PATH"
  else
    echo "ネットワークタイプは VPC、REGION_ID: $REGION_ID"
    if [[ "$REGION_ID" = "cn-shenzhen-finance-1" ]]; then
      OSS_URL="http://cms-download.aliyun.com/$DOWNLOAD_PATH"
      CMS_PROXY="szcmsproxy.aliyun.com:3128"
    elif [[ "$REGION_ID" = "cn-shanghai-finance-1" ]]; then
      OSS_URL="http://cms-agent-$REGION_ID.oss-$REGION_ID-pub-internal.aliyuncs.com/$DOWNLOAD_PATH"
    elif [[ "$REGION_ID" = "ap-south-1" ]]; then
      OSS_URL="http://cms-download.aliyun.com/$DOWNLOAD_PATH"
      CMS_PROXY="cmsproxy-ap-south-1.aliyuncs.com:8080"
    elif [ "$REGION_ID" = "ap-southeast-3" -o "$REGION_ID" = "me-east-1" -o "$REGION_ID" = "cn-chengdu" ]; then
      OSS_URL="http://cms-download.aliyun.com/$DOWNLOAD_PATH"
    else
      OSS_URL="http://cms-agent-$REGION_ID.oss-$REGION_ID-internal.aliyuncs.com/$DOWNLOAD_PATH"
    fi
  fi
  echo "$OSS_URL からダウンロードしています"
  wget -q -e "http_proxy=$CMS_PROXY" "$OSS_URL" -O "$DEST_UPDATE_FILE" -t 3 --connect-timeout=2
  if [ $? != 0 ]; then
    echo "ダウンロードに失敗しました。再試行しています..."
    CMS_PROXY="vpc-opencmsproxy.aliyun.com:8080";
    OSS_URL="http://cms-download.aliyun.com/$DOWNLOAD_PATH"
    wget -q -e "http_proxy=$CMS_PROXY" "$OSS_URL" -O "$DEST_UPDATE_FILE" -t 3 --connect-timeout=2
  fi
  if [ $? != 0 ]; then
    echo "ダウンロードに失敗しました。再試行しています..."
    CMS_PROXY="opencmsproxy.aliyun.com:8080";
    OSS_URL="http://cms-download.aliyun.com/$DOWNLOAD_PATH"
    wget -q -e "http_proxy=$CMS_PROXY" "$OSS_URL" -O "$DEST_UPDATE_FILE" -t 3 --connect-timeout=2
  fi
}

mkdir -p $CMS_HOME && \
chown -R root:root $CMS_HOME && \
download && \
chmod a+x $DEST_UPDATE_FILE
$DEST_UPDATE_FILE check
RC=$?
if [ ${RC} -ne 0 ]; then
    echo "CmsGoAgent のインストールに失敗しました。お使いのプラットフォームはサポートされていません"
    exit ${RC}
fi

$DEST_UPDATE_FILE install >/dev/null 2>&1 || true
$DEST_UPDATE_FILE start
ps aux | grep -v grep | grep $ELF_NAME

ACT_VERSION=`$DEST_UPDATE_FILE version`
if [ -n "$ACT_VERSION" ]; then
    echo "CmsGoAgent v$ACT_VERSION がインストールされました"
else
    echo "CmsGoAgent のインストールに失敗しました"
    exit 1
fi

結果

インストール後、xdragon_hardware_detect_plugin モニタリングプラグインは /usr/local/xdragon_hwqc ディレクトリに配置されます。プラグインを更新するには、aliyun_installer -i xdragon_hardware_detect_plugin を実行します。アンインストールするには、aliyun_installer -u xdragon_hardware_detect_plugin を実行します。

次のステップ

ECS API を呼び出して、障害のあるローカルディスクを分離できます。ディスクが分離された後も、ECS ベアメタルインスタンスは同じ物理サーバー上で実行され続けます。詳細については、「ローカルディスクを搭載したインスタンスのメンテナンスとシステムイベント」をご参照ください。