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

Cloud Monitor:Cloud Monitor エージェントのインストールとアンインストール

最終更新日:Aug 19, 2026

Cloud Monitor エージェントは、ホストのオペレーティングシステムから監視メトリクスを収集し、分析用に Cloud Monitor へデータを送信します。可視化されたチャートでホストのステータスを表示したり、主要なメトリクスのアラート ルールを作成したりすることで、問題を迅速に特定して解決できます。本トピックでは、Cloud Monitor エージェントのインストール、管理、アンインストールの方法について説明します。

重要

CloudMonitor エージェントは、管理者アカウントを使用してのみ管理できます。 Linux オペレーティングシステムの場合は、ルートユーザーアカウントを使用します。 Windows オペレーティングシステムの場合は、管理者アカウントを使用します。 管理者アカウントを使用すると、特定のリスクが発生する可能性があります。 たとえば、システムの安定性やデータセキュリティの問題が発生する可能性があります。 注意して進めてください。

事前準備

エージェントバージョン

推奨バージョンは C++ 3.X です。

エージェントの Java 版および Go 版のメンテナンスは終了しました。C++ 版は、Go 版および Java 版と比べてリソース消費量が大幅に少なくなります。そのため、C++ 版エージェントのインストールを推奨します。

次の表では、旧バージョンと現行バージョンのエージェントの制御スクリプトパスを比較します。

バージョン

制御スクリプトパス

備考

レガシー (Java/Go)

/usr/local/cloudmonitor/wrapper/bin/cloudmonitor.sh

非推奨。 wrapper ディレクトリはレガシーバージョンにのみ存在します

現行バージョン (C++)

/usr/local/cloudmonitor/cloudmonitorCtl.sh

推奨します。 wrapper ディレクトリは存在しません

説明

C++ 版には /usr/local/cloudmonitor/wrapper/ ディレクトリが存在しません。レガシーコマンドを実行して "no such file or directory" エラーが返される場合は、ホストに C++ 版がインストールされています。以降のすべての操作では、代わりに cloudmonitorCtl.sh を使用してください。

  • Cloud Monitor エージェントのインストール、ホスト監視チャートの表示、アラートルールの作成は無料です。

  • システム要件

    オペレーティングシステム

    ハードウェアアーキテクチャ

    Windows 7、Windows Server 2008 R2 以降

    i386、AMD64

    Linux 2.6.23 以降 (Glibc ライブラリが必要です)

    i386、AMD64、ARM64

    Cloud Monitor エージェントは、カーネルバージョンが 2.6.23 以降で、Glibc ライブラリが含まれているすべての Linux ディストリビューションと互換性があります。互換性のある一般的なディストリビューションには、CentOS、Ubuntu、Debian、Alibaba Cloud Linux、Anolis OS、Rocky Linux、AlmaLinux、Kylin OS などがあります。

    CPU 使用率やネットワークトラフィックなどの基本的な監視メトリクスは、ホストから直接収集され、エージェントを必要としないため、Linux ディストリビューションの影響を受けません。一方、メモリ使用量やディスク使用量などの OS レベルのメトリクスを収集するには、Cloud Monitor エージェントをインストールする必要があります。

    C++ エージェントのインストールパス、リソース消費量、およびログについては、「Cloud Monitor エージェントの概要」をご参照ください。

ホストのネットワーク要件

  • ホストは、インターネットに直接、または NAT Gateway やプロキシサーバー経由でアクセスできる必要があります。

  • ファイアウォールの許可リスト設定

    ホストにファイアウォールまたは ECS セキュリティグループが設定されている場合は、Cloud Monitor のサーバーアドレスとポートを許可リストに追加する必要があります。

    説明

    サードパーティホストは、インターネット経由でポート 443 を使用してデータの報告とハートビートチェックを実行します。

    サーバーアドレス

    確認方法

    サーバーポート

    説明

    ハートビートサービス

    nslookup cms-cloudmonitor.aliyun.com または ping cms-cloudmonitor.aliyun.com

    8080、3128、443

    エージェントのハートビートチェックに使用します。

    データ報告

    VPCnslookup metrichub-<regionid>.aliyun.com

    Internetnslookup metrichub-cms-<regionid>.aliyuncs.com

    80、443

    監視データの報告に使用します。

    • <regionid> は Alibaba Cloud ホストのリージョン ID です。次のコマンドを実行してリージョン ID を取得できます: curl http://100.100.100.200/latest/meta-data/region-id

    • インターネット経由のデータ報告は、China (Hangzhou)、China (Shanghai)、China (Beijing)、China (Shenzhen) リージョンでのみ利用できます。

    メタデータサービス

    固定 CIDR ブロック: 100.100.0.0/16

    0-65535

    インスタンス情報を取得します (Alibaba Cloud ホストのみ)。

