Bagikan melalui

Menggunakan Bus Layanan Explorer untuk menjalankan operasi data pada Bus Layanan

Azure Service Bus memungkinkan aplikasi klien pengirim dan penerima untuk memisahkan logika bisnis mereka dengan menggunakan semantik point-to-point (Antrean) dan publish-subscribe (Topik-Langganan).

Catatan

Artikel ini menyoroti fungsionalitas Azure Service Bus Explorer yang merupakab bagian di portal Microsoft Azure.

Service Bus Explorer sumber terbuka yang dimiliki komunitas adalah aplikasi yang berdiri sendiri dan berbeda dari yang ini.

Operasi yang dilakukan pada namespace Azure Service Bus terdiri dari dua jenis.

  • Operasi Manajemen - Pembuatan, pembaruan, dan penghapusan namespace, antrean, topik, dan langganan di Service Bus.
  • Operasi Data - Kirim ke dan Terima Pesan dari Antrean, Topik, dan Langganan.

Penting

  • Bus Layanan Explorer tidak mendukung operasi manajemen dan sesi.
  • Kami menyarankan untuk tidak menggunakan Bus Layanan Explorer untuk pesan yang lebih besar, karena dapat mengakibatkan waktu habis, tergantung pada ukuran pesan, latensi jaringan antara klien dan layanan Bus Layanan dll. Sebagai gantinya, kami sarankan Anda menggunakan klien Anda sendiri untuk bekerja dengan pesan yang lebih besar, di mana Anda dapat menentukan nilai batas waktu Anda sendiri.
  • Jika namespace Service Bus Anda hanya dapat diakses melalui titik akhir privat, Anda harus menjalankan browser web pada host di jaringan virtual yang memiliki titik akhir privat, dan juga memastikan bahwa tidak ada gateway keamanan jaringan (NSG) yang menghalangi.
  • Jika pengguna hanya memiliki akses ke entitas dan bukan namespace layanan, Service Bus Explorer mungkin tidak berfungsi seperti yang diharapkan dalam skenario yang melibatkan migrasi ke tingkat premium atau pemulihan bencana metadata.

Prasyarat

Untuk menggunakan alat Service Bus Explorer, Anda perlu melakukan tugas berikut:

Menggunakan Service Bus Explorer

Untuk menggunakan Service Bus Explorer, navigasikan ke namespace Service Bus tempat Anda ingin melakukan operasi data.

  1. Jika Anda ingin melakukan operasi pada antrean, pilih Queues dari menu navigasi. Jika Anda ingin menjalankan operasi terhadap topik (dan langganan terkait), pilih Topik.

    Cuplikan layar navigasi sisi kiri, tempat entitas dapat dipilih.

  2. Setelah memilih Antrean atau Topik, pilih antrean atau topik tertentu.

    Cuplikan layar halaman Antrean dengan antrean tertentu dipilih.

  3. Pilih Service Bus Explorer dari menu navigasi kiri

    Cuplikan layar halaman antrian di mana Service Bus Explorer dapat dipilih.

    Catatan

    Saat mengintip atau menerima dari langganan, pertama-tama pilih Langganan tertentu dari menu pilih dropdown. Cuplikan layar dropdown untuk langganan topik.

    Catatan

    Saat Anda menavigasi ke explorer Layanan Bus untuk entitas di namespace yang memiliki akses publik dinonaktifkan, Anda akan melihat pesan berikut meskipun Anda mengaksesnya dari mesin virtual yang berada di jaringan virtual yang sama dengan endpoint privat. Anda dapat mengabaikannya.

    Namespace memiliki akses jaringan publik dinonaktifkan. Operasi data seperti Intip, Kirim, atau Terima terhadap entitas Bus Layanan ini tidak berfungsi sampai Anda beralih ke semua jaringan atau mengizinkan IP klien Anda dalam daftar jaringan yang dipilih.

Mengintip pesan

Dengan fungsionalitas intip, Anda dapat menggunakan Service Bus Explorer untuk melihat 100 pesan teratas dalam antrean, langganan, atau antrean pesan gagal.

  1. Untuk mengintip pesan, pilih Mode Peek di tarik-turun Service Bus Explorer.

    Cuplikan layar dropdown dengan Mode Intip dipilih.

  2. Periksa metrik untuk melihat apakah ada Pesan Aktif atau Pesan yang Dimasukkan ke Dead-letter untuk mengintip dan pilih Antrean / Langganan atau sub-antrean Dead-letter.

    Cuplikan layar tab antrean dan subantre antrian mati dengan metrik pesan yang ditampilkan.

  3. Pilih tombol Intip dari awal.

    Cuplikan layar yang menunjukkan tombol Intip dari awal.

  4. Setelah operasi intip selesai, hingga 100 pesan muncul di kisi seperti yang ditunjukkan pada gambar berikut. Untuk melihat detail dari pesan tertentu, pilih pesan tersebut dari grid. Anda dapat memilih untuk melihat isi atau properti pesan.

    Cuplikan layar dengan gambaran umum pesan yang diintip dan konten isi pesan yang ditampilkan untuk pesan yang diintip.

    Beralih ke tab Properti Pesan di panel bawah untuk melihat metadata.

    Cuplikan layar dengan gambaran umum pesan yang diintip dan properti pesan yang ditampilkan untuk pesan yang diintip.

    Catatan

    Karena mengintip bukan operasi yang merusak, pesan tidak akan dihapus dari entitas.

    Catatan

    Untuk alasan performa, saat mengintip pesan dari antrean atau langganan yang memiliki ukuran pesan maksimum yang diatur lebih dari 1 MB, isi pesan tidak diambil secara default. Sebagai gantinya, Anda dapat memuat isi pesan untuk pesan tertentu dengan mengklik tombol Muat isi pesan. Jika isi pesan lebih dari 1 MB, isi pesan tidak dipotong sebelum ditampilkan. Cuplikan layar dengan gambaran umum pesan dan tombol yang diintip untuk memuat isi pesan yang ditampilkan.

