Troubleshooting kegagalan instalasi manual agen ARMS - Application Real-Time Monitoring Service

Topik ini menjelaskan cara mendiagnosis dan mengatasi masalah umum saat menginstal secara manual agen Application Real-Time Monitoring Service (ARMS) untuk aplikasi Java.

Catatan

Sebelum memulai troubleshooting, pastikan agen ARMS tidak berfungsi sebagaimana mestinya. Untuk informasi lebih lanjut, lihat Bagaimana cara memeriksa apakah agen ARMS telah diinstal?

Pemeriksaan awal

Sebelum menyelidiki masalah spesifik, jalankan perintah berikut untuk memverifikasi bahwa parameter -javaagent termasuk dalam proses Java Anda:

ps -ef | grep java | grep javaagent

Jika tidak ada output yang dikembalikan, file JAR agen ARMS tidak tersambung ke JVM. Periksa kembali perintah startup aplikasi Anda dan pastikan parameter -javaagent telah ditentukan. Untuk informasi lebih lanjut, lihat Manually install an ARMS agent.

Masalah 1: Error "LicenseKey is invalid" akibat ketidaksesuaian wilayah

Gejala

Error LicenseKey is invalid muncul dalam log di direktori ArmsAgent/log/.

Penyebab

Paket instalasi agen ARMS bersifat spesifik per wilayah. Informasi endpoint ARMS telah dikemas dalam paket tersebut. Jika Anda mengunduh paket untuk wilayah yang berbeda dari wilayah tempat aplikasi Anda berjalan, agen tidak dapat terhubung ke endpoint ARMS yang benar.

Solusi

Verifikasi wilayah tempat aplikasi Anda berjalan.
Unduh paket instalasi agen ARMS untuk wilayah tersebut. Untuk tautan unduhan, lihat Manually install an ARMS agent.
Ganti direktori agen yang ada dengan paket yang baru diunduh.
Restart aplikasi Anda.

Masalah 2: License key salah

Gejala

Error LicenseKey is invalid muncul dalam log agen di direktori ArmsAgent/log/.

Penyebab

License key yang ditentukan dalam perintah startup tidak sesuai dengan license key yang ditetapkan untuk aplikasi Anda di Konsol ARMS.

Solusi

Login ke ARMS console.
Di panel navigasi sebelah kiri, pilih Application Monitoring > Application List.
Di halaman Applications, klik nama aplikasi Anda dan temukan license key-nya.
Bandingkan license key di konsol dengan nilai parameter -Darms.licenseKey dalam perintah startup Anda. Pastikan keduanya identik.
Jika nilainya berbeda, perbarui perintah startup dengan license key yang benar dan restart aplikasi Anda.

Masalah 3: Versi JDK tidak didukung

Gejala

Agen ARMS gagal memulai atau tidak melaporkan data setelah aplikasi dimulai.

Penyebab

Versi JDK 1.8 awal tertentu, khususnya 1.8.0_25 dan 1.8.0_31, memiliki masalah kompatibilitas yang dikenal sehingga mencegah agen ARMS berfungsi dengan benar.

Solusi

Periksa versi JDK Anda:
```
java -version
```
Jika output menunjukkan versi 1.8.0_25 atau 1.8.0_31, lakukan upgrade ke versi JDK yang lebih baru.
Untuk daftar lengkap versi JDK dan framework yang didukung, lihat Java components and frameworks supported by ARMS.

Masalah 4: File JAR agen tidak dimuat karena masalah izin

Gejala

Setelah aplikasi dimulai, subdirektori logs tidak ada di direktori ArmsAgent.

Penyebab

File aliyun-java-agent.jar tidak dimuat oleh JVM. Hal ini biasanya terjadi ketika direktori ArmsAgent memiliki izin file yang salah, atau ketika parameter -javaagent dalam perintah startup mengarah ke path yang salah.

Solusi

Verifikasi bahwa parameter -javaagent dalam perintah startup Anda mengarah ke file JAR yang benar:
```
# Contoh: periksa baris perintah proses aktual
ps -ef | grep java | grep javaagent
```
Verifikasi bahwa direktori ArmsAgent dan isinya dapat dibaca oleh pengguna yang menjalankan aplikasi:
```
ls -la /path/to/ArmsAgent/
```
Jika izin salah, perbaiki.
```
chmod -R 755 /path/to/ArmsAgent/
```
Restart aplikasi dan periksa apakah subdirektori logs telah dibuat di direktori ArmsAgent.

Hubungi kami

Jika masalah tetap berlanjut setelah Anda mencoba semua solusi di atas, submit a ticket. Sertakan informasi berikut dalam tiket Anda untuk mempercepat proses troubleshooting:

Versi agen ARMS.
Versi JDK (output dari java -version).
Perintah startup aplikasi.
File log dari direktori ArmsAgent/log/.
Wilayah tempat aplikasi Anda dideploy.