All Products
Search
Document Center

Cloud Monitor:Instal dan uninstal Agen Cloud Monitor

Last Updated:Aug 19, 2026

Agen Cloud Monitor mengumpulkan metrik pemantauan dari sistem operasi host dan mengirimkan datanya ke Cloud Monitor untuk dianalisis. Anda dapat melihat status host dalam bentuk grafik visual serta membuat aturan alert untuk metrik penting guna mengidentifikasi dan menyelesaikan masalah secara cepat. Topik ini menjelaskan cara menginstal, mengelola, dan menguninstal Agen Cloud Monitor.

Penting

Anda hanya dapat mengelola Agen Cloud Monitor menggunakan akun administrator (pengguna root untuk Linux atau pengguna Administrator untuk Windows). Namun, penggunaan akun administrator dapat menimbulkan risiko tertentu, seperti masalah stabilitas sistem atau keamanan data. Lakukan dengan hati-hati.

Sebelum memulai

Versi agen

C++ 3.X adalah versi yang direkomendasikan.

Versi Java dan Go dari agen tidak lagi dipelihara. Versi C++ menggunakan sumber daya jauh lebih sedikit dibandingkan versi Go dan Java. Oleh karena itu, kami merekomendasikan untuk menginstal versi C++ dari agen.

Tabel berikut membandingkan jalur skrip kontrol untuk versi Agen lama dan saat ini:

Versi

Jalur Skrip Kontrol

Catatan

Lama (Java/Go)

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

Usang; direktori wrapper hanya ada di versi lama

Saat ini (C++)

/usr/local/cloudmonitor/cloudmonitorCtl.sh

Direkomendasikan; tidak ada direktori wrapper

Catatan

Direktori /usr/local/cloudmonitor/wrapper/ tidak ada pada versi C++. Jika menjalankan perintah lama menghasilkan error "no such file or directory", berarti host Anda telah menginstal versi C++ — gunakan cloudmonitorCtl.sh untuk semua operasi.

  • Penagihan: Menginstal Agen Cloud Monitor, melihat grafik pemantauan host, dan membuat aturan alert tidak dikenai biaya.

  • Persyaratan sistem

    Sistem operasi

    Arsitektur perangkat keras

    Windows 7, Windows Server 2008 R2, dan versi yang lebih baru

    i386, AMD64

    Linux 2.6.23 dan versi yang lebih baru (harus menyertakan pustaka Glibc)

    i386, AMD64, ARM64

    Agen Cloud Monitor kompatibel dengan distribusi Linux apa pun yang memenuhi kondisi berikut: versi kernel minimal 2.6.23 dan menyertakan pustaka Glibc. Distribusi yang umumnya kompatibel mencakup (namun tidak terbatas pada) CentOS, Ubuntu, Debian, Alibaba Cloud Linux, Anolis OS, Rocky Linux, AlmaLinux, dan Kylin OS.

    Metrik pemantauan dasar (seperti penggunaan CPU dan network traffic) dikumpulkan langsung dari host dan tidak memerlukan agen, sehingga tidak terpengaruh oleh distribusi Linux. Metrik tingkat sistem operasi seperti penggunaan memori dan penggunaan disk memerlukan instalasi Agen Cloud Monitor sebelum dapat dikumpulkan.

    Untuk jalur instalasi yang didukung, konsumsi sumber daya, dan log untuk agen C++, lihat Ikhtisar Agen Cloud Monitor.

