Memecahkan masalah subscription dengan Single Message Transforms (SMT)
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini memberikan beberapa tips pemecahan masalah umum untuk langganan dengan SMT.
Memantau SMT
Untuk memahami performa dan dampak SMT pada langganan,
gunakan metrik pemantauan berikut:
Metrik subscription/message_transform_latencies mengukur berapa lama waktu yang diperlukan untuk menerapkan SMT ke pesan. Metrik ini hanya mengukur latensi SMT dan tidak menyertakan bagian lain dari waktu pengiriman pesan.
Metrik ini memberikan dua label utama:
status: melaporkan apakah transformasi berhasil atau mengalami
masalah.
filtered: menunjukkan apakah SMT menyebabkan pesan difilter.
Saat SMT memfilter pesan pada langganan, Pub/Sub akan mengonfirmasinya, dan pesan tersebut tidak pernah dikirim ke pelanggan. Label
filtered ini hanya benar jika SMT melakukan pemfilteran. Pesan yang difilter menggunakan kemampuan pemfilteran bawaan Pub/Sub tidak tercermin dalam metrik khusus ini.
Metrik subscription/byte_cost
digunakan untuk mengidentifikasi pesan yang difilter oleh SMT atau saat SMT
gagal. Cari nilai spesifik berikut:
Saat SMT memfilter pesan, operation_type adalah smt_subscribe_filter_drop.
Jika SMT gagal mengubah pesan, Anda akan melihat response_code yang bukan OK.
Untuk memecahkan masalah error INVALID_ARGUMENT, tambahkan
topik surat mati ke
langganan minat. Topik dead letter menangkap pesan yang tidak dapat dikirim ke pelanggan, beserta atribut yang disebut CloudPubSubDeadLetterSourceSMTErrorMessage yang menjelaskan alasan kegagalan.
Langkah berikutnya
Jika Anda masih mengalami masalah dengan SMT langganan, lihat
Mendapatkan dukungan.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-17 UTC."],[],[],null,["# Troubleshooting a subscription with Single Message Transforms (SMTs)\n\nThis page provides some common troubleshooting tips for [subscriptions with SMTs](/pubsub/docs/smts/create-subscription-smt).\n\nMonitor SMTs\n------------\n\nTo understand the performance and impact of SMTs on a subscription,\nuse the following monitoring metrics:\n\nThe [subscription/message_transform_latencies](/monitoring/api/metrics_gcp_p_z#pubsub/subscription/message_transform_latencies)\nmetric measures how long it takes for SMTs to be applied to a message. The\nmetric measures only the SMT latency and does not include other parts of the\nmessage delivery time.\n\nThe metric provides two key labels:\n\n- `status`: reports whether the transformation is successful or encountered\n an issue.\n\n- `filtered`: indicates if the SMT caused the message to be filtered out.\n When an SMT filters a message on a subscription, Pub/Sub\n acknowledges it, and the message is never sent to subscribers. This\n `filtered` label is true only when an SMT performs the filtering. Messages\n filtered using Pub/Sub's [built-in filtering capabilities](/pubsub/docs/subscription-message-filter)\n are not reflected in this specific metric.\n\nThe [subscription/byte_cost](/monitoring/api/metrics_gcp_p_z#pubsub/subscription/byte_cost) metric\nis used to identify messages that are filtered by SMTs or where SMTs\nfailed. Look for these specific values:\n\n- When an SMT filters a message, the operation_type is `smt_subscribe_filter_drop`.\n\n- If an SMT fails to transform a message, you see a `response_code` that is not `OK`.\n\nA backlog is building up\n------------------------\n\nIf you see a backlog of messages building up in the subscription check for\n`INVALID_ARGUMENT` errors reported in\n[`subscription/message_transform_latencies`](/monitoring/api/metrics_gcp_p_z#pubsub/subscription/message_transform_latencies).\n\nTo troubleshoot `INVALID_ARGUMENT` errors, add a\n[dead-letter topic](/pubsub/docs/handling-failures#dead_letter_topic) to the\nsubscription of interest. The dead letter topic captures messages that couldn't\nbe delivered to subscribers, along with an attribute called\n`CloudPubSubDeadLetterSourceSMTErrorMessage` that explains the failure reason.\n\nWhat's next\n-----------\n\n- If you still have issues with your subscription SMTs, see [Getting support](/pubsub/docs/getting-support)."]]