DNS 名前解決失敗の修正

このセクションは Linux ホストにのみ適用されます。

nslookup cms-cloudmonitor.aliyun.com の結果が Name or service not known または no servers could be reached の場合、ホストで Cloud Monitor のハートビートサービスドメインを名前解決できず、Cloud Monitor エージェントがオフラインになります。次の手順に従って問題を修正してください。

  1. /etc/resolv.conf を編集し、次の Alibaba Cloud 内部 DNS サーバーを追加します:

    nameserver 100.100.2.136
    nameserver 100.100.2.138
  2. Cloud Monitor エージェントを再起動します:

    cd /usr/local/cloudmonitor && ./cloudmonitorCtl.sh restart
  3. エージェントプロセスが実行されていることを確認します:

    ps aux | grep argusagent

    通常は 2 つのプロセス (デーモンとメインプロセス) が表示されます。

  4. DNS 名前解決を再度テストします:

    nslookup cms-cloudmonitor.aliyun.com

    IP アドレスが返される場合、DNS 名前解決が復旧しています。

インストール方法の比較

ホストの種類とネットワーク環境に応じて、エージェントを自動または手動でインストールしてください。

インストール方法

ユースケース

メリット

コンソールからの自動インストール

Alibaba Cloud Elastic Compute Service (ECS) インスタンスと、Cloud Assistant で管理されているサードパーティホスト。

推奨します。手順が簡単で、バッチ操作に対応し、ホストにログオンする必要がありません。

手動インストール

自動インストールを利用できないシナリオ、管理されていないサードパーティホスト、社内環境またはオフライン環境、Ansible などの自動化スクリプトを使用したデプロイ。

柔軟性が高く、あらゆる複雑な環境に適しています。

インストール時の注意事項

  • Cloud Monitor エージェントのインストールによって業務に影響はなく、ECS インスタンスの再起動も不要です。インストール後、エージェントは自動的に起動し、監視データの収集を開始します。影響が気になる場合は、オフピーク時間帯にエージェントをインストールしてください。

  • 自動インストールでは、root アカウントのログイン状態 (例: noLogin) は変更されません。ホストで root の直接ログインが無効になっている場合でも、Cloud Assistant Agent (aliyun-service) が root 権限でインストールを実行できます。

  • Cloud Monitor エージェント (argusagent) と Simple Log Service の収集エージェント (loongcollector) は独立したコンポーネントで、相互に依存しません。一方をインストール、アンインストール、または再起動しても、もう一方には影響しません。

  • Simple Application Server などの ECS 以外のホストでは、コンソールでメモリやディスク使用量などの OS レベルのメトリクスを表示するには、Cloud Monitor エージェントをインストールする必要があります。CPU 使用率やネットワークトラフィックなどの基本的な監視メトリクスはホストから収集されるため、エージェントは不要です。

自動インストール (推奨)

この方法は、Alibaba Cloud ホストおよびAlibaba Cloud マネージドインスタンスに適用されます。

  1. ホストモニタリングページに移動します。

  2. ECS モニタリング ページで、エージェントをインストールまたはアップグレードするホストを選択し、左下隅にある [エージェントの一括インストール/アップグレード] をクリックします。 表示されたダイアログボックスで、確認 をクリックします。

    説明
    • 新規購入した Alibaba Cloud ホストの場合、右上隅にあるECS を新規購入すると、自動的にクラウドモニタリングがインストールされます スイッチをオンにすると、新しい ECS ホストに CloudMonitor エージェントが自動的にインストールされます。そうでない場合は、エージェントを手動でインストールする必要があります。

    • インストールまたはアップグレードには約 5 分かかります。ターゲットホストの Agent Statusインストール中 から 実行中 に変わると、操作は完了です。

手動インストール

説明

自動インストールに失敗した場合、または特殊な環境にインストールする場合は、エージェントを手動でインストールします。ホストにエージェントの古いバージョン、または破損したバージョンがすでに存在する場合は、先にアンインストールする必要があります。

説明

シンプルアプリケーションサーバーインスタンスは、ホスト監視リストに表示されません。ECS モニタリング ページのホストタイプフィルターで選択できるのは ECS インスタンスとサードパーティホストのみです。このため、シンプルアプリケーションサーバーインスタンスのインストールコマンドを 手動インストール ダイアログボックスから取得することはできません。代わりに、SSH 経由でインスタンスに接続し、エージェントを手動でインストールしてください。

root ユーザーとして SSH で Simple Application Server インスタンスにログオンし、次のコマンドを実行して Cloud Monitor エージェントをインストールします。

ARGUS_VERSION=4.0.0 /bin/bash -c "$(curl -s https://cms-agent-cn-shenzhen.oss-cn-shenzhen-internal.aliyuncs.com/Argus/agent_install-2.0.3.sh)"

コマンド内の cn-shenzhen を、インスタンスのリージョン ID に置き換えます。ARGUS_VERSION は、インストールするエージェントのバージョンを指定します。コマンドが完了したら、次のコマンドを実行してエージェントプロセスが実行中であることを確認します。

ps aux | grep argusagent | grep -v grep

Simple Application Server インスタンスのモニタリングデータは、ECS モニタリング ページには表示されません。エージェントをインストールした後、Cloud Monitor コンソールにログインし、[クラウドサービスモニタリング] > [コンピューティング] > [Simple Application Server] を選択してモニタリングデータを表示します。対応する名前空間は acs_swas です。

  1. ホストモニタリング ページに移動します。

  2. ECS モニタリング ページで、ホストリストの上にある[ホスト & エージェント操作]をクリックし、ドロップダウンメニューから[手動インストール]をクリックします。

  3. 手動インストール ダイアログボックスで、以下の手順に従ってインストールを完了します。

Alibaba Cloud ホスト

Linux

  1. Region フィールドで、Alibaba Cloud ホストが存在するリージョンを選択します。

  2. Install shell エリアで、コマンドの横にある image.png アイコンをクリックしてコマンドをコピーします。オペレーティングシステムとして Linux または Windows を選択すると、インストールコマンド エリアで対応するインストールコマンドを取得できます。

  3. root ユーザーとしてホストにログオンします。

  4. インストールコマンドを貼り付けて実行します。

  5. 次のコマンドを実行して、エージェントのステータスを確認します。

    ps aux | grep argusagent | grep -v grep

    出力が次の例のようであれば、エージェントは正常に実行されています。

    root      2284  0.0  0.0  22516  1488 ?        Ss   Sep14   0:00 /usr/local/cloudmonitor/bin/argusagent -d
    root      2286  0.2  0.3 939652 14300 ?        Sl   Sep14   3:15 /usr/local/cloudmonitor/bin/argusagent

Windows

  1. Region フィールドで、Alibaba Cloud ホストが配置されているリージョンを選択します。

  2. ホストのオペレーティングシステムに応じて、32 ビットまたは 64 ビットのエージェントパッケージをダウンロードします。

  3. Administrator ユーザーとしてホストにログオンします。

  4. ディレクトリ C:\Program Files\Alibaba\cloudmonitor を作成します。プラグインパッケージをホストにアップロードし、ディレクトリ C:\Program Files\Alibaba\cloudmonitor に展開します。

  5. [コマンドプロンプト] を開くには、Win+R を押して 実行 ダイアログボックスを開き、cmd と入力して 確認 をクリックします。

  6. 次のコマンドを実行して Cloud Monitor エージェントをインストールします。

    1. cd C:\Program Files\Alibaba\cloudmonitor\bin

    2. argusagent_service.exe install

  7. net start argusagent コマンドを実行して、Cloud Monitor エージェントを起動します。

  8. エージェントのステータスを確認します。

    1. サービス ウィンドウを開くには、Win+R を押して 実行 ダイアログボックスを開き、services.msc と入力し、確認 をクリックします。

    2. [argusagent service] のステータスを確認します。ステータスが 実行中 の場合、エージェントは正常に実行されています。