Mengintip pesan dengan opsi tingkat lanjut

Fungsi mengintip dengan opsi memungkinkan Anda menggunakan Service Bus Explorer untuk melihat pesan teratas dalam antrean, langganan, atau antrean surat mati, menentukan jumlah pesan yang akan diintip, dan nomor urut untuk memulai operasi mengintip.

  1. Untuk mengintip pesan dengan opsi tingkat lanjut, pilih Mode Intip di menu dropdown Service Bus Explorer.

    Cuplikan layar dropdown dengan Mode Intip dipilih untuk melihat dengan opsi lanjutan.

  2. Periksa metrik untuk melihat apakah ada Pesan Aktif atau Pesan yang Dimasukkan ke Dead-letter untuk mengintip dan pilih Antrean / Langganan atau sub-antrean Dead-letter.

    Cuplikan layar tab antrian dan sub-antrian surat mati dengan metrik pesan ditampilkan untuk melihat sekilas dengan opsi tingkat lanjut.

  3. Pilih tombol Intip dengan opsi. Berikan jumlah pesan yang akan diintip, dan nomor urut untuk mulai mengintip, dan pilih tombol Intip.

    Cuplikan layar yang menunjukkan tombol Intip dengan opsi, dan halaman tempat opsi dapat diatur.

  4. Setelah operasi intip selesai, pesan muncul di kisi seperti yang ditunjukkan pada gambar berikut. Untuk melihat detail dari pesan tertentu, pilih pesan tersebut dari grid. Anda dapat memilih untuk melihat isi atau properti pesan.

    Cuplikan layar dengan gambaran umum pesan yang diintip dan konten isi pesan yang ditampilkan untuk mengintip dengan opsi tingkat lanjut.

    Beralih ke tab Properti Pesan di panel bawah untuk melihat metadata.

    Cuplikan layar dengan gambaran umum pesan yang diintip dan properti pesan yang ditampilkan untuk mengintip dengan opsi tingkat lanjut.

    Catatan

    Karena mengintip bukan operasi destruktif, pesan tidak akan dihapus dari antrean.

Menerima pesan

Fungsi terima pada Service Bus Explorer mengizinkan penerimaan pesan dari antrean atau langganan.

  1. Untuk menerima pesan, pilih Mode Terima di menu dropdown Service Bus Explorer.

    Cuplikan layar dropdown dengan Mode Terima dipilih.

  2. Periksa metrik untuk melihat apakah ada Pesan Aktif atau Pesan Dead-letter untuk diterima, dan pilih Antrian / Langganan atau DeadLetter.

    Cuplikan layar tab antrean dan sub-antrean dead-letter dengan metrik pesan ditampilkan untuk mode terima.

  3. Pilih tombol Terima pesan , dan tentukan mode terima, jumlah pesan yang akan diterima, dan waktu maksimum untuk menunggu pesan dan pilih Terima.

    Cuplikan layar yang menunjukkan tombol Terima, dan halaman tempat opsi dapat diatur.

    Penting

    Mode ReceiveAndDelete adalah penerimaan destruktif, yaitu, pesan dihapus dari antrean saat ditampilkan di alat Service Bus Explorer.

    Untuk meramban pesan tanpa menghapusnya dari antrean, pertimbangkan untuk menggunakan fungsi Mengintip, atau menggunakan mode terima PeekLock.

  4. Setelah operasi terima selesai, pesan muncul di kisi seperti yang ditunjukkan pada gambar berikut. Untuk melihat detail pesan tertentu, pilih pesan tersebut di dalam kisi.

    Cuplikan layar dengan gambaran umum pesan yang diterima dan konten isi pesan ditampilkan.

    Cuplikan layar dengan gambaran umum pesan yang diterima dan properti pesan ditampilkan.

    Catatan

    Untuk alasan performa, saat menerima pesan dari antrean atau langganan yang memiliki ukuran pesan maksimum yang diatur lebih dari 1 MB, hanya satu pesan yang diterima pada satu waktu. Jika isi pesan lebih dari 1 MB, isi pesan dipotong sebelum ditampilkan.

Setelah pesan diterima dalam mode PeekLock , ada berbagai tindakan yang dapat Anda lakukan padanya.

Catatan

Anda hanya dapat melakukan tindakan ini selama Anda memiliki kunci pada pesan.

