Todos os produtos
Search
Central de documentação

:Instalar um plug-in de monitoramento em uma instância bare metal do ECS com disco local

Última atualização: Jul 03, 2026

Este tópico descreve como instalar o plug-in de monitoramento xdragon_hardware_detect_plugin em uma instância bare metal do ECS com disco local.

Pré-requisitos

A instância bare metal do ECS de destino deve atender aos seguintes requisitos:

  • A instância está em uma das seguintes regiões: China (Beijing), China (Shanghai), China (Hangzhou), China (Shenzhen) ou China (Zhangjiakou).

  • A instância executa um sistema operacional Linux.

  • Este requisito se aplica apenas se você usar o OOS para instalar o plug-in de monitoramento em lote por correspondência de tags. Para selecionar instâncias bare metal do ECS por tag, verifique se as instâncias de destino possuem tags. Para mais informações, consulte Criar ou adicionar uma tag.

  • O Cloud Assistant Agent está instalado. Para mais informações, consulte Instalar o Cloud Assistant Agent.

    Nota

    O Cloud Assistant Agent vem pré-instalado em instâncias do ECS criadas a partir de uma imagem pública após 1º de dezembro de 2017.

Informações gerais

Ao usar uma instância bare metal do ECS com disco local, monitore e diagnostique a integridade desse disco.

O plug-in xdragon_hardware_detect_plugin verifica periodicamente a integridade dos discos locais na instância bare metal do ECS. Se o plug-in detectar um erro em um disco local, ele relatará automaticamente um evento de sistema. O código do evento de sistema correspondente é SystemMaintenance.ReInitErrorDisk. Para mais informações, consulte Manutenção e eventos de sistema para instâncias com discos locais.

Instalação em lote via OOS

Use um modelo público no CloudOps Orchestration Service (OOS) para instalar automaticamente o plug-in de monitoramento xdragon_hardware_detect_plugin.

  1. Faça login no console do OOS.

  2. No canto superior esquerdo da página, selecione uma região e um grupo de recursos.地域

  3. No painel de navegação à esquerda, escolha Automated Task > Public Template. Pesquise ACS-ECS-InstallXDragonAndCloudMonitor para localizar o modelo de instalação do plug-in de monitoramento X-Dragon e clique em Create an execution..

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

  4. Na caixa de diálogo Create an execution., conclua as etapas a seguir:

    1. Na etapa Basic Information, defina o execution mode como Automatic e mantenha os demais parâmetros com os valores padrão. Em seguida, clique em Next: Set Parameters.

    2. Na etapa Parameter Settings, configure os parâmetros abaixo e mantenha os restantes com os valores padrão. Depois, clique em Next: Confirm.

      • Action: Selecione install para instalar o plug-in.

        Nota

        Este modelo permite instalar, atualizar ou desinstalar o plug-in de monitoramento. Escolha a ação desejada.

      • Target Instances: Selecione uma ou mais instâncias bare metal do ECS nas quais deseja instalar o plug-in de monitoramento.

      • Rate Control: Escolha Concurrency-based Control. Em Concurrency, selecione % e defina o valor como 100.

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

    3. Confirme as configurações do modelo e clique em Create.

    Após criar a tarefa automatizada, visualize os resultados da execução na página Executions.

    • Se Success aparecer na coluna Execution Status da tarefa de O&M, a tarefa foi concluída com êxito.

    • Caso Failed seja exibido na coluna Execution Status da tarefa de O&M, clique em Details na coluna Actions. Na seção Output, clique em Log para analisar e ajustar o conteúdo da execução com base nas informações de log.

Instalação manual

Use a ferramenta aliyun_installer, fornecida pelo Cloud Assistant Agent, para baixar e instalar o plug-in de monitoramento xdragon_hardware_detect_plugin.

  1. Conecte-se à instância bare metal do ECS como usuário root.

  2. (Opcional) Execute o comando aliyun_installer -h para visualizar as informações de ajuda da ferramenta.

  3. Execute o comando aliyun_installer para instalar o plug-in de monitoramento xdragon_hardware_detect_plugin.

    aliyun_installer -i xdragon_hardware_detect_plugin -e 1.0.0
  4. Salve e execute o script shell para instalar uma versão específica do agente do CloudMonitor. Consulte o conteúdo do script em Script de exemplo abaixo.

    bash <nameOfTheScript>.sh
    Nota

    Instale o plug-in de monitoramento xdragon_hardware_detect_plugin antes de instalar o agente do CloudMonitor. Se o agente do CloudMonitor já estiver instalado, execute o comando /usr/local/cloudmonitor/CmsGoAgent.linux-amd64 restart para reiniciá-lo.

  5. Execute o comando smartctl -V para verificar se a ferramenta de análise de disco local smartctl está instalada.

    Se a saída do comando incluir o número da versão, a ferramenta estará instalada.

  6. (Opcional) Caso a ferramenta smartctl não esteja instalada, instale-a conforme o sistema operacional:

    • CentOS:

      yum install smartmontools
    • Ubuntu:

      apt update &&  apt install smartmontools
    • Para outras distribuições Linux, consulte a documentação do smartmontools.

O script de exemplo a seguir instala manualmente uma versão específica do agente do CloudMonitor:

#!/bin/bash
echo "installing cms agent"

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"
# The X-Dragon architecture is always x86, so just check the version.
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 already installed"
    echo "Installation success."
    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 "Network type is classic."
    OSS_URL="http://cms-agent-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/$DOWNLOAD_PATH"
  else
    echo "networkType is 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 download from "$OSS_URL"
  wget -q -e "http_proxy=$CMS_PROXY" "$OSS_URL" -O "$DEST_UPDATE_FILE" -t 3 --connect-timeout=2
  if [ $? != 0 ]; then
    echo "Download failed. Retrying..."
    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 "Download failed. Retrying..."
    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 install failed, your platform is not supported
    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 installed
else
    echo CmsGoAgent install failed
    exit 1
fi

Resultados

Após a instalação, o plug-in de monitoramento xdragon_hardware_detect_plugin ficará localizado no diretório /usr/local/xdragon_hwqc. Para atualizar o plug-in, execute aliyun_installer -d xdragon_hardware_detect_plugin. Para desinstalá-lo, execute aliyun_installer -u xdragon_hardware_detect_plugin.

Próximas etapas

Chame uma operação da API do ECS para isolar um disco local com falha. Após o isolamento do disco, a instância bare metal do ECS continuará em execução no mesmo servidor físico. Para mais informações, consulte Manutenção e eventos de sistema para instâncias com discos locais.