サードパーティーホスト

Linux

  1. Region フィールドで、監視データを受信するリージョンを選択します。

  2. [手動インストール] ダイアログボックスで、必要なパラメーターを設定してインストールコマンドを生成します。Install shell エリアで、コピーアイコン image.png をクリックしてコマンドをコピーします。

  3. root ユーザーとしてホストにログオンします。

  4. インストールコマンドを貼り付けて実行します。

  5. 次のコマンドを実行して、エージェントのステータスを確認します。

    ps aux | grep argusagent | grep -v grep

    出力が次の例のようであれば、エージェントは正常に実行されています。

    root      2284  0.0  0.0  22516  1488 ?        Ss   Sep14   0:00 /usr/local/cloudmonitor/bin/argusagent -d
    root      2286  0.2  0.3 939652 14300 ?        Sl   Sep14   3:15 /usr/local/cloudmonitor/bin/argusagent

Windows

  1. Region フィールドで、モニタリングデータを受信するリージョンを選択します。

  2. ホストのオペレーティングシステムに応じたエージェントパッケージ (32 ビットまたは 64 ビット) と、accesskey.properties 設定ファイルをダウンロードします。

  3. Administrator ユーザーとしてホストにログオンします。

  4. ディレクトリ C:\Program Files\Alibaba\cloudmonitor を作成します。プラグインパッケージをホストにアップロードし、ディレクトリ C:\Program Files\Alibaba\cloudmonitor に展開します。

  5. 設定ファイルをホストにアップロードし、ディレクトリ C:\Program Files\Alibaba\cloudmonitor\local_data\conf に配置します。

  6. 次のコマンドを実行して Cloud Monitor エージェントをインストールします。

    1. cd C:\Program Files\Alibaba\cloudmonitor\bin

    2. argusagent_service.exe install

  7. net start argusagent コマンドを実行して、Cloud Monitor エージェントを起動します。

  8. エージェントのステータスを確認します。

    1. サービス ウィンドウを開くには、Win+R を押して実行 ダイアログボックスを開き、services.msc と入力し、次に 確認 をクリックします。

    2. [argusagent service] のステータスを確認します。ステータスが 実行中 の場合、エージェントは正常に実行されています。

一般的な問題

Cloud Monitor エージェントがインストールされたサードパーティーホストがインターネットにアクセスできない場合、エージェントはモニタリングデータを報告できません。この問題を解決するには、対応するオペレーティングシステムの agent.properties 設定ファイルを変更して、プロキシサーバーを設定してください。

  • Linux のパス:/usr/local/cloudmonitor/local_data/conf/agent.properties

  • Windows のパス:C:\Program Files\Alibaba\cloudmonitor\local_data\conf\agent.properties

詳細な手順については、「How do I use an Nginx proxy server to report monitoring data from a third-party host?」をご参照ください。

トラブルシューティング

Cloud Monitor エージェントのインストールまたは開始に失敗した場合は、次の対処法をご参照ください。

シナリオ 1:コンソールで [インストール] または [開始] を複数回クリックしても反応がない

ホストにログインし、次のコマンドを実行して Cloud Assistant (aliyun-service) を開始します。その後、コンソールで操作を再試行します。

systemctl start aliyun-service

シナリオ 2:Simple Application Server でインストールが失敗する

