Fehlerbehebung bei einem Abo mit Single Message Transforms (SMTs)
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite finden Sie einige allgemeine Tipps zur Fehlerbehebung für Abos mit SMTs.
SMTs überwachen
Mit den folgenden Monitoring-Messwerten können Sie die Leistung und Auswirkungen von SMTs auf ein Abo nachvollziehen:
Mit dem Messwert subscription/message_transform_latencies wird gemessen, wie lange es dauert, bis SMTs auf eine Nachricht angewendet werden. Der Messwert umfasst nur die SMT-Latenz und keine anderen Teile der Nachrichtenübermittlungszeit.
Der Messwert enthält zwei wichtige Labels:
status: Gibt an, ob die Transformation erfolgreich war oder ein Problem aufgetreten ist.
filtered: Gibt an, ob die Nachricht aufgrund des SMT herausgefiltert wurde.
Wenn ein SMT eine Nachricht für ein Abo herausfiltert, wird dies von Pub/Sub bestätigt und die Nachricht wird nie an Abonnenten gesendet. Dieses filtered-Label ist nur dann wahr, wenn die Filterung von einem SMT durchgeführt wird. Nachrichten, die mithilfe der integrierten Filterfunktionen von Pub/Sub gefiltert werden, werden in diesem Messwert nicht berücksichtigt.
Mit dem Messwert subscription/byte_cost werden Nachrichten identifiziert, die von SMTs gefiltert werden oder bei denen SMTs fehlgeschlagen sind. Achten Sie auf folgende Werte:
Wenn eine Nachricht von einem SMT gefiltert wird, ist der operation_type smt_subscribe_filter_drop.
Wenn eine SMT eine Nachricht nicht transformiert, wird eine response_code angezeigt, die nicht OK ist.
Wenn Sie INVALID_ARGUMENT-Fehler beheben möchten, fügen Sie dem betreffenden Abo ein Thema für unzustellbare Nachrichten hinzu. Das Thema für unzustellbare Nachrichten erfasst Nachrichten, die nicht an Abonnenten zugestellt werden konnten, zusammen mit dem Attribut CloudPubSubDeadLetterSourceSMTErrorMessage, das den Grund für den Fehler erklärt.
Nächste Schritte
Wenn weiterhin Probleme mit Ihren Abo-SMTs auftreten, lesen Sie den Hilfeartikel Support erhalten.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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)."]]