Persyaratan jaringan host

  • Host harus dapat mengakses internet, baik secara langsung maupun melalui NAT Gateway atau server proxy.

  • Konfigurasi daftar izin firewall

    Jika firewall atau ECS security group dikonfigurasi untuk host, Anda harus menambahkan alamat dan port server Cloud Monitor ke daftar izin.

    Catatan

    Host pihak ketiga menggunakan port 443 untuk melaporkan data dan melakukan pemeriksaan heartbeat melalui internet.

    Alamat server

    Metode kueri

    Port server

    Deskripsi

    Heartbeat Service

    nslookup cms-cloudmonitor.aliyun.com atau ping cms-cloudmonitor.aliyun.com

    8080, 3128, 443

    Digunakan untuk pemeriksaan heartbeat agen.

    Pelaporan data

    VPC: nslookup metrichub-<regionid>.aliyun.com

    Internet: nslookup metrichub-cms-<regionid>.aliyuncs.com

    80, 443

    Digunakan untuk melaporkan data pemantauan.

    • <regionid> adalah ID wilayah host Alibaba Cloud. Jalankan perintah berikut untuk mendapatkan ID wilayah: curl http://100.100.100.200/latest/meta-data/region-id.

    • Pelaporan data melalui internet hanya tersedia di wilayah China (Hangzhou), China (Shanghai), China (Beijing), dan China (Shenzhen).

    Layanan metadata

    Blok CIDR tetap: 100.100.0.0/16

    0-65535

    Mendapatkan informasi instans (hanya untuk host Alibaba Cloud).

Perbaiki kegagalan resolusi DNS

Bagian ini hanya berlaku untuk host Linux.

Jika nslookup cms-cloudmonitor.aliyun.com mengembalikan Name or service not known atau no servers could be reached, berarti host tidak dapat meresolusi domain layanan heartbeat Cloud Monitor, sehingga Agen Cloud Monitor menjadi offline. Perbaiki masalah ini dengan langkah-langkah berikut:

  1. Edit /etc/resolv.conf dan tambahkan server DNS internal Alibaba Cloud berikut:

    nameserver 100.100.2.136
    nameserver 100.100.2.138
  2. Restart Agen Cloud Monitor:

    cd /usr/local/cloudmonitor && ./cloudmonitorCtl.sh restart
  3. Verifikasi bahwa proses agen sedang berjalan:

    ps aux | grep argusagent

    Secara normal, dua hingga tiga proses akan ditampilkan (daemon, wrapper, dan proses utama).

  4. Uji kembali resolusi DNS:

    nslookup cms-cloudmonitor.aliyun.com

    Jika alamat IP dikembalikan, resolusi DNS telah dipulihkan.

Perbandingan metode instalasi

Instal agen secara otomatis atau manual sesuai dengan jenis host dan lingkungan jaringan Anda.

Metode instalasi

Kasus penggunaan

Keuntungan

Instalasi otomatis dari konsol

Instance ECS Alibaba Cloud dan host pihak ketiga yang dikelola oleh Cloud Assistant.

Direkomendasikan. Metode sederhana ini mendukung operasi batch dan tidak memerlukan login ke host.

Instalasi manual

Skema di mana instalasi otomatis tidak tersedia, host pihak ketiga yang tidak dikelola, lingkungan internal atau offline, serta penerapan yang menggunakan skrip otomatisasi seperti Ansible.

Fleksibilitas tinggi dan cocok untuk semua lingkungan kompleks.

Catatan instalasi

  • Menginstal Agen Cloud Monitor tidak memengaruhi operasi bisnis atau memerlukan restart instance ECS Anda. Setelah instalasi, agen akan mulai secara otomatis dan mulai mengumpulkan data pemantauan. Jika Anda khawatir tentang dampaknya, instal agen selama jam sepi.

  • Instalasi otomatis tidak mengubah status login akun root (misalnya, noLogin). Bahkan jika login root langsung dinonaktifkan pada host, Cloud Assistant Agent (aliyun-service) tetap dapat melakukan instalasi atas nama root.

  • Agen Cloud Monitor (argusagent) dan agen pengumpulan Simple Log Service (loongcollector) merupakan komponen independen yang tidak saling bergantung. Menginstal, menguninstal, atau me-restart salah satu komponen tidak memengaruhi komponen lainnya.

  • Untuk host non-ECS seperti Simple Application Server, Anda harus menginstal Agen Cloud Monitor untuk melihat metrik tingkat sistem operasi seperti penggunaan memori dan disk di konsol. Metrik pemantauan dasar seperti penggunaan CPU dan network traffic dikumpulkan dari host dan tidak memerlukan agen.