次のチェックを順番に実行します:

  1. メタデータサービスの接続を確認します。次のコマンドを実行します:

    curl http://100.100.100.200/latest/meta-data/region-id

    リージョン ID が返される場合、接続は正常です。

  2. エージェントダウンロード URL の接続を確認します。<region> を実際のリージョン ID に置き換え、次を実行します:

    ping cms-agent-<region>.oss-<region>.aliyuncs.com
  3. エージェントプロセスが実行中かどうかを確認します:

    ps -ef | grep cms
  4. すべてのチェックに問題がないにもかかわらずインストールが失敗する場合は、手動インストール方法を使用します。詳細な手順については、このトピックの 手動インストール をご参照ください。

シナリオ 3:エージェントのステータスが「再インストール/アップグレード中」と表示される、または操作が失敗する

Cloud Assistant エージェント (aliyun-service) が実行中かどうかを確認します。実行されていない場合は、再起動または修復してから Cloud Monitor エージェントのインストールを再試行します。問題が解決しない場合は、Cloud Monitor エージェントを手動で再インストールします。

シナリオ 4:エージェント接続の失敗 (一般)

  1. Cloud Monitor エージェントをアンインストールしてから再インストールします。

  2. 問題が解決しない場合は、特定のバージョン (例:バージョン 1.0.6) をインストールし、問題がバージョンに起因するかどうかを確認します。

レガシーエージェントからの移行

ホストでレガシーの Java または Go エージェントが実行されている場合 (/usr/local/cloudmonitor/wrapper/ ディレクトリの存在により識別できます) 、次の手順に従って、リソース使用量が少なく、継続的な機能の更新が行われる C++ バージョンに移行してください。

手順 (Linux)

  1. レガシーエージェントを停止します。

    bash /usr/local/cloudmonitor/wrapper/bin/cloudmonitor.sh stop
  2. レガシーエージェントをアンインストールします。

    bash /usr/local/cloudmonitor/wrapper/bin/cloudmonitor.sh remove
    rm -rf /usr/local/cloudmonitor
  3. このドキュメントの 手動インストール セクションに従って、C++ バージョンをインストールします。

  4. C++ エージェントを開始します。

    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh start
  5. エージェントが実行されていることを確認します。

    ps aux | grep argusagent | grep -v grep

一般的な操作

エージェントの開始

  • Linux

    次のコマンドを実行して Cloud Monitor エージェントを開始します:

    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh start
  • Windows

    次のコマンドを実行して Cloud Monitor エージェントを開始します:

    net start argusagent

エージェントのステータスの確認

  • Linux

    次のコマンドを実行してエージェントのステータスを確認します:

    ps aux | grep argusagent | grep -v grep

    出力が次のようであれば、エージェントは正常に実行されています。

    root      2284  0.0  0.0  22516  1488 ?        Ss   Sep14   0:00 /usr/local/cloudmonitor/bin/argusagent -d
    root      2286  0.2  0.3 939652 14300 ?        Sl   Sep14   3:15 /usr/local/cloudmonitor/bin/argusagent
  • Windows

    1. サービス ウィンドウを開くには、Win+R を押して [実行] ダイアログボックスを開き、services.msc と入力して 確認 をクリックします。

    2. argusagent サービスのステータスを確認します。

      ステータスが 実行中 の場合、エージェントは正常に実行されています。

エージェントの停止

  • Linux

    次のコマンドを実行して Cloud Monitor エージェントを停止します:

    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh stop
  • Windows

    次のコマンドを実行して Cloud Monitor エージェントを停止します:

    net stop argusagent

エージェントのアンインストール

