Microservices Engine:Tambahkan antarmuka kustom di Microservices Governance

Batasan

• Pastikan MSE Java agent Anda menggunakan versi 3.2.9 atau yang lebih baru.

Catatan

Untuk informasi tentang versi agent, lihat catatan rilis MSE Java agent. Anda juga dapat menentukan versi agent dengan mengikuti petunjuk dalam Tentukan versi MSE agent.

• Karena keterbatasan model pemrograman, Microservices Governance hanya menampilkan antarmuka kustom yang memiliki lalu lintas aktif.

Prosedur

Jika aplikasi Anda sudah terhubung ke MSE Microservices Governance, ikuti langkah-langkah berikut untuk menambahkan antarmuka kustom.

1. Tambahkan dependensi berikut ke file pom.xml aplikasi Anda:

   <dependency>
     <groupId>com.alibaba.csp</groupId>
     <artifactId>sentinel-core</artifactId>
     <version>1.8.7</version>
   </dependency>

2. Tambahkan pelacakan (tracking). Bungkus logika bisnis Anda dengan kode berikut:

   import com.alibaba.csp.sentinel.Entry;
   import com.alibaba.csp.sentinel.SphU;
   import com.alibaba.csp.sentinel.slots.block.BlockException;
   import com.alibaba.csp.sentinel.EntryType;
   // HelloWorld adalah nama resource. Nama ini ditampilkan pada halaman pemantauan dan daftar antarmuka di Konsol.
   // Aturan juga dikonfigurasi berdasarkan nama resource ini.
   // EntryType.IN mengidentifikasi ini sebagai resource ingress.
   try (Entry entry = SphU.entry("HelloWorld", EntryType.IN)) {
    // Logika bisnis yang dilindungi.
    System.out.println("Hello MSE Sentinel!");
   } catch (BlockException e) {
    // Event pembatasan kecepatan atau degradasi dipicu. Tangani event ini di sini, misalnya dengan menggunakan fallback atau mencatat event tersebut.
   }

   Catatan

   • EntryType membedakan apakah lalu lintas pada suatu resource bersifat inbound atau outbound. EntryType.IN menunjukkan lalu lintas masuk (inbound), sedangkan EntryType.OUT menunjukkan lalu lintas keluar (outbound). Aturan sistem hanya berlaku pada resource ingress.

   • Total lalu lintas aplikasi yang ditampilkan di Konsol hanya mencakup statistik untuk lalu lintas EntryType.IN.

   • Nama resource untuk custom tracking tidak boleh melebihi 1.024 karakter.

   • Gunakan hanya simbol -, _, ., atau : untuk nama resource dalam custom tracking.

Verifikasi hasil

Masuk ke Konsol MSE. Di panel navigasi sebelah kiri, pilih Microservices Governance > Application Governance. Koneksi berhasil jika kartu sumber daya aplikasi muncul di halaman Application Governance dan melaporkan data.

Selain itu, jika antarmuka kustom Anda menghasilkan lalu lintas, antarmuka tersebut akan muncul di tab Custom Interface untuk aplikasi yang sesuai.

Buka halaman interface details aplikasi dan pilih tab Custom Interface. Di sisi kiri terdapat daftar setiap antarmuka kustom beserta metrik seperti volume permintaan dan tingkat keberhasilan. Di sisi kanan ditampilkan grafik pemantauan untuk QPS dan konkurensi maksimum pada antarmuka yang dipilih.

Dokumentasi terkait

Anda dapat melindungi antarmuka kustom Anda dengan langkah-langkah pengendalian lalu lintas. Untuk informasi selengkapnya, lihat Konfigurasikan aturan pembatasan kecepatan, Konfigurasikan aturan isolasi, dan Konfigurasikan aturan pemutusan sirkuit.