全部产品
Search
文档中心

ApsaraMQ for RocketMQ:Solusi analisis penelusuran ujung-ke-ujung

更新时间:Jul 06, 2025

Dalam sistem aplikasi terdistribusi, interaksi antar layanan melibatkan jaringan komunikasi dan transmisi data yang kompleks. Untuk memproses permintaan, layanan internal dalam sistem harus saling berkomunikasi. Jika terjadi pengecualian selama proses ini, tugas di layanan eksternal mungkin gagal dieksekusi atau mengalami timeout, sehingga pemecahan masalah menjadi sulit. Fitur analisis penelusuran mencatat proses transmisi permintaan ketika layanan berinteraksi satu sama lain dalam sistem. Fitur ini juga menyediakan log rinci dan data kinerja. ApsaraMQ for RocketMQ memungkinkan Anda mengintegrasikan data jejak yang sesuai dengan spesifikasi OpenTelemetry ke layanan analisis penelusuran Alibaba Cloud untuk membantu mendiagnosis dan menyelesaikan pengecualian.

Apa itu jejak?

Data jejak ApsaraMQ for RocketMQ memenuhi konvensi semantik untuk rentang pesan yang didefinisikan dalam spesifikasi OpenTelemetry. Untuk informasi lebih lanjut, lihat Konvensi Semantik Jejak.

Apa itu rentang pesan?

Rentang pesan mendefinisikan hubungan topologi antara berbagai jenis rentang, termasuk hubungan induk-anak dan hubungan tautan antara rentang pengiriman, penerimaan, dan pemrosesan. Untuk informasi lebih lanjut, lihat Konvensi Semantik untuk Rentang Pesan.

Tabel berikut menjelaskan jenis rentang yang terlibat dalam ApsaraMQ for RocketMQ.

rentang

Deskripsi

kirim

Pesan dikirim dari produser ke konsumen. Rentang jenis ini dimulai ketika pesan mulai dikirim dan berakhir ketika pesan terkirim, pesan gagal dikirim, atau pengecualian dilemparkan.

Jika pesan dicoba ulang selama pengiriman pesan, beberapa rentang dicatat.

terima

Proses polling panjang saat pesan diterima oleh konsumen. Siklus hidup rentang jenis ini sesuai dengan siklus hidup polling panjang.

Secara default, rentang penerimaan dinonaktifkan. Untuk mengaktifkan rentang penerimaan, Anda harus menambahkan parameter -Dotel.instrumentation.messaging.experimental.receive-telemetry.enabled ke runtime dan mengatur parameter tersebut ke true.

proses

Proses saat pesan diproses oleh operasi MessageListener yang dipanggil oleh konsumen push. Rentang jenis ini dimulai ketika operasi MessageListener mulai memproses pesan dan berakhir ketika operasi MessageListener selesai memproses pesan.

Gambar berikut menjelaskan hubungan antara jenis rentang yang disebutkan di atas.

span关系

  • Jika rentang penerimaan dinonaktifkan, rentang proses merupakan anak dari rentang pengiriman.

  • Jika rentang penerimaan diaktifkan, rentang proses merupakan anak dari rentang penerimaan dan ditautkan ke rentang pengiriman.

Apa itu atribut pesan?

Atribut umum yang terkandung dalam rentang pesan dijelaskan dalam konvensi semantik untuk rentang pesan. Berikut adalah atribut tersebut:

  • messaging.message.id: ID pesan. Ini adalah pengenal unik pesan.

  • messaging.destination: tujuan ke mana pesan dikirim. Dalam banyak kasus, tujuan adalah antrian atau topik.

  • messaging.operation: jenis operasi yang dilakukan pada pesan, seperti kirim, terima, dan akui.

Untuk informasi tentang atribut lainnya, lihat Atribut Apache RocketMQ.

Produk pesan yang berbeda memiliki perilaku dan atribut yang berbeda. Tabel berikut menjelaskan atribut unik dari ApsaraMQ for RocketMQ.

Atribut

Tipe nilai

Deskripsi

messaging.rocketmq.client_group

string

Grup penyeimbangan beban konsumen.

messaging.rocketmq.client_id

string

ID klien. ID ini adalah pengenal unik klien.

messaging.rocketmq.message.delivery_timestamp

int

Waktu yang dijadwalkan untuk mengirim pesan terjadwal.

messaging.rocketmq.message.group

string

Grup tempat pesan terurut milik.

messaging.rocketmq.message.type

string

Tipe pesan. Nilai valid:

messaging.rocketmq.message.tag

string

Tag yang digunakan untuk menyaring pesan. Konsumen dapat menyaring pesan berdasarkan tag. Dengan cara ini, konsumen hanya dapat menerima pesan yang berisi tag tertentu.

messaging.rocketmq.message.keys

string[]

Kunci pesan. Anda dapat mengonfigurasi kunci yang berbeda untuk pesan yang berbeda. Ini membantu Anda menemukan pesan yang ingin Anda kelola dengan cepat.

Batasan

  • Hanya klien yang menggunakan SDK untuk Java yang dapat melaporkan data jejak ke layanan analisis penelusuran. Untuk informasi tentang catatan rilis SDK untuk Java, lihat Deskripsi Versi.

  • ApsaraMQ for RocketMQ hanya melacak data produksi terkait pesan transaksional.

  • ApsaraMQ for RocketMQ hanya melacak data pesan yang dikonsumsi oleh konsumen push. Untuk informasi lebih lanjut, lihat Tipe Konsumen.

Solusi integrasi data jejak yang disediakan oleh ApsaraMQ for RocketMQ

Untuk menerapkan analisis penelusuran, ApsaraMQ for RocketMQ pertama-tama melaporkan data jejak yang sesuai dengan spesifikasi OpenTelemetry ke server analisis penelusuran. Kemudian, server mengumpulkan dan menampilkan data jejak.

Anda dapat membangun server analisis penelusuran sendiri atau menggunakan layanan analisis penelusuran yang disediakan oleh Alibaba Cloud sebagai server analisis penelusuran. ApsaraMQ for RocketMQ memungkinkan Anda mengintegrasikan data jejak ke Layanan Log Sederhana Alibaba Cloud dan Application Real-Time Monitoring Service (ARMS). Untuk informasi lebih lanjut, lihat Catatan Penggunaan dan Apa Itu Managed Service for OpenTelemetry?

Integrasi data jejak ke Layanan Log Sederhana

Integrasi data jejak ke ARMS

Untuk informasi tentang cara mengintegrasikan data jejak ApsaraMQ for RocketMQ ke ARMS, lihat Panduan Integrasi OpenTelemetry.