Setelah Anda menginstal agen untuk aplikasi Java, Cloud Monitor 2.0 akan mulai memantau aplikasi tersebut. Anda dapat melihat berbagai data pemantauan, seperti topologi aplikasi, tumpukan panggilan, transaksi abnormal, transaksi lambat, dan analisis SQL. Topik ini menjelaskan cara menginstal agen secara manual untuk aplikasi Java.
Untuk aplikasi yang dideploy di lingkungan Kubernetes, instalasi agen secara manual tidak disarankan. Sebagai gantinya, instal agen dengan menginstal sebuah komponen. Untuk informasi selengkapnya, lihat Instal agen Java untuk Container Service for Kubernetes (ACK) dan Container Compute Service (ACS) menggunakan komponen ack-onepilot.
Prasyarat
Sebelum memulai, pastikan bahwa:
Jaringan Anda memenuhi persyaratan konektivitas agen ARMS.
Versi JDK Anda termasuk dalam versi JDK yang didukung.
Memori heap maksimum JVM (
-Xmx) minimal 256 MB.
Instal agen
Masuk ke Konsol Cloud Monitor 2.0, lalu pilih ruang kerja. Di panel navigasi kiri, klik Integration Center.
-
Klik kartu Java Application Monitor. Di panel yang muncul, klik Manual Installation.
Unduh paket agen menggunakan salah satu metode berikut:
Dari konsol — Di panel Java Application Monitor, ikuti petunjuk unduhan.
Dari command line — Jalankan perintah
wgetuntuk wilayah Anda. Pilih wilayah Anda dari tabel berikut.
Ekstrak file ZIP yang telah diunduh ke direktori kerja:
unzip AliyunJavaAgent.zip -d <working-directory>Ganti
<working-directory>dengan direktori tempat Anda ingin menginstal agen.Tambahkan parameter AppName dan LicenseKey.
Di panel Java Application Monitoring, peroleh LicenseKey. Parameter AppName menentukan aplikasi di ARMS yang akan dihubungkan. Anda dapat menyesuaikan nama aplikasi tersebut. Dalam arsitektur terdistribusi, satu aplikasi dapat memiliki beberapa instans peer.
PentingLicenseKey bersifat spesifik untuk setiap ruang kerja. Anda harus memperoleh LicenseKey baru untuk ruang kerja yang baru.
Anda dapat menambahkan AppName dan LicenseKey dengan salah satu cara berikut.
Metode 1 (Direkomendasikan): Di skrip startup, ganti
{LicenseKey}dan{AppName}dengan LicenseKey yang Anda peroleh dari konsol dan AppName aplikasi Anda.Metode 2: Jika Anda ingin menggunakan kembali skrip startup untuk aplikasi yang berbeda, Anda dapat menentukan LicenseKey dan AppName dengan memodifikasi file konfigurasi agen. Untuk melakukannya, ikuti langkah-langkah berikut:
CatatanUntuk versi agen sebelum 4.4.0, metode ini menghubungkan aplikasi ke ruang kerja default.
Di file versi yang telah Anda ekstrak pada langkah sebelumnya, periksa versi agen Java.
Modifikasi file konfigurasi agen.
Agen versi 4.0.0 dan lebih baru
Di direktori agen, buat file bernama arms-agent.properties dan tambahkan konfigurasi berikut. Lalu, tambahkan
-Dotel.javaagent.configuration-file=/path/to/arms-agent.propertieske perintah startup atau tetapkan variabel lingkunganOTEL_JAVAAGENT_CONFIGURATION_FILE=/path/to/arms-agent.propertiesuntuk mengaktifkan file konfigurasi tersebut.arms.licenseKey={LicenseKey} arms.appName={AppName}Agen versi sebelum 4.0.0
Di file arms-agent.config dalam paket agen, tambahkan konfigurasi berikut.
arms.licenseKey={LicenseKey} arms.appName={AppName}CatatanUntuk informasi selengkapnya tentang item konfigurasi lainnya dalam file konfigurasi agen, lihat Modifikasi file konfigurasi agen Java dan wilayah pelaporan default.
Tambahkan perintah koneksi ke perintah startup.
Ganti
{user.workspace}dengan direktori tempat Anda mengekstrak paket instalasi agen. Ganti demoApp.jar dengan path aktual paket JAR Anda.CatatanJika Anda menggunakan versi agen sebelum 2.7.3.5, ganti AliyunJavaAgent/aliyun-java-agent.jar dalam topik ini dengan ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar. Kami menyarankan agar Anda segera melakukan upgrade agen ke versi terbaru.
Pada sistem operasi Windows, ganti
/dengan\dan ganti ekstensi file.shdengan.batdalam skrip.Agen versi V2.7.1.4 dan lebih baru mendukung keamanan aplikasi. Untuk mengaktifkan keamanan aplikasi saat menghubungkan ke Application Monitoring, tambahkan
-Darms.appsec.enable=trueke skrip. Untuk informasi selengkapnya tentang aturan penagihan keamanan aplikasi, lihat Penagihan.
Lingkungan runtime
Langkah-langkah
Aplikasi Spring Boot atau aplikasi Java lain yang dijalankan menggunakan perintah
java -jarTambahkan parameter -javaagent ke perintah startup. Pastikan parameter -javaagent ditempatkan sebelum parameter -jar.
java -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar -Darms.licenseKey={LicenseKey} -Darms.appName={AppName} -Darms.workspace={workspace} -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} -Darms.workspace={workspace} "Jika versi Tomcat Anda tidak memiliki file konfigurasi setenv.sh, buka file {TOMCAT_HOME}/bin/catalina.sh dan tambahkan konfigurasi di atas setelah JAVA_OPTS. Contohnya, lihat baris 256 di 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} -Darms.workspace={workspace}Untuk deploy beberapa instans aplikasi yang sama pada satu server, gunakan parameter -Darms.agentId (ID logis) untuk membedakan proses JVM. Contohnya:
java -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar -Darms.licenseKey={LicenseKey} -Darms.appName={AppName} -Darms.workspace={workspace} -Darms.agentId=001 -jar demoApp.jarMulai ulang aplikasi Java.
(Opsional) Instal dengan Docker
Untuk lingkungan Docker, Anda dapat merujuk contoh Dockerfile berikut untuk memodifikasi Dockerfile Anda.
# Ganti {original-docker-image:tag} dengan alamat image Anda.
FROM {original-docker-image:tag}
# Sesuaikan direktori kerja sesuai kebutuhan.
WORKDIR /root/
# Rujuk langkah instalasi agen di atas untuk mendapatkan URL unduhan agen sesuai wilayah Anda. Perhatikan perbedaan antara titik akhir publik dan titik akhir VPC.
RUN wget "http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/AliyunJavaAgent.zip" -O AliyunJavaAgent.zip
# Ekstrak agen.
RUN unzip AliyunJavaAgent.zip -d /root/
# Tulis LicenseKey, AppName, dan workspace ke variabel lingkungan.
ENV arms_licenseKey={LicenseKey}
ENV arms_appName={AppName}
ENV arms_workspace={workspace}
# Gabungkan skrip startup yang diperlukan dan tambahkan 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}' -Darms.workspace='${arms_workspace}
# Periksa variabel lingkungan JAVA_TOOL_OPTIONS.
RUN env | grep JAVA_TOOL_OPTIONS
# Tambahkan logika Dockerfile kustom di bawah ini.
# ......Lihat detail pemantauan
Masuk ke Konsol Cloud Monitor 2.0, lalu pilih ruang kerja. Di panel navigasi kiri, pilih All features > Application Observability > Application Monitoring.
Halaman Application List menampilkan aplikasi yang telah terhubung. Klik nama aplikasi untuk melihat data pemantauan detail.