Instalasi otomatis (Direkomendasikan)

Metode ini berlaku untuk host Alibaba Cloud dan instans yang dikelola Alibaba Cloud.

  1. Buka halaman Host Monitoring.

  2. Pada halaman Host Monitoring, pilih host tempat Anda ingin menginstal atau meningkatkan agen, lalu klik Batch Install/Upgrade Agent di pojok kiri bawah. Pada kotak dialog yang muncul, klik OK.

    Catatan
    • Untuk host Alibaba Cloud yang baru dibeli, Anda dapat mengaktifkan sakelar Automatically Install CloudMonitor Agent on Newly Purchased ECS Instances di pojok kanan atas. Setelah diaktifkan, Agen Cloud Monitor akan diinstal secara otomatis pada host ECS baru. Jika tidak, Anda harus menginstal agen secara manual.

    • Proses instalasi atau peningkatan membutuhkan waktu sekitar 5 menit. Ketika Agent Status host target berubah dari Installing menjadi Running, berarti operasi telah selesai.

Instalasi manual

Catatan

Instal agen secara manual jika instalasi otomatis gagal atau jika Anda menginstal di lingkungan khusus. Jika versi agen yang lebih lama atau rusak sudah terpasang di host, Anda harus menguninstalnya terlebih dahulu.

Catatan

Instance Simple Application Server tidak muncul dalam daftar Host Monitoring. Filter jenis host pada halaman Host Monitoring hanya menawarkan instance ECS dan host pihak ketiga, sehingga Anda tidak dapat memperoleh perintah instalasi dari kotak dialog Manual Installation untuk instance Simple Application Server. Sebagai gantinya, hubungkan ke instance melalui SSH dan instal agen secara manual.

Login ke instance Simple Application Server melalui SSH sebagai pengguna root, lalu jalankan perintah berikut untuk menginstal Agen 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)"

Ganti cn-shenzhen dalam perintah dengan ID wilayah instance tersebut. ARGUS_VERSION menentukan versi agen yang akan diinstal. Setelah perintah selesai, jalankan perintah berikut untuk memastikan proses agen sedang berjalan:

ps aux | grep argusagent

Data pemantauan instance Simple Application Server tidak ditampilkan pada halaman Host Monitoring. Setelah agen diinstal, login ke konsol Cloud Monitor dan pilih Cloud Service Monitoring > Compute > Simple Application Server untuk melihat data pemantauan. Namespace yang sesuai adalah acs_swas.

  1. Buka halaman Host Monitoring.

  2. Pada halaman Host Monitoring, klik Host & Agent Operations di atas daftar host, lalu klik Manual Installation dari menu drop-down.

  3. Pada kotak dialog Manual Installation, ikuti langkah-langkah berikut untuk menyelesaikan instalasi.

Host Alibaba Cloud

Linux

  1. Pada bidang Region, pilih wilayah tempat host Alibaba Cloud berada.

  2. Pada area Installation Command, klik ikon image.png di samping perintah untuk menyalin perintah tersebut. Pilih Linux atau Windows sebagai sistem operasi untuk mendapatkan perintah instalasi yang sesuai di area Installation Command.

  3. Login ke host sebagai pengguna root.

  4. Tempel dan jalankan perintah instalasi.

  5. Jalankan perintah berikut untuk memeriksa status agen:

    ps aux | grep argusagent | grep -v grep

    Jika output menyerupai berikut, berarti agen berjalan dengan benar.

    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. Pada bidang Region, pilih wilayah tempat host Alibaba Cloud berada.

  2. Unduh paket agen 32-bit atau 64-bit sesuai dengan sistem operasi host.

  3. Login ke host sebagai pengguna Administrator.

  4. Buat direktori C:\Program Files\Alibaba\cloudmonitor. Unggah paket plugin ke host, lalu ekstrak ke direktori C:\Program Files\Alibaba\cloudmonitor.

  5. Untuk membuka Command Prompt, tekan Win+R untuk membuka kotak dialog Run, masukkan cmd, lalu klik OK.

  6. Jalankan perintah berikut untuk menginstal Agen Cloud Monitor:

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

    2. argusagent_service.exe install

  7. Jalankan perintah net start argusagent untuk memulai Agen Cloud Monitor.

  8. Periksa status agen.

    1. Untuk membuka jendela Service, tekan Win+R untuk membuka kotak dialog Run, masukkan services.msc, lalu klik OK.

    2. Periksa status layanan argusagent. Jika statusnya Running, berarti agen berjalan dengan benar.

