Setelah menginstal agen Layanan Pemantauan Aplikasi Waktu Nyata (ARMS) untuk aplikasi Java, ARMS mulai memantau aplikasi tersebut. Anda dapat melihat data pemantauan seperti topologi aplikasi, jejak, transaksi abnormal, transaksi lambat, dan analisis SQL. Topik ini menjelaskan cara menginstal agen ARMS secara manual untuk aplikasi Java.
Untuk aplikasi yang diterapkan di kluster Container Service for Kubernetes (ACK), disarankan untuk menginstal komponen ack-onepilot daripada menginstal agen ARMS secara manual. Untuk informasi lebih lanjut, lihat Instalasi Otomatis Agen ARMS di ACK dan Instalasi Otomatis Agen ARMS di Kluster Kubernetes Sumber Terbuka.
Prasyarat
Konfigurasi jaringan harus memenuhi persyaratan. Untuk informasi lebih lanjut, lihat Konfigurasi Jaringan yang Diperlukan oleh Agen ARMS untuk Java.
Versi JDK harus didukung oleh Pemantauan Aplikasi. Untuk informasi lebih lanjut, lihat Komponen dan Framework Java yang Didukung oleh ARMS.
Memori heap maksimum proses harus lebih besar dari 256 MB.
Instalasi agen ARMS
Masuk ke Konsol ARMS. Di panel navigasi sebelah kiri, klik Integration Center.
Klik kartu Java Application Monitor. Di panel yang muncul, pilih Manual Installation.
Unduh agen ARMS.
Metode 1: Unduh agen ARMS secara manual. Di panel Java Application Monitor, unduh agen sesuai petunjuk.
Metode 2: Jalankan perintah wget. Unduh paket instalasi berdasarkan wilayah Anda.
Dekompresi paket instalasi.
Buka direktori paket instalasi. Jalankan perintah berikut untuk mendekompresi paket instalasi ke direktori kerja:
unzip AliyunJavaAgent.zip -d /{user.workspace}/Catatan{user.workspace} adalah direktori contoh. Ganti dengan direktori aktual.
Tambahkan parameter AppName dan LicenseKey.
AppName menentukan aplikasi yang diintegrasikan ke dalam ARMS. Masukkan nama aplikasi kustom sesuai kebutuhan. Dalam arsitektur terdistribusi, sebuah aplikasi dapat mencakup beberapa instans aplikasi peer.
Peroleh kunci lisensi di panel Pemantau Aplikasi Java atau dari API DescribeTraceLicenseKey.
Gunakan salah satu metode berikut untuk menambahkan parameter AppName dan LicenseKey:
Metode 1 (disarankan): Ganti parameter
{LicenseKey}dengan kunci lisensi yang diperoleh dari konsol dan ganti parameter{AppName}dengan nama aplikasi.Metode 2: Untuk menggunakan kembali skrip startup di berbagai aplikasi, modifikasi file konfigurasi agen untuk menentukan parameter LicenseKey dan AppName.
Di file version yang telah diekstrak pada langkah sebelumnya, lihat versi agen untuk Java.
Modifikasi file konfigurasi agen.
Agen ARMS V4.0.0 atau lebih baru
Di direktori agen, buat file bernama arms-agent.properties dan tambahkan konfigurasi berikut:
arms.licenseKey={LicenseKey} arms.appName={AppName}Kemudian, tambahkan
-Dotel.javaagent.configuration-file=/path/to/arms-agent.propertiesatau variabel lingkunganOTEL_JAVAAGENT_CONFIGURATION_FILE=/path/to/arms-agent.propertieske perintah startup untuk memulai file konfigurasi.Agen ARMS lebih lama dari V4.0.0
Di file arms-agent.config dari paket instalasi agen, tambahkan konfigurasi berikut:
arms.licenseKey={LicenseKey} arms.appName={AppName}CatatanUntuk informasi tentang konfigurasi agen lainnya di file konfigurasi, lihat Ubah Parameter Agen ARMS untuk Java dan Wilayah Pelaporan Data.
Tambahkan perintah integrasi ke perintah startup.
Ganti
{user.workspace}dengan direktori tempat agen ARMS diekstraksi. Ganti demoApp.jar dengan jalur ke paket JAR aktual.CatatanJika menggunakan agen ARMS versi sebelum V2.7.3.5, ganti AliyunJavaAgent/aliyun-java-agent.jar di kode sebelumnya dengan ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar. Disarankan untuk meningkatkan agen ke versi terbaru sesegera mungkin.
Di Windows, ganti
/di skrip dengan\dan ganti file.shdengan file.bat.Agen ARMS V2.7.1.4 memungkinkan Anda mengaktifkan Keamanan Aplikasi saat menghubungkan aplikasi ke Pemantauan Aplikasi. Jika perlu mengaktifkan Keamanan Aplikasi, tambahkan
-Darms.appsec.enable=truedi dalam skrip. Untuk informasi tentang aturan penagihan Keamanan Aplikasi, lihat Aturan Penagihan.
Lingkungan runtime
Prosedur
Aplikasi Spring Boot atau aplikasi Java lainnya yang dimulai dengan menjalankan perintah
java -jarTambahkan opsi -javaagent ke perintah startup. Pastikan parameter -javaagent ditulis sebelum parameter -jar.
java -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar -Darms.licenseKey={LicenseKey} -Darms.appName={AppName} -jar demoApp.jarTomcat
Tambahkan konfigurasi berikut ke file {TOMCAT_HOME}/bin/setenv.sh:
JAVA_OPTS="$JAVA_OPTS -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar -Darms.licenseKey={LicenseKey} -Darms.appName={AppName} "Jika layanan Tomcat Anda tidak berisi file konfigurasi setenv.sh, buka file {TOMCAT_HOME}/bin/catalina.sh dan tambahkan konfigurasi sebelumnya ke parameter JAVA_OPTS. Untuk informasi lebih lanjut, lihat baris 256 di file catalina.sh.
Jetty
Tambahkan konfigurasi berikut ke file konfigurasi {JETTY_HOME}/start.ini:
aliyun-java-agent.jar --exec -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar -Darms.licenseKey={LicenseKey} -Darms.appName={AppName}Untuk menyebarkan beberapa instans dari aplikasi yang sama di server, atur parameter -Darms.agentId ke nomor logis untuk membedakan proses JVM. Contoh:
java -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar -Darms.licenseKey={LicenseKey} -Darms.appName={AppName} -Darms.agentId=001 -jar demoApp.jarMulai ulang aplikasi Java.
(Opsional) Contoh Dockerfile
Untuk lingkungan Docker, Anda dapat merujuk contoh Dockerfile berikut untuk menginstal agen ARMS.
# Ganti {original-docker-image:tag} dengan alamat gambar Anda.
FROM {original-docker-image:tag}
# Ganti direktori kerja berdasarkan kebutuhan bisnis Anda.
WORKDIR /root/
# Dapatkan titik akhir publik atau virtual private cloud (VPC) tempat Anda dapat mengunduh paket instalasi agen ARMS di wilayah yang diinginkan. Untuk informasi lebih lanjut, lihat Langkah 4 bagian "Instalasi agen ARMS".
RUN wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/AliyunJavaAgent.zip" -O AliyunJavaAgent.zip
# Dekompresi paket instalasi agen ARMS.
RUN unzip AliyunJavaAgent.zip -d /root/
# Tulis parameter LicenseKey dan AppName ke variabel lingkungan. Untuk informasi lebih lanjut, lihat Langkah 6 bagian "Instalasi agen ARMS".
ENV arms_licenseKey={LicenseKey}
ENV arms_appName={AppName}
# Tambahkan skrip startup ke variabel lingkungan JAVA_TOOL_OPTIONS.
ENV JAVA_TOOL_OPTIONS ${JAVA_TOOL_OPTIONS} '-javaagent:/root/AliyunJavaAgent/aliyun-java-agent.jar -Darms.licenseKey='${arms_licenseKey}' -Darms.appName='${arms_appName}
### Periksa variabel lingkungan JAVA_TOOL_OPTIONS.
RUN env | grep JAVA_TOOL_OPTIONS
### Tambahkan logika Dockerfile kustom.
### ......Verifikasi hasil
Setelah sekitar 1 menit, pilih . Jika aplikasi Anda ditampilkan di halaman Application List dan beberapa catatan data dikirim, aplikasi Anda dipantau oleh ARMS.