Cloud Monitor エージェントの C++ バージョンをアンインストールすると、ホストをリアルタイムで監視できなくなりますが、過去のモニタリングデータは引き続き利用可能です。

  • Linux

    # 1. Cloud Monitor エージェントを停止します。
    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh stop
    # 2. Cloud Monitor エージェントをアンインストールします。
    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh uninstall
    # 3. cloudmonitor ディレクトリを削除します。
    rm -rf /usr/local/cloudmonitor

    cloudmonitorCtl.sh スクリプトが存在しない場合は、次の手順を実行してエージェントをアンインストールしてください。

    1. エージェントディレクトリを見つけます: find / -name cloudmonitor -type d

    2. サービスの停止: systemctl stop cloudmonitor

    3. サービスの無効化: systemctl disable cloudmonitor

    4. 残留プロセスを強制終了します: kill -9 $(pgrep argusagent)

      説明

      argusagent サービスは KillMode=none で設定されているため、systemctl stop はプロセスを終了しません。実行中のプロセスは /usr/local/cloudmonitor ディレクトリを再作成します。したがって、ディレクトリを削除する前にプロセスを終了する必要があります。

    5. エージェントディレクトリを削除します: rm -rf /usr/local/cloudmonitor

    6. サービスファイルを削除します: rm -f /etc/systemd/system/cloudmonitor.service

    7. systemd の再読み込み: systemctl daemon-reload

    8. 設定ディレクトリを削除します: rm -rf /etc/cloudmonitor

    アンインストール後、次のコマンドを実行して、エージェントが完全に削除されているかを確認します:

    • systemctl status cloudmonitornot-found を返します。

    • ls /usr/local/cloudmonitor を実行すると、No such file or directory と表示されます。

    • ps aux | grep argusagent はプロセスを返しません。

    • find / -name cloudmonitor -type d は結果を返しません。

  • Windows

    # 1. Cloud Monitor エージェントを停止します。
    net stop argusagent
    # 2. Cloud Monitor エージェントをアンインストールします。
    "C:\Program Files\Alibaba\cloudmonitor\bin\argusagent_service.exe" uninstall
    # 3. cloudmonitor ディレクトリを削除します。
    cd "C:\Program Files\Alibaba"
    rd /s /q cloudmonitor
    説明

    インストールパスにスペースが含まれている場合 (例: C:\Program Files\Alibaba\cloudmonitor)、ステップ 2 に示すように、アンインストールコマンドで実行ファイルのフルパスを二重引用符で囲む必要があります。二重引用符で囲まないと、Windows は実行可能ファイルを見つけられず、'...' is not recognized as an internal or external command というエラーが返されます。

    権限エラーやコマンド実行の失敗が発生した場合は、現在の Windows ユーザーに管理者権限があること、およびファイルパスが正しいことを確認してください。

よくある質問

Q: Cloud Monitor エージェントをインストールした後、一部の監視メトリクス (メモリ使用率やディスク使用率など) が表示されないのはなぜですか?

A:

  1. データ収集から報告までには、わずかな遅延があります。数分待ってからコンソールを更新してください。

  2. エージェントのステータスが [実行中] であることを確認してください。ステータスが [停止] の場合は、コンソールの ホストモニタリング ページに移動してエージェントを開始するか、ホストにログインして以下を実行してください:

    systemctl start aliyun-service
  3. 基本モニタリングと OS 監視の違いにご注意ください:基本モニタリングのメトリクス (CPU 使用率やネットワークトラフィックなど) はホストから収集され、エージェントを必要としません。メモリ使用率やディスク使用率などの OS レベルのメトリクスには、Cloud Monitor エージェントが必要です。エージェントがインストールされていないか、正しく機能していない場合、これらのメトリクスは利用できません。

  4. アラートが期待どおりにトリガーされない場合 (たとえば、ディスク使用率が 100% に達してもアラートが発生しない場合)、エージェントがインストールされており、実行中であることを確認してください。アラートルールが有効になるには、モニタリングデータが正常に報告される必要があります。

Q: Cloud Monitor エージェントをアンインストールした後も、実行中のプロセスが表示されます。なぜですか?

A:

Cloud Monitor エージェント (argusagent) をアンインストールした後も aliyun_assist (または aliyun-service) という名前のプロセスが実行中の場合、そのプロセスは Cloud Monitor エージェントとは独立した製品である Cloud Assistant エージェント (aliyun-service) に属します。 Cloud Monitor エージェントをアンインストールしても、Cloud Assistant エージェントは自動的にアンインストールされません。 Cloud Assistant エージェントが不要になった場合は、「エージェントの停止とアンインストール」を参照して、別途アンインストールしてください。

関連ドキュメント

よくある質問

API