Fitur manajemen log Simple Message Queue (SMQ) mendorong log permintaan pesan ke Simple Log Service (SLS). Anda kemudian dapat menggunakan SLS untuk mengkueri dan menganalisis log permintaan guna memecahkan masalah produksi.
Kasus penggunaan
Masalah umum saat mengirim dan menerima pesan:
-
Pesan berhasil dikirim ke antrian, tetapi client konsumen tidak menerimanya. Ke mana perginya pesan tersebut?
-
Siapa yang mengonsumsi pesan tertentu? Berapa kali pesan tersebut dikonsumsi?
-
Client konsumen mengalami crash. Kapan pesan yang gagal dikonsumsi dapat dikonsumsi kembali?
-
Pesan dipublikasikan ke topik, tetapi titik akhir belum menerimanya setelah waktu yang lama. Apa penyebab keterlambatan tersebut?
Manajemen log di SMQ mengatasi masalah-masalah ini:
-
Dorong log ke SLS dan lihat jejak pesan lengkap di Konsol.
-
Gunakan alat kueri yang disediakan di situs web resmi. Anda dapat menentukan parameter untuk melihat log pemrosesan pesan.
Penagihan
-
SMQ tidak membebankan biaya tambahan untuk fitur manajemen log.
-
Saat SMQ mendorong log ke SLS, SLS menagih Anda berdasarkan ruang penyimpanan, lalu lintas, dan volume permintaan. Ikhtisar penagihan.
Format log antrian
Operasi pesan antrian (kirim, konsumsi, hapus) menghasilkan entri log. Bidang yang disertakan bervariasi tergantung pada jenis operasinya.
-
Bidang log
Entri log antrian dapat mencakup bidang-bidang berikut.
Field
Description
Time
Timestamp operasi.
MessageId
ID pesan unik.
QueueName
Nama antrian target.
AccountId
ID akun pemilik antrian.
RemoteAddress
Alamat IP client.
NextVisibleTime
Kapan pesan menjadi terlihat kembali.
ReceiptHandleInRequest
ReceiptHandleyang diberikan oleh client.ReceiptHandleInResponse
ReceiptHandleyang dikembalikan ke client.ProcessTime
Waktu pemrosesan operasi.
RequestId
ID permintaan.
Action
Aksi, seperti
DeleteMessageatauSendMessage. -
Bidang berdasarkan operasi
Tabel berikut menunjukkan bidang mana saja yang disertakan dalam setiap operasi.
Operation
Time
QueueName
AccountId
MessageId
RemoteAddress
NextVisibleTime
ReceiptHandleInResponse
ReceiptHandleInRequest
SendMessage/BatchSendMessage
Yes
Yes
Yes
Yes
Yes
Yes
No
No
PeekMessage/BatchPeekMessage
Yes
Yes
Yes
Yes
Yes
No
No
No
ReceiveMessage/BatchReceiveMessage
Yes
Yes
Yes
Yes
Yes
Yes
Yes
No
ChangeMessageVisibility
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
DeleteMessage/BatchDeleteMessage
Yes
Yes
Yes
Yes
Yes
Yes
No
Yes
Format log topik
Operasi pesan topik (publikasi dan dorong) menghasilkan entri log. Bidang yang disertakan bervariasi tergantung pada jenis operasinya.
-
Bidang log
Entri log topik dapat mencakup bidang-bidang berikut.
Field
Description
Time
Timestamp operasi.
MessageId
ID pesan unik.
TopicName
Nama topik target.
SubscriptionName
Nama langganan.
AccountId
ID akun pemilik topik.
RemoteAddress
Alamat IP client.
NotifyStatus
Kode status atau error dari titik akhir saat SMQ mendorong pesan.
ProcessTime
Waktu pemrosesan operasi.
MessageTag
Tag pesan.
RequestId
ID permintaan.
Action
Aksi, seperti
PublishMessageatauNotify. -
Bidang berdasarkan operasi
Tabel berikut menunjukkan bidang mana saja yang disertakan dalam setiap operasi.
Operation
Time
MessageId
TopicName
SubscriptionName
AccountId
RemoteAddress
NotifyStatus
MessageTag
PublishMessage
Yes
Yes
Yes
No
Yes
Yes
No
No
Notify
Yes
Yes
Yes
Yes
Yes
No
Yes
Yes
-
NotifyStatus
Bidang NotifyStatus dalam log dorong menunjukkan alasan kegagalan SMQ dalam mengirimkan pesan. Pecahkan masalah berdasarkan nilai-nilai berikut.
Error code
Description
Recommended action
2xx
Pesan berhasil didorong.
Tidak ada.
Other HTTP status codes
Titik akhir mengembalikan kode status non-2xx.
Periksa logika pemrosesan di titik akhir Anda.
InvalidHost
Titik akhir langganan tidak valid.
Verifikasi bahwa titik akhir langganan valid dan dapat diakses dengan
curlatautelnet.ConnectTimeout
Koneksi ke titik akhir langganan mengalami timeout.
Verifikasi bahwa titik akhir langganan dapat diakses dengan
curlatautelnet.ConnectFailure
Koneksi ke titik akhir langganan gagal.
Verifikasi bahwa titik akhir langganan dapat diakses dengan
curlatautelnet.UnknownError
Terjadi error yang tidak diketahui.
Hubungi dukungan teknis SMQ.
Operasi log
Sebelum menggunakan manajemen log, pastikan hal-hal berikut:
-
Buat antrian dan topik di SMQ. Manage queues. Manage topics.
-
Buat project dan Logstore di SLS. Manage a Project. Create a Logstore.
Log operasi layanan SMQ hanya dapat didorong ke Project SLS di wilayah yang sama.
-
Otorisasi SMQ untuk mengekspor log dengan peran RAM
AliyunMNSLoggingRole.Klik Cloud Resource Access Authorization dan ikuti petunjuk di layar untuk menyelesaikan otorisasi.
PeringatanJangan mencabut otorisasi atau menghapus peran RAM tersebut. Jika tidak, log SMQ tidak dapat didorong ke SLS.
Aktifkan atau nonaktifkan logging
Aktifkan atau nonaktifkan logging antrian
-
Di panel navigasi sebelah kiri, klik Queues.
-
Di bilah menu atas, pilih wilayah.
-
Di halaman Queues, temukan antrian target. Di kolom Actions, pilih
> Edit. -
Di panel Edit Queue Parameters, aktifkan atau nonaktifkan sakelar Enable Logging.
Di halaman Queues, kolom Logging untuk antrian target menampilkan Enabled atau Disabled.
Aktifkan atau nonaktifkan logging topik
Dorong log ke SLS
Lihat log
Masuk ke Konsol Simple Log Service.
Di bagian Projects, klik project yang diinginkan.
-
Di tab Log Storage > Logstores, klik Logstore target.
-
Masukkan pernyataan kueri dan klik Last 15 Minutes untuk mengatur rentang waktu. Quick start for search and analysis.
Contoh analisis log
Kueri jejak pesan antrian
Untuk melacak pesan antrian, kueri berdasarkan nama antrian dan ID pesan: $QueueName and $MessageId. Contoh: log and EED287A265726135146E6A9CADC8XXXX.
Hasilnya menunjukkan siklus hidup pesan dari pengiriman hingga penerimaan.
Kueri jejak pesan topik
Untuk melacak pesan topik, kueri berdasarkan nama topik dan ID pesan: $TopicName and $MessageId. Contoh: logtest and 8798453B65727FC6433E6AB4F746XXXX.
Hasilnya menunjukkan siklus hidup pesan dari publikasi hingga notifikasi.
Kueri pesan antrian yang dikirim
Untuk mengkueri pesan yang dikirim ke antrian, gunakan nama antrian dan operasi kirim: $QueueName and (SendMessage or BatchSendMessage). Contoh: log and (SendMessage or BatchSendMessage).
Hasil berikut menunjukkan bahwa produsen mengirim tiga pesan ke antrian log dalam rentang waktu yang ditentukan.
Kueri pesan topik yang dipublikasikan
Untuk mengkueri pesan yang dipublikasikan ke topik, gunakan nama topik dan operasi publikasi: $TopicName and PublishMessage. Contoh: logtest and PublishMessage.
Hasil kueri berikut menunjukkan bahwa tiga pesan dipublikasikan oleh produsen ke topik logtest dalam rentang waktu yang ditentukan.
Kueri pesan antrian yang dikonsumsi
Untuk mengkueri pesan yang dikonsumsi dari antrian, gunakan nama antrian dan operasi konsumsi: $QueueName and (ReceiveMessage or BatchReceiveMessage). Contoh: log and (ReceiveMessage or BatchReceiveMessage).
Hasil kueri berikut menunjukkan bahwa 12 pesan dikonsumsi dari antrian log dalam rentang waktu yang ditentukan.
Kueri pesan antrian yang dihapus
Untuk mengkueri pesan yang dihapus dari antrian, gunakan nama antrian dan operasi hapus: $QueueName and (DeleteMessage or BatchDeleteMessage). Contoh: log and (DeleteMessage or BatchDeleteMessage).
Hasil kueri berikut menunjukkan bahwa 61 pesan dihapus dari antrian log dalam rentang waktu yang ditentukan.
Kueri pesan berdasarkan client
Untuk mengkueri pesan yang diproses oleh client tertentu, gunakan alamat IP client: $ClientIP. Contoh: 10.10.10.0.
Untuk memfilter berdasarkan jenis operasi, gabungkan kata kunci. Contoh: $ClientIP and (SendMessage or BatchSendMessage).
Hasil kueri berikut menunjukkan bahwa client memproses 66 pesan dalam rentang waktu yang ditentukan.