：Tambahkan antarmuka kustom ke Tata Kelola Layanan Mikro

Batasan

• Versi agen Java MSE Anda harus 3.2.9 atau yang lebih baru.

Catatan

Untuk informasi lebih lanjut tentang versi agen, lihat Catatan Rilis untuk Agen Java. Anda juga dapat menentukan versi dengan mengikuti petunjuk di Tentukan Versi Agen.

• Hanya antarmuka kustom yang menghasilkan lalu lintas yang dapat ditampilkan di Tata Kelola Layanan Mikro karena keterbatasan pola pemrograman.

Prosedur

Jika Tata Kelola Layanan Mikro telah diaktifkan untuk aplikasi Anda, ikuti langkah-langkah berikut untuk menambahkan antarmuka kustom:

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

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

2. Konfigurasikan pelacakan. Gunakan kode berikut untuk membungkus logika bisnis Anda:

   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 sumber daya yang akan dipanggil. Sumber daya ditampilkan di halaman pemantauan dan dalam daftar antarmuka di konsol MSE.
   // Aturan dikonfigurasi untuk sumber daya.
   // EntryType.IN menunjukkan bahwa sumber daya adalah sumber daya masuk.
   try (Entry entry = SphU.entry("HelloWorld", EntryType.IN)) {
    // Logika bisnis dilindungi.
    System.out.println("Hello MSE Sentinel!");
   } catch (BlockException e) {
    // Pembatasan dan degradasi dipicu. Proses pembatasan, seperti fallback atau pencatatan, dilakukan.
   }

   Catatan

   • EntryType menentukan apakah lalu lintas pada sumber daya adalah lalu lintas masuk atau keluar. EntryType.IN menunjukkan lalu lintas masuk dan EntryType.OUT menunjukkan lalu lintas keluar. Aturan sistem hanya berlaku untuk sumber daya masuk.

   • Jumlah total lalu lintas aplikasi yang ditampilkan di konsol MSE hanya mencakup lalu lintas yang ditunjukkan oleh EntryType.IN.

   • Nama sumber daya untuk pelacakan kustom tidak boleh melebihi 1.024 karakter.

   • Simbol yang direkomendasikan yang dapat digunakan dalam nama sumber daya untuk pelacakan kustom adalah tanda hubung (-), garis bawah (_), titik (.) atau titik dua (:).

Verifikasi hasil

Masuk ke konsol MSE. Di panel navigasi sebelah kiri, pilih Microservices Governance > Application Governance. Jika kartu sumber daya aplikasi muncul di halaman Application list dan data dilaporkan, Tata Kelola Layanan Mikro telah diaktifkan untuk aplikasi tersebut.

Jika lalu lintas dihasilkan pada antarmuka kustom, Anda dapat melihat antarmuka kustom di tab Antarmuka Kustom halaman detail antarmuka.

Referensi

Untuk informasi lebih lanjut tentang cara melakukan perlindungan lalu lintas pada antarmuka kustom, lihat Buat Aturan Pembatasan, Buat Aturan Isolasi, dan Buat Aturan Pemutusan Sirkuit.