Instal MSE Java agent untuk aktifkan Microservices Governance di ECS - Microservices Engine

Microservices Engine (MSE) menyediakan agen Java yang menambahkan kemampuan tata kelola ke aplikasi Spring Cloud atau Dubbo yang sudah ada tanpa perubahan kode. Agen tersebut disambungkan ke JVM aplikasi Anda, mengintersepsi panggilan layanan saat waktu proses, dan menerapkan kebijakan tata kelola yang Anda konfigurasikan di Konsol MSE.

Panduan ini memandu Anda melalui proses mengunduh agen Java MSE, mengonfigurasikannya pada instans Elastic Compute Service (ECS), dan memverifikasi koneksi. Langkah-langkah yang sama berlaku untuk aplikasi pada mesin virtual (VM) non-Alibaba Cloud.

Cara kerja agen

Agen Java MSE berjalan sebagai plugin JVM (-javaagent). Saat startup, agen melakukan autentikasi dengan lapisan kontrol MSE menggunakan kunci lisensi spesifik wilayah Anda, lalu mengintersepsi panggilan layanan inbound dan outbound untuk menegakkan kebijakan tata kelola. Agen melaporkan metadata aplikasi ke Konsol MSE, tempat aplikasi Anda muncul di bawah Microservices Governance > Application Governance.

Karena MSE dan Application Real-Time Monitoring Service (ARMS) menggunakan agen dasar yang sama, satu sambungan -javaagent menangani baik tata kelola maupun pemantauan jika Anda menggunakan kedua layanan tersebut.

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

Instans ECS. Untuk informasi lebih lanjut, lihat Buat instans ECS.
Java Development Kit (JDK) yang telah diinstal dengan variabel lingkungan JAVA_HOME dikonfigurasi. Untuk tautan unduhan, lihat Java Downloads.
Memori heap JVM lebih dari 256 MB. Agen Java MSE tidak dapat dimulai dengan heap yang lebih kecil.
Instans MSE Microservices Governance di wilayah yang sama dengan instans ECS Anda. Kunci lisensi bersifat spesifik wilayah, sehingga ketidaksesuaian wilayah menyebabkan agen gagal dalam autentikasi.

Catatan

MSE Microservices Governance tersedia dalam tiga edisi: Edisi Dasar, Edisi Profesional, dan Edisi Perusahaan. Pilih edisi yang sesuai dengan kebutuhan tata kelola Anda.

Langkah 1: Unduh agen Java MSE

Masuk ke Konsol ECS.
Pada panel navigasi kiri, pilih Instances & Images > Instances.
Pada bilah navigasi atas, pilih region.
Pada halaman Instances, temukan instans tempat Anda ingin mengaktifkan Microservices Governance dan klik Connect di kolom Actions.
Pada kotak dialog Remote connection, pilih metode koneksi. Untuk detailnya, lihat Metode untuk menghubungkan ke instans ECS.

Unduh paket agen. Ganti ${regionId} dengan ID wilayah aktual Anda (misalnya, cn-hangzhou). Untuk daftar lengkap ID wilayah yang didukung, lihat Wilayah yang didukung.Unduh melalui internet:Unduh melalui VPC (disarankan jika instans Anda tidak memiliki akses internet):Misalnya, untuk mengunduh agen di wilayah China (Hangzhou) melalui internet:

   wget http://arms-apm-${regionId}.oss-${regionId}.aliyuncs.com/AliyunJavaAgent.zip \
     -O AliyunJavaAgent.zip

   wget http://arms-apm-${regionId}.oss-${regionId}-internal.aliyuncs.com/AliyunJavaAgent.zip \
     -O AliyunJavaAgent.zip

   wget http://arms-apm-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/AliyunJavaAgent.zip \
     -O AliyunJavaAgent.zip

Penting

Paket agen bersifat spesifik wilayah. Selalu unduh paket yang sesuai dengan wilayah instans Microservices Governance Anda.

Langkah 2: Instal dan konfigurasikan agen

Ekstrak paket agen ke direktori pilihan Anda. Ganti <your-install-dir> dengan path direktori aktual, seperti /opt/mse.
```
   unzip AliyunJavaAgent.zip -d /<your-install-dir>/
```

Tambahkan parameter JVM berikut ke perintah startup aplikasi Anda. Ganti placeholder berikut dengan nilai aktual Anda:

Penting

Memori heap JVM harus lebih dari 256 MB. Agen gagal dimulai jika heap lebih kecil.

Placeholder	Deskripsi	Contoh
`<your-install-dir>`	Direktori tempat Anda mengekstrak agen	`/opt/mse`
`<your-license-key>`	Kunci lisensi dari Konsol MSE. Buka Microservices Governance > Overview untuk menemukannya. Jangan bagikan kunci ini.	`abcdef1234****`
`<your-app-name>`	Nama yang mengidentifikasi aplikasi Anda di Konsol MSE	`order-service`

   java \
     -javaagent:/<your-install-dir>/AliyunJavaAgent/aliyun-java-agent.jar \
     -Dmse.licenseKey=<your-license-key> \
     -Dmse.appName=<your-app-name> \
     -Dprofiler.micro.service.mse.version=pro \
     -Dmse.namespace=default \
     -Dmse.enable=true \
     -jar application.jar

Referensi parameter

Parameter	Deskripsi
`mse.licenseKey`	Kunci lisensi yang dihasilkan oleh MSE, terlihat pada halaman Overview Microservices Governance. Spesifik wilayah. Simpan kerahasiaannya.
`mse.appName`	Nama tampilan aplikasi Anda di Konsol MSE.
`profiler.micro.service.mse.version`	Edisi tata kelola yang akan diaktifkan. Nilai yang valid: `base` (Edisi Dasar), `pro` (Edisi Profesional), `ent` (Edisi Perusahaan).
`mse.namespace`	Namespace tata kelola tempat aplikasi ini berada. Cari namespace yang tersedia di Konsol MSE.
`mse.enable`	Atur ke `true` untuk mengaktifkan tata kelola, atau `false` untuk menonaktifkannya.

Jika aplikasi Anda sudah menggunakan ARMS

MSE dan ARMS menggunakan agen Java yang sama. Jika parameter -javaagent sudah ada dalam perintah startup Anda untuk ARMS, jangan tambahkan lagi. Cukup tambahkan parameter khusus MSE (mse.licenseKey, mse.appName, profiler.micro.service.mse.version, mse.namespace, dan mse.enable) ke perintah yang sudah ada.

Langkah 3: Verifikasi koneksi

Masuk ke Konsol MSE.
Pada bilah navigasi atas, pilih wilayah yang sesuai dengan penerapan aplikasi Anda.
Pada panel navigasi kiri, pilih Microservices Governance > Application Governance.
Konfirmasi bahwa aplikasi Anda muncul dalam daftar aplikasi. Jika ya, agen telah terhubung dan tata kelola aktif.

Langkah selanjutnya

Dengan Microservices Governance diaktifkan, Anda dapat mengelola aplikasi Spring Cloud atau Dubbo Anda dari Konsol MSE. Gunakan kemampuan tata kelola yang disediakan oleh MSE untuk meningkatkan stabilitas dan efisiensi pengembangan aplikasi layanan mikro online Anda.