All Products
Search

This Product

    Microservices Engine:Mengelola layanan

    Document Center

    Microservices Engine:Mengelola layanan

    Last Updated:Aug 11, 2026

    Saat Anda meng-hosting instans Nacos di Microservice Engine (MSE), MSE mengelola layanan yang terdaftar pada instans tersebut. Topik ini menjelaskan cara mengelola layanan.

    Prasyarat

    Buat layanan

    Catatan

    Anda dapat membuat layanan kosong (layanan tanpa penyedia) di Konsol untuk keperluan definisi layanan atau pengujian. Agar layanan kosong muncul dalam daftar, Anda harus menonaktifkan Hide Empty Services.

    1. Login ke Konsol MSE, lalu pilih wilayah di bilah navigasi atas.

    2. Di panel navigasi kiri, pilih Microservices Registry > Instances.

    3. Pada halaman Instances, klik nama instans.

    4. Di panel navigasi kiri, pilih Service Management > Services. Di pojok kiri atas halaman, pilih Namespace, lalu klik Create service.

    5. Pada panel Create service, konfigurasikan parameter, lalu klik OK.

      Nacos 2.1.2.1 atau yang lebih baru

      Parameter

      Deskripsi

      Service Name

      Nama layanan.

      Group Name

      Nama grup tempat layanan tersebut berada.

      Instance Source

      Pilih sumber instans. Nilai yang valid: Console dan SDK.

      Protection Threshold

      Jika Anda mengatur Instance Source ke Console atau SDK, Anda harus menetapkan ambang batas perlindungan. Atur nilai ini sebagai rasio jumlah minimum node yang diperlukan untuk menangani traffic puncak. Misalnya, jika Anda memiliki 10 node instans dan memerlukan minimal 6 node untuk menangani traffic puncak, sistem dapat mengalami gangguan jika tersedia kurang dari 6 node. Dalam kasus ini, atur ambang batas perlindungan menjadi 0,6.
      Nacos 2.0.3.0 hingga 2.1.2.0

      Parameter

      Deskripsi

      Service Name

      Nama layanan.

      Group Name

      Nama grup tempat layanan tersebut berada.

      Persistence

      Menentukan apakah layanan dan instansnya bersifat persisten.

      Protection Threshold

      Jika rasio instans sehat terhadap total instans untuk layanan ini turun di bawah ambang batas ini, sistem akan memicu perlindungan untuk mencegah gangguan sistem. Nilai yang valid: 0 hingga 1. Nilai default adalah 0.

      Untuk informasi selengkapnya, lihat Praktik terbaik untuk ketersediaan tinggi pusat registrasi dan konfigurasi MSE.

    Hapus layanan

    Catatan

    Aksi menghapus instans layanan hanya berlaku untuk instans layanan Persistence (instans non-ephemeral).

    1. Login ke Konsol MSE, lalu pilih wilayah di bilah navigasi atas.

    2. Di panel navigasi kiri, pilih Microservices Registry > Instances.

    3. Pada halaman Instances, klik nama instans.

    4. Di panel navigasi kiri, pilih Service Management > Services. Di pojok kiri atas halaman, pilih Namespace. Temukan layanan yang dituju, lalu di kolom Actions, klik More > Delete. Kemudian, klik OK pada kotak dialog konfirmasi.

    Lihat detail layanan

    1. Login ke Konsol MSE, lalu pilih wilayah di bilah navigasi atas.

    2. Di panel navigasi kiri, pilih Microservices Registry > Instances.

    3. Pada halaman Instances, klik nama instans.

    4. Di panel navigasi kiri, klik Service Management > Services, lalu pilih Namespace di pojok kiri atas halaman.

      Dalam namespace ini, Anda dapat melihat informasi semua layanan pada instans Nacos, seperti Service Name, Group Name, Number of providers, dan Number of Clusters.

      Anda dapat melakukan operasi berikut:

      • Untuk melihat detail layanan, klik nama layanan yang dituju.

        • Bagian atas halaman detail layanan menampilkan informasi dasar tentang layanan tersebut, seperti nama, grup, status persistensi, dan jumlah kluster.

        • Klik tab Provider untuk melihat semua instans penyedia layanan tersebut. Instans-instans ini dikelompokkan berdasarkan kluster. Secara default, penyedia dari kluster pertama yang ditampilkan.

          • Pada bagian All Clusters di sebelah kiri, klik nama kluster untuk beralih ke kluster tersebut.

          • Pada kolom Actions untuk instans yang dituju, Anda dapat mengedit bobot instans, mengaktifkan atau menonaktifkannya, menghapus instans, atau melihat metadata-nya.

        • Klik tab Subscriber untuk melihat semua instans klien yang berlangganan layanan saat ini. Daftar ini menampilkan alamat IP setiap subscriber (IP klien), Client Version (misalnya, Nacos-Java-Client:v1.4.1), dan Application Name.

        • Klik tab Push track untuk melihat informasi pelacakan dorong terperinci untuk layanan saat ini. Informasi ini mencakup waktu dorong, alamat IP klien, nama layanan, grup layanan, jumlah instans layanan, dan nama node.

      • Untuk menghapus layanan: Pada halaman Services, temukan layanan yang dituju, lalu di kolom Actions, klik Delete. Kemudian, klik OK pada kotak dialog konfirmasi.

        Penting

        • Anda hanya dapat menghapus layanan kosong. Jika layanan tidak kosong, tombol hapus akan dinonaktifkan (berwarna abu-abu).

        • Jika layanan tetap kosong selama lebih dari satu menit, Nacos akan menghapusnya secara otomatis.

    Pengambilan batch daftar layanan dan langganan

    Konsol MSE tidak mendukung ekspor daftar layanan atau hubungan langganan secara massal. Gunakan salah satu metode berikut untuk mendapatkan data ini.

    Lihat data di konsol

    1. Login ke Konsol MSE. Di panel navigasi kiri, pilih Registration and Configuration Center > Instance List.

    2. Klik nama instans Nacos yang dituju untuk membuka halaman detail instans.

    3. Di panel navigasi kiri, pilih Service Management > Service List untuk melihat daftar layanan yang terdaftar.

    4. Klik nama layanan untuk membuka halaman detail layanan, lalu klik tab Subscriber untuk melihat daftar klien yang berlangganan layanan tersebut.

    Ambil data dengan memanggil operasi OpenAPI

    • Panggil operasi ListAnsServices untuk mengambil daftar layanan. Operasi ini mendukung parameter PageNum dan PageSize untuk paginasi, sehingga Anda dapat mengambil semua layanan secara massal dengan memanggil operasi ini dalam loop. Anda harus menentukan salah satu dari InstanceId atau ClusterId.

    • Panggil operasi GetServiceListeners untuk mengambil daftar subscriber untuk layanan tertentu. Anda harus menentukan parameter ServiceName, GroupName, dan NamespaceId. Operasi ini mendukung paginasi.

    • Panggil operasi ListAnsInstances untuk mengambil detail instans layanan, termasuk alamat IP, port, nama kluster, status kesehatan, dan bobot setiap instans.

    Untuk informasi selengkapnya tentang parameter permintaan dan respons operasi ini, lihat topik referensi API yang ditautkan.

    Tambahkan instans ke layanan

    Anda dapat menambahkan instans baru (penyedia) ke layanan apa pun di Konsol untuk mendefinisikan instans terlebih dahulu atau untuk keperluan pengujian.

    1. Login ke Konsol MSE, lalu pilih wilayah di bilah navigasi atas.

    2. Di panel navigasi kiri, pilih Microservices Registry > Instances.

    3. Pada halaman Instances, klik nama instans.

    4. Di panel navigasi kiri, pilih Service Management > Services, lalu pilih Namespace di pojok kiri atas halaman.

    5. Klik nama layanan yang dituju untuk melihat detailnya.

    6. Klik tab Provider, lalu klik Create an instance. Pada kotak dialog Create an instance, konfigurasikan parameter, lalu klik OK.

      Parameter

      Deskripsi

      IP

      Alamat IP instans.

      Port Number

      Port instans.

      Cluster name

      Kluster tempat instans tersebut berada. Parameter ini menyediakan pemisahan logis untuk instans di Nacos. Nilai default adalah DEFAULT.

      Up and down line status

      Pilih status awal online atau offline untuk instans. Nilai default adalah Yes.

      Weight

      Bobot instans. Nilai yang valid: 0 hingga 10000. Nilai default adalah 1. Trafik didistribusikan berdasarkan bobot. Semakin tinggi bobot, semakin banyak trafik yang diarahkan ke instans tersebut.

      Jika bobot yang Anda atur tidak berlaku, lihat Cara memperbaiki masalah perubahan bobot instans yang tidak berlaku di Nacos.

    Aktifkan atau nonaktifkan instans

    Catatan

    Fitur ini beroperasi pada instans tertentu di Nacos.

    1. Login ke Konsol MSE, lalu pilih wilayah di bilah navigasi atas.

    2. Di panel navigasi kiri, pilih Microservices Registry > Instances.

    3. Pada halaman Instances, klik nama instans.

    4. Di panel navigasi kiri, pilih Service Management > Services, lalu pilih Namespace di pojok kiri atas halaman.

    5. Klik nama layanan yang dituju untuk melihat detailnya.

    6. Klik tab Provider. Temukan instans yang dituju, lalu klik On line atau Offline di kolom Actions. Pada kotak dialog konfirmasi, klik OK.

    Catatan

    Jika Anda memanggil API online segera setelah pendaftaran layanan dan instans tidak aktif seperti yang diharapkan, kemungkinan data belum selesai disinkronkan. Sebagai praktik terbaik, tunggu sekitar 10 detik setelah layanan berhasil terdaftar sebelum memanggil API online.

    FAQ

    Apakah MSE Nacos mendukung penyesuaian timeout heartbeat layanan dan kriteria offline?

    Tidak. Di MSE Registry (Nacos), timeout heartbeat layanan dan perilaku offline dikendalikan oleh parameter tetap di sisi server. Pengguna tidak dapat menyesuaikan durasi timeout atau jumlah heartbeat yang terlewat yang diperlukan untuk menonaktifkan instans.

    Mengapa MSE hanya memuat satu instans layanan Nacos?

    Konfigurasi sumber registrasi layanan tidak mencakup semua instans Nacos yang diperlukan. Untuk mengatasi masalah ini, buka konfigurasi sumber registrasi layanan di Konsol MSE dan tambahkan secara manual ID instans Nacos yang hilang (misalnya, mse-580c5140) untuk memastikan semua instans Nacos yang diperlukan termasuk dalam cakupan penemuan layanan.

    Bagaimana cara mengatasi error "publish nacos metadata failed"?

    Konten metadata penyedia Dubbo melebihi batas default Nacos. Parameter nacos.naming.metadata.max.total.length memiliki nilai default 4096 byte. Anda dapat menggunakan salah satu atau kedua metode berikut untuk mengatasi masalah ini:

    1. Optimalkan konten metadata agar tetap dalam batas 8 KB.

    2. Jika pengurangan metadata tidak memungkinkan karena kebutuhan bisnis, login ke Alibaba Cloud Quota Center, cari Microservice Engine MSE, temukan item kuota Maximum total length of Nacos service metadata (bytes), lalu ajukan permintaan peningkatan. Nilai maksimum yang didukung adalah 8192 byte. Setelah permintaan disetujui, kuota akan berlaku secara otomatis. Tidak diperlukan restart layanan.

    Bagaimana cara memecahkan masalah error 503 Service Temporarily Unavailable untuk layanan yang terdaftar melalui Python, Docker, atau teknologi serupa?

    Lakukan pemeriksaan berikut secara berurutan:

    1. Di Konsol Nacos, pastikan layanan telah terdaftar dan alamat IP instans benar.

    2. Verifikasi bahwa penyedia layanan dan konsumen (gateway) berada dalam namespace Nacos yang sama.

    3. Periksa konfigurasi pemeriksaan kesehatan. Jika autentikasi diaktifkan pada aplikasi Anda, titik akhir pemeriksaan kesehatan (misalnya, /health) mungkin mengembalikan 401 alih-alih 200, menyebabkan Nacos menandai instans sebagai tidak sehat dan menghentikan pengiriman trafik ke instans tersebut. Sesuaikan logika autentikasi Anda atau tentukan path pemeriksaan kesehatan yang benar.

    4. Verifikasi bahwa gateway dan instans backend dapat saling dijangkau melalui jaringan.

    5. Di Konsol MSE, lihat informasi Push track untuk layanan guna memastikan alamat IP instans yang benar telah dikirimkan ke konsumen.