：Aktifkan Tata Kelola Microservices untuk aplikasi microservice pada instance ECS

Langkah 1: Unduh paket instalasi Agen Java MSE

1. Masuk ke Konsol ECS.

2. Di panel navigasi sebelah kiri, pilih Instances & Images > Instances.

3. Di bilah navigasi atas, pilih region.

4. Di halaman Instances, temukan instance tempat Anda ingin mengaktifkan Tata Kelola Microservices dan klik Connect di kolom Actions.

5. Di kotak dialog Remote connection, pilih metode koneksi. Untuk informasi lebih lanjut, lihat Metode untuk menghubungkan ke instance ECS.

6. Unduh paket instalasi Agen Java MSE.

   URL untuk mengunduh paket instalasi Agen Java MSE dari Internet di setiap wilayah:

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

   URL untuk mengunduh paket instalasi Agen Java MSE dari virtual private cloud (VPC) di setiap wilayah:

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

   Dalam contoh ini, instance ECS diterapkan di wilayah China (Hangzhou). Agen Java MSE diunduh menggunakan perintah Linux. MSE Tata Kelola Microservices yang dapat diakses diterapkan di wilayah China (Hangzhou). Untuk mengunduh Agen Java MSE di wilayah lain, ganti ${regionId} di URL. Anda dapat memperoleh ID wilayah yang diperlukan dari Wilayah yang didukung.

   Catatan

   Konten Agen Java MSE dan MSE Tata Kelola Microservices yang dapat Anda akses bervariasi berdasarkan wilayah. Gunakan informasi wilayah yang benar untuk mengunduh Agen Java MSE di wilayah yang berbeda.

   • Perintah untuk mengunduh skrip dari Internet

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

   • Perintah untuk mengunduh skrip dari VPC: (digunakan jika skrip tidak dapat diunduh dari Internet)

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

Langkah 2: Instal Agen Java MSE

Ekstrak dan instal paket instalasi Agen Java MSE setelah diunduh.

1. Ekstrak AliyunJavaAgent.zip ke dalam direktori.

   Catatan

   Ganti {user.workspace} dengan direktori tempat file ZIP diekstraksi di sistem Anda.

   unzip AliyunJavaAgent.zip -d /{user.workspace}/ 

2. Tambahkan parameter javaagent, mse.licenseKey, mse.appName, profiler.micro.service.mse.version, mse.namespace, dan mse.enable ke perintah startup aplikasi asli.

   -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar
   -Dmse.licenseKey=<yourLicenseKey>            # Ganti <yourLicenseKey> dengan kunci lisensi yang dihasilkan secara otomatis oleh MSE. Anda dapat melihat kunci lisensi di halaman Overview Tata Kelola Microservices di konsol MSE. Jangan membocorkan kunci lisensi.
   -Dmse.appName=<yourAppName>                  # Ganti <yourAppName> dengan nama aplikasi Anda.
   -Dprofiler.micro.service.mse.version=pro     # Tentukan edisi MSE Tata Kelola Microservices yang diaktifkan. base menunjukkan Basic Edition, pro menunjukkan Professional Edition, dan ent menunjukkan Enterprise Edition.
   -Dmse.namespace=default                      # Tentukan namespace Tata Kelola Microservices, yang dapat diquery di konsol MSE.
   -Dmse.enable=true                            # Tentukan apakah akan mengaktifkan MSE Tata Kelola Microservices.

   Contohnya:

   Perintah berikut adalah perintah asli untuk memulai aplikasi.

   java -jar application.jar

   Untuk mengaktifkan MSE Tata Kelola Microservices untuk aplikasi, ubah perintah asli menjadi perintah berikut:

   java -javaagent:/{user.workspace}/AliyunJavaAgent/aliyun-java-agent.jar -Dmse.licenseKey=xxx -Dmse.appName=xxx -Dprofiler.micro.service.mse.version=pro -Dmse.namespace=default -Dmse.enable=true -jar application.jar

   MSE dan Application Real-Time Monitoring Service (ARMS) berbagi agen yang sama. Jika aplikasi Anda terhubung ke MSE dan ARMS pada saat yang sama, Anda hanya perlu menambahkan parameter mse.licenseKey, mse.appName, profiler.micro.service.mse.version, mse.namespace, dan mse.enable. Anda tidak perlu menambahkan parameter javaagent.

   Parameter	Deskripsi
   mse.licenseKey	Kunci lisensi yang dihasilkan secara otomatis oleh MSE. Anda dapat melihat kunci lisensi di halaman Overview Tata Kelola Microservices di konsol MSE. Jangan mengungkapkan kunci lisensi kepada pihak ketiga. Nilai mse.licenseKey bervariasi berdasarkan wilayah.
   mse.appName	Nama aplikasi. Ganti <yourAppName> dengan nama aplikasi Anda.
   profiler.micro.service.mse.version	Edisi Tata Kelola Microservices yang digunakan. Nilai valid: base: Basic Edition pro: Professional Edition ent: Enterprise Edition
   mse.namespace	Nama namespace Tata Kelola Microservices tempat aplikasi tersebut termasuk.
   mse.enable	Menentukan apakah akan mengaktifkan Tata Kelola Microservices.

Langkah 3: Verifikasi hasilnya

1. Masuk ke Konsol MSE, dan pilih wilayah di bilah navigasi atas.

2. Di bilah navigasi sisi kiri, pilih Microservices Governance > Application Governance untuk memeriksa apakah aplikasi Anda terhubung ke MSE.