Microservices Engine (MSE) secara otomatis mendeteksi antarmuka tingkat framework, seperti titik akhir Spring MVC dan layanan Dubbo. Untuk logika bisnis di luar framework tersebut—misalnya pekerjaan batch, tugas terjadwal, atau rutinitas validasi internal—Anda dapat mendaftarkan antarmuka kustom menggunakan Sentinel SDK. Setelah didaftarkan, antarmuka tersebut akan muncul di Konsol MSE dan mendukung penerapan aturan pembatasan kecepatan, pemutusan sirkuit, serta isolasi.
Tata kelola antarmuka kustom mencakup dua langkah independen:
Instrumentasikan kode Anda — bungkus blok kode target dengan API Sentinel untuk mendaftarkannya sebagai resource.
Konfigurasikan aturan di Konsol MSE — terapkan aturan pembatasan kecepatan, pemutusan sirkuit, atau isolasi pada resource tersebut.
Topik ini membahas langkah 1. Setelah instrumentasi diterapkan, antarmuka kustom akan muncul di Konsol MSE setiap kali menerima traffic. Anda kemudian dapat mengonfigurasi aturan tata kelolanya melalui konsol tersebut.
Prasyarat
Sebelum memulai, pastikan Anda telah memiliki:
Aplikasi dengan Microservices Governance yang diaktifkan
Agen Java MSE versi 3.2.9 atau lebih baru
Untuk detail versi agen, lihat Catatan rilis untuk agen Java. Untuk menetapkan versi tertentu, lihat Tentukan versi agen.
Visibilitas memerlukan traffic
Hanya antarmuka kustom yang menerima traffic yang muncul di Microservices Governance karena keterbatasan pola pemrograman. Jika blok kode yang telah diinstrumentasi belum dipanggil, antarmuka tersebut tidak akan ditampilkan di konsol.
Tambahkan dependensi SDK
Tambahkan pustaka inti Sentinel ke file pom.xml Anda:
<dependency>
<groupId>com.alibaba.csp</groupId>
<artifactId>sentinel-core</artifactId>
<version>1.8.7</version>
</dependency>Bungkus logika bisnis Anda
Gunakan SphU.entry() dalam blok try-with-resources untuk mendaftarkan bagian kode sebagai resource Sentinel. Nama resource tersebut akan menjadi pengenal antarmuka ini di Konsol MSE.
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 yang ditampilkan di halaman pemantauan dan daftar antarmuka di Konsol MSE.
// EntryType.IN menandainya sebagai resource ingress untuk inbound traffic.
try (Entry entry = SphU.entry("HelloWorld", EntryType.IN)) {
// Logika bisnis yang dilindungi
System.out.println("Hello MSE Sentinel!");
} catch (BlockException e) {
// Pembatasan kecepatan atau pemutusan sirkuit dipicu.
// Tangani dengan respons fallback atau catat event tersebut.
}Pola try-with-resources secara otomatis melepaskan entri saat keluar dari blok, sehingga mencegah kebocoran resource yang dapat terjadi jika Anda memanggil entry.exit() secara manual di blok finally.
Referensi parameter
| Parameter | Deskripsi |
|---|---|
resourceName | Pengenal yang ditampilkan di halaman pemantauan dan daftar antarmuka. Maksimal 1.024 karakter. Karakter yang direkomendasikan: tanda hubung (-), garis bawah (_), titik (.), dan titik dua (:) |
EntryType.IN | Inbound traffic. Menandai resource sebagai resource ingress. Aturan sistem hanya berlaku untuk resource ingress. Konsol MSE hanya menghitung traffic EntryType.IN terhadap total traffic aplikasi |
EntryType.OUT | Outbound traffic |
Verifikasi hasil
Masuk ke Konsol MSE.
Di panel navigasi sebelah kiri, pilih Microservices Governance > Application Governance.
Di halaman Application list, pastikan kartu resource aplikasi Anda muncul dan melaporkan data.
Hasilkan traffic pada antarmuka kustom, lalu buka halaman detail antarmuka dan pilih tab Custom Interface untuk memastikan antarmuka tersebut terdaftar.
Langkah selanjutnya
Terapkan aturan tata kelola pada antarmuka kustom: