Instal dan uninstal agen Cloud Monitor - Cloud Monitor - Alibaba Cloud Documentation Center

Agen Cloud Monitor mengumpulkan metrik pemantauan dari sistem operasi host dan mengirimkan data tersebut ke Cloud Monitor untuk dianalisis. Anda dapat menggunakan grafik visual untuk memantau status host dan membuat aturan alert untuk metrik penting guna segera mengidentifikasi serta menyelesaikan masalah. Topik ini menjelaskan cara menginstal, mengelola, dan menguninstal agen Cloud Monitor.

Penting

Anda hanya dapat mengelola agen Cloud Monitor menggunakan akun administrator (user root untuk Linux atau user 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 menginstal versi C++ dari agen.

Penagihan: Menginstal agen Cloud Monitor, melihat grafik pemantauan host, dan membuat aturan alert untuk metrik pemantauan tidak dikenai biaya.

Persyaratan sistem

Sistem operasi	Arsitektur perangkat keras
Windows 7, Windows Server 2008 R2, dan versi setelahnya	i386, AMD64
Linux 2.6.23 dan versi setelahnya (harus menyertakan library Glibc)	i386, AMD64, ARM64

Untuk informasi lebih lanjut mengenai 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 security group ECS 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 Tiongkok (Hangzhou), Tiongkok (Shanghai), Tiongkok (Beijing), dan Tiongkok (Shenzhen).
Layanan metadata	Blok CIDR tetap: 100.100.0.0/16	0-65535	Mendapatkan informasi instans (hanya untuk host Alibaba Cloud).

Perbandingan metode instalasi

Anda dapat menginstal agen secara otomatis atau manual berdasarkan 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 simple 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.	Sangat fleksibel dan cocok untuk semua lingkungan kompleks.

Catatan instalasi

Menginstal agen Cloud Monitor tidak memengaruhi operasi bisnis dan tidak 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 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 Lightweight Application Servers, Anda harus menginstal agen Cloud Monitor untuk melihat metrik tingkat OS 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.

Buka halaman Host Monitoring.
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 secara otomatis diinstal pada host ECS baru. Jika tidak, Anda harus menginstal agen secara manual.
- Instalasi atau peningkatan membutuhkan waktu sekitar 5 menit. Ketika Agent Status host target berubah dari Installing menjadi Running, 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 lama atau rusak sudah ada di host, Anda harus menguninstalnya terlebih dahulu.

Buka halaman Host Monitoring.
Pada halaman Host Monitoring, klik Host & Agent Operations di atas daftar host, lalu klik Manual Installation dari menu drop-down.
Pada kotak dialog Manual Installation, ikuti langkah-langkah berikut untuk menyelesaikan instalasi.

Host Alibaba Cloud

Linux

Pada bidang Region, pilih wilayah tempat host Alibaba Cloud berada.
Pada area Installation Command, klik ikon di samping perintah untuk menyalin perintah tersebut. Pilih Linux atau Windows sebagai sistem operasi untuk mendapatkan perintah instalasi yang sesuai di area Installation Command.
Login ke host sebagai user root.
Tempel dan jalankan perintah instalasi.

Jalankan perintah berikut untuk memeriksa status agen:

ps aux | grep argusagent | grep -v grep

Jika output menyerupai contoh berikut, 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

Pada bidang Region, pilih wilayah tempat host Alibaba Cloud berada.
Unduh paket agen 32-bit atau 64-bit sesuai dengan sistem operasi host.
Login ke host sebagai user Administrator.
Buat direktori C:\Program Files\Alibaba\cloudmonitor. Unggah paket plugin ke host, lalu ekstrak ke direktori C:\Program Files\Alibaba\cloudmonitor.
Untuk membuka Command Prompt, tekan Win+R untuk membuka kotak dialog Run, masukkan cmd, lalu klik OK.
Jalankan perintah berikut untuk menginstal agen Cloud Monitor:
1. cd C:\Program Files\Alibaba\cloudmonitor\bin
2. argusagent_service.exe install
Jalankan perintah net start argusagent untuk memulai agen Cloud Monitor.
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, agen berjalan dengan benar.

Host pihak ketiga

Linux

Pada bidang Region, pilih wilayah untuk menerima data pemantauan.
Pada kotak dialog Manual Installation, konfigurasikan parameter yang diperlukan untuk menghasilkan perintah instalasi. Di area Installation Command, klik ikon salin untuk menyalin perintah tersebut.
Login ke host sebagai user root.
Tempel dan jalankan perintah instalasi.

Jalankan perintah berikut untuk memeriksa status agen:

ps aux | grep argusagent | grep -v grep

Jika output menyerupai contoh berikut, 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

Pada bidang Region, pilih wilayah untuk menerima data pemantauan.
Unduh paket agen (32-bit atau 64-bit, tergantung sistem operasi host) dan file konfigurasi accesskey.properties.
Login ke host sebagai user Administrator.
Buat direktori C:\Program Files\Alibaba\cloudmonitor. Unggah paket plugin ke host, lalu ekstrak ke direktori C:\Program Files\Alibaba\cloudmonitor.
Unggah file konfigurasi ke host dan letakkan di direktori C:\Program Files\Alibaba\cloudmonitor\local_data\conf.
Jalankan perintah berikut untuk menginstal agen Cloud Monitor:
1. cd C:\Program Files\Alibaba\cloudmonitor\bin
2. argusagent_service.exe install
Jalankan perintah net start argusagent untuk memulai agen Cloud Monitor.
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, 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 ke server Cloud Monitor. Untuk mengatasi hal ini, konfigurasikan server proxy untuk agen dengan memodifikasi file konfigurasi agent.properties sesuai sistem operasi yang digunakan.

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 mengenai konfigurasi server proxy, 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 coba ulang operasi di konsol.

systemctl start aliyun-service

Skenario 2: Instalasi Gagal di Lightweight Application Server

Lakukan pemeriksaan berikut secara berurutan:

Verifikasi konektivitas layanan metadata. Jalankan perintah berikut:
```
curl http://100.100.100.200/latest/meta-data/region-id
```
Jika ID wilayah dikembalikan, konektivitas normal.
Verifikasi konektivitas URL unduhan agen. Ganti <region> dengan ID wilayah aktual Anda dan jalankan:
```
ping cms-agent-<region>.oss-<region>.aliyuncs.com
```
Periksa apakah proses agen sedang berjalan:
```
ps -ef | grep cms
```
Jika semua pemeriksaan berhasil tetapi instalasi tetap gagal, gunakan metode instalasi manual. Untuk langkah-langkah detail, lihat 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 ulang instalasi agen Cloud Monitor. Jika masalah berlanjut, instal ulang agen Cloud Monitor secara manual.

Skenario 4: Kegagalan Koneksi Agen (Umum)

Uninstal agen Cloud Monitor, lalu instal ulang.
Jika masalah berlanjut, coba instal versi tertentu (misalnya, versi 1.0.6) untuk menentukan apakah masalah terkait versi.

Operasi Umum

Memulai 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
```

Memeriksa status agen

Linux

Jalankan perintah berikut untuk memeriksa status agen:

ps aux | grep argusagent | grep -v grep

Jika output menyerupai contoh berikut, 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, agen berjalan dengan benar.

Menghentikan 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
```

Hapus instalan agen

Setelah menguninstal versi C++ dari agen Cloud Monitor, Anda tidak dapat lagi memantau host secara real-time di konsol Cloud Monitor, tetapi masih dapat melihat data pemantauan historisnya.

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

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 user 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?

Ada jeda singkat antara pengumpulan dan pelaporan data. Tunggu beberapa menit, lalu refresh konsol Cloud Monitor.
Periksa apakah status agen adalah Running. Jika statusnya Stopped, buka halaman Host Monitoring di konsol untuk memulai agen, atau login ke host dan jalankan:
```
systemctl start aliyun-service
```
Perhatikan perbedaan antara pemantauan dasar dan pemantauan OS: metrik pemantauan dasar (seperti penggunaan CPU dan network traffic) dikumpulkan dari host dan tidak memerlukan agen. Metrik tingkat OS seperti penggunaan memori dan disk memerlukan agen Cloud Monitor agar diinstal dan berjalan. Jika agen tidak diinstal atau tidak berfungsi dengan benar, metrik ini tidak tersedia.
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 sebelum aturan alert dapat berlaku.

Dokumen Terkait

FAQ

API