Menyelesaikan pesan

  1. Di daftar, pilih pesan yang diterima yang ingin Anda selesaikan.

  2. Pilih tombol Selesai.

    Cuplikan layar yang menunjukkan tombol Selesai.

    Penting

    Menyelesaikan pesan adalah terima destruktif, yaitu, pesan dihapus dari antrian ketika Selesai telah dipilih di alat Service Bus Explorer.

Tangguhkan pesan

  1. Di kisi, pilih satu atau beberapa pesan yang diterima yang ingin Anda tangguhkan.

  2. Pilih tombol Tunda.

    Cuplikan layar yang menunjukkan tombol Tunda.

Abaikan kunci

  1. Di dalam daftar, pilih satu atau beberapa pesan yang diterima yang ingin Anda lepaskan kuncinya.

  2. Pilih tombol Abaikan kunci.

    Cuplikan layar yang menunjukkan tombol Abaikan Kunci.

Setelah kunci ditinggalkan, pesan tersedia untuk operasi penerimaan lagi.

Surat mati

  1. Pada grid, pilih satu atau beberapa pesan yang diterima yang ingin dead-letter.

  2. Pilih tombol Dead-letter.

    Cuplikan layar yang menunjukkan tombol Dead-letter.

Setelah pesan dimasukkan ke dalam dead-letter, pesan tersebut tersedia dari sub-antrean Dead-letter.

Hapus semua pesan

Untuk menghapus pesan, pilih tombol Bersihkan pesan di Explorer Bus Layanan.

Cuplikan layar yang menunjukkan tombol hapus menyeluruh pesan.

Setelah Anda memasukkan 'purge' untuk mengonfirmasi operasi, pesan akan dihapus dari entitas bus layanan masing-masing.

Kirim pesan ke antrian atau topik

Untuk mengirim pesan ke antrian atau topik, pilih tombol Kirim pesan pada Service Bus Explorer.

  1. Pilih Jenis Konten menjadi Teks/Polos, Aplikasi/Xml, atau Aplikasi/Json.

  2. Untuk Isi pesan, tambahkan konten pesan. Pastikan sesuai dengan set Jenis Konten sebelumnya.

  3. Atur Properti Broker (opsional). Properti ini termasuk ID Korelasi, ID Pesan, ReplyTo, Label/Subjek, Time to Live (TTL) dan Waktu Antrean Terjadwal (untuk Pesan Terjadwal).

  4. Atur Properti Kustom (opsional). Properti ini dapat berupa properti pengguna apa pun yang diatur terhadap kunci kamus.

  5. Centang Ulangi kirim untuk mengirim pesan yang sama beberapa kali. Jika tidak ada ID Pesan yang diatur, ID pesan secara otomatis diisi dengan nilai berurutan.

  6. Setelah pesan dibuat, pilih tombol Kirim .

    Cuplikan layar memperlihatkan pengalaman membuat pesan.

  7. Ketika operasi pengiriman berhasil diselesaikan, salah satu perubahan berikut terjadi:

    • Jika mengirim ke antrean, penghitung metrik Pesan Aktif akan dinaikkan.
    • Jika mengirim ke topik, penghitung metrik Active Messages akan dinaikkan pada langganan di mana pesan dirutekan.

Mengirim ulang pesan

Setelah mengintip atau menerima pesan, Anda dapat mengirim ulang pesan, yang mengirim salinan pesan ke entitas yang sama, sambil memungkinkan kami memperbarui konten dan propertinya. Data asli tetap ada dan tidak dihapus bahkan ketika pengiriman ulang berasal dari antrean pesan yang gagal.

  1. Pada tampilan grid, pilih satu atau beberapa pesan yang ingin Anda kirim ulang.

  2. Pilih tombol Kirim ulang pesan yang dipilih.

    Cuplikan layar yang menunjukkan tombol Kirim ulang pesan yang dipilih.

  3. Secara opsional, pilih pesan apa pun yang ingin Anda perbarui detailnya dan buat perubahan yang diinginkan.

  4. Pilih tombol Kirim untuk mengirim pesan ke entitas.

    Cuplikan layar memperlihatkan pengalaman mengirim ulang pesan.

    Catatan

    • Operasi pengiriman ulang mengirimkan salinan pesan asli. Ini tidak menghapus pesan asli yang Anda kirim ulang.
    • Jika Anda mengirim ulang pesan dalam antrian pesan gagal dari langganan, salinan pesan tersebut dikirim ke topik. Oleh karena itu, semua langganan menerima salinan pesan.

Ganti jenis autentikasi

Saat bekerja dengan Service Bus Explorer, Anda dapat menggunakan autentikasi dengan Kunci Akses atau Microsoft Entra ID.

  1. Pilih tombol Pengaturan.

    Cuplikan layar yang menunjukkan tombol Pengaturan di Bus Layanan Explorer.

  2. Pilih metode autentikasi yang diinginkan, dan pilih tombol Simpan.

    Cuplikan layar yang menunjukkan tombol Pengaturan dan halaman yang memperlihatkan berbagai jenis autentikasi.

Langkah berikutnya