Host pihak ketiga

Linux

  1. Pada bidang Region, pilih wilayah untuk menerima data pemantauan.

  2. Pada kotak dialog Manual Installation, konfigurasikan parameter yang diperlukan untuk menghasilkan perintah instalasi. Di area Installation Command, klik ikon salin image.png untuk menyalin perintah tersebut.

  3. Login ke host sebagai pengguna root.

  4. Tempel dan jalankan perintah instalasi.

  5. Jalankan perintah berikut untuk memeriksa status agen:

    ps aux | grep argusagent | grep -v grep

    Jika output menyerupai berikut, berarti agen berjalan dengan benar.

    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. Pada bidang Region, pilih wilayah untuk menerima data pemantauan.

  2. Unduh paket agen (32-bit atau 64-bit, tergantung sistem operasi host) dan file konfigurasi accesskey.properties.

  3. Login ke host sebagai pengguna Administrator.

  4. Buat direktori C:\Program Files\Alibaba\cloudmonitor. Unggah paket plugin ke host, lalu ekstrak ke direktori C:\Program Files\Alibaba\cloudmonitor.

  5. Unggah file konfigurasi ke host dan letakkan di direktori C:\Program Files\Alibaba\cloudmonitor\local_data\conf.

  6. Jalankan perintah berikut untuk menginstal Agen Cloud Monitor:

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

    2. argusagent_service.exe install

  7. Jalankan perintah net start argusagent untuk memulai Agen Cloud Monitor.

  8. Periksa status agen.

    1. Untuk membuka jendela Service, tekan Win+R untuk membuka kotak dialog Run, masukkan services.msc, lalu klik OK.

    2. Periksa status layanan argusagent. Jika statusnya Running, berarti agen berjalan dengan benar.

Masalah umum

Jika host pihak ketiga yang telah menginstal Agen Cloud Monitor tidak dapat mengakses internet, agen tidak dapat melaporkan data pemantauan. Untuk mengatasi hal ini, konfigurasikan server proxy dengan memodifikasi file konfigurasi agent.properties untuk sistem operasi yang sesuai.

  • Jalur Linux: /usr/local/cloudmonitor/local_data/conf/agent.properties

  • Jalur Windows: C:\Program Files\Alibaba\cloudmonitor\local_data\conf\agent.properties

Untuk langkah-langkah detail, lihat Bagaimana cara menggunakan server proxy Nginx untuk melaporkan data pemantauan dari host pihak ketiga?.

Pemecahan Masalah

Jika Agen Cloud Monitor gagal diinstal atau dimulai, rujuk solusi berikut.

Skema 1: Mengklik Install atau Start di konsol beberapa kali tidak berpengaruh

Login ke host dan jalankan perintah berikut untuk memulai Cloud Assistant (aliyun-service). Kemudian ulangi operasi di konsol.

systemctl start aliyun-service

Skema 2: Instalasi gagal pada Simple Application Server

Lakukan pemeriksaan berikut secara berurutan:

  1. Verifikasi konektivitas layanan metadata. Jalankan perintah berikut:

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

    Jika ID wilayah dikembalikan, konektivitas normal.

  2. Verifikasi konektivitas URL unduhan agen. Ganti <region> dengan ID wilayah aktual Anda dan jalankan:

    ping cms-agent-<region>.oss-<region>.aliyuncs.com
  3. Periksa apakah proses agen sedang berjalan:

    ps -ef | grep cms
  4. Jika semua pemeriksaan berhasil tetapi instalasi tetap gagal, gunakan metode instalasi manual sebagai gantinya. Untuk langkah-langkah detail, lihat bagian Instalasi manual dalam topik ini.

Skema 3: Status agen menunjukkan Reinstalling/Upgrading atau operasi gagal

Periksa apakah Cloud Assistant Agent (aliyun-service) sedang berjalan. Jika tidak, restart atau perbaiki, lalu coba lagi instalasi Agen Cloud Monitor. Jika masalah berlanjut, instal ulang Agen Cloud Monitor secara manual.

Skema 4: Kegagalan koneksi agen (umum)

  1. Uninstal Agen Cloud Monitor, lalu instal ulang.

  2. Jika masalah berlanjut, coba instal versi tertentu (misalnya, versi 1.0.6) untuk menentukan apakah masalah terkait versi.

Migrasi dari Agen Lama

Jika host Anda menjalankan Agen Java atau Go lama — yang dapat diidentifikasi dari keberadaan direktori /usr/local/cloudmonitor/wrapper/ — ikuti langkah-langkah berikut untuk bermigrasi ke versi C++, yang menawarkan penggunaan sumber daya lebih rendah dan pembaruan fitur berkelanjutan.

Langkah-langkah (Linux)

  1. Hentikan Agen lama:

    bash /usr/local/cloudmonitor/wrapper/bin/cloudmonitor.sh stop
  2. Uninstal Agen lama:

    bash /usr/local/cloudmonitor/wrapper/bin/cloudmonitor.sh remove
    rm -rf /usr/local/cloudmonitor
  3. Instal versi C++ dengan mengikuti bagian Instalasi manual dalam dokumen ini.

  4. Jalankan Agen C++:

    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh start
  5. Verifikasi Agen sedang berjalan:

    ps aux | grep argusagent | grep -v grep

Operasi Umum

Jalankan agen

  • Linux

    Jalankan perintah berikut untuk memulai Agen Cloud Monitor:

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

    Jalankan perintah berikut untuk memulai Agen Cloud Monitor:

    net start argusagent

Periksa status agen

  • Linux

    Jalankan perintah berikut untuk memeriksa status agen:

    ps aux | grep argusagent | grep -v grep

    Jika output menyerupai berikut, berarti agen berjalan dengan benar.

    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. Untuk membuka jendela Service, tekan Win+R untuk membuka kotak dialog Run, masukkan services.msc, lalu klik OK.

    2. Periksa status layanan argusagent.

      Jika statusnya Running, berarti agen berjalan dengan benar.

Hentikan agen

  • Linux

    Jalankan perintah berikut untuk menghentikan Agen Cloud Monitor:

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

    Jalankan perintah berikut untuk menghentikan Agen Cloud Monitor:

    net stop argusagent

Uninstal agen

Setelah menguninstal versi C++ Agen Cloud Monitor, Anda tidak dapat lagi memantau host secara real-time, tetapi data pemantauan historis tetap tersedia.

  • Linux

    # 1. Hentikan Agen Cloud Monitor.
    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh stop
    # 2. Uninstal Agen Cloud Monitor.
    bash /usr/local/cloudmonitor/cloudmonitorCtl.sh uninstall
    # 3. Hapus direktori cloudmonitor.
    rm -rf /usr/local/cloudmonitor

    Jika skrip cloudmonitorCtl.sh tidak ada, uninstal agen dengan langkah-langkah berikut:

    1. Temukan direktori agen: find / -name cloudmonitor -type d

    2. Hentikan layanan: systemctl stop cloudmonitor

    3. Nonaktifkan layanan: systemctl disable cloudmonitor

    4. Hentikan proses sisa: kill -9 $(pgrep argusagent)

      Catatan

      Layanan argusagent dikonfigurasi dengan KillMode=none, sehingga systemctl stop tidak menghentikan proses tersebut. Proses yang sedang berjalan akan membuat ulang direktori /usr/local/cloudmonitor. Oleh karena itu, Anda harus menghentikan proses sebelum menghapus direktori.

    5. Hapus direktori agen: rm -rf /usr/local/cloudmonitor

    6. Hapus file layanan: rm -f /etc/systemd/system/cloudmonitor.service

    7. Muat ulang systemd: systemctl daemon-reload

    8. Hapus direktori konfigurasi: rm -rf /etc/cloudmonitor

    Setelah uninstalasi, jalankan perintah berikut untuk memverifikasi bahwa agen telah sepenuhnya dihapus:

    • systemctl status cloudmonitor mengembalikan not-found.

    • ls /usr/local/cloudmonitor menghasilkan No such file or directory.

    • ps aux | grep argusagent tidak mengembalikan proses apa pun.

    • find / -name cloudmonitor -type d tidak mengembalikan hasil.

  • Windows

    # 1. Hentikan Agen Cloud Monitor.
    net stop argusagent
    # 2. Uninstal Agen Cloud Monitor.
    "C:\Program Files\Alibaba\cloudmonitor\bin\argusagent_service.exe" uninstall
    # 3. Hapus direktori cloudmonitor.
    cd "C:\Program Files\Alibaba"
    rd /s /q cloudmonitor
    Catatan

    Jika jalur instalasi berisi spasi (misalnya, C:\Program Files\Alibaba\cloudmonitor), Anda harus membungkus jalur lengkap executable dengan tanda kutip ganda dalam perintah uninstal, seperti yang ditunjukkan pada langkah 2. Tanpa tanda kutip, Windows gagal menemukan executable dan mengembalikan error '...' is not recognized as an internal or external command.

    Jika Anda mengalami error izin atau kegagalan eksekusi perintah, pastikan pengguna Windows saat ini memiliki hak istimewa Administrator dan jalur file sudah benar.

FAQ

T: Mengapa beberapa metrik pemantauan (seperti penggunaan memori dan penggunaan disk) tidak ditampilkan atau hilang setelah saya menginstal Agen Cloud Monitor?

J:

  1. Ada jeda singkat antara pengumpulan dan pelaporan data. Tunggu beberapa menit, lalu refresh konsol.

  2. Periksa apakah status agen adalah Running. Jika statusnya Stopped, buka halaman Host Monitoring di konsol untuk menjalankan agen, atau login ke host dan jalankan:

    systemctl start aliyun-service
  3. Perhatikan perbedaan antara pemantauan dasar dan pemantauan sistem operasi: metrik pemantauan dasar (seperti penggunaan CPU dan network traffic) dikumpulkan dari host dan tidak memerlukan agen. Metrik tingkat sistem operasi seperti memori dan penggunaan disk memerlukan Agen Cloud Monitor. Jika agen tidak diinstal atau tidak berfungsi dengan benar, metrik ini tidak tersedia.

  4. Jika alert tidak dipicu sesuai harapan (misalnya, tidak ada alert saat penggunaan disk mencapai 100%), verifikasi bahwa agen telah diinstal dan berjalan. Data pemantauan harus berhasil dilaporkan agar aturan alert dapat berlaku.

T: Setelah saya menguninstal Agen Cloud Monitor, saya masih melihat proses yang sedang berjalan. Mengapa hal ini terjadi?

J:

Jika proses bernama aliyun_assist (atau aliyun-service) masih berjalan setelah Anda menguninstal Agen Cloud Monitor (argusagent), proses ini milik Cloud Assistant Agent (aliyun-service), yang merupakan produk independen dari Agen Cloud Monitor. Menguninstal Agen Cloud Monitor tidak secara otomatis menguninstal Cloud Assistant Agent. Jika Anda tidak lagi memerlukan Cloud Assistant Agent, lihat Stop and uninstall agent untuk menguninstalnya secara terpisah.

Dokumen Terkait

FAQ

API