Résoudre les problèmes liés à un abonnement avec des transformations de message unique

Cette page fournit des conseils de dépannage courants pour les abonnements avec des SMT.

Surveiller les SMT

Pour comprendre les performances et l'impact des SMT sur un abonnement, utilisez les métriques de surveillance suivantes:

La métrique subscription/message_transform_latencies mesure le temps nécessaire pour que les SMT soient appliqués à un message. La métrique ne mesure que la latence SMT et n'inclut pas d'autres parties du délai de diffusion du message.

La métrique fournit deux libellés clés:

  • status: indique si la transformation a réussi ou si elle a rencontré un problème.

  • filtered: indique si le SMT a entraîné le filtrage du message. Lorsqu'un SMT filtre un message sur un abonnement, Pub/Sub en accuse réception et le message n'est jamais envoyé aux abonnés. Ce libellé filtered n'est vrai que lorsqu'un SMT effectue le filtrage. Les messages filtrés à l'aide des fonctionnalités de filtrage intégrées de Pub/Sub ne sont pas reflétés dans cette métrique spécifique.

La métrique subscription/byte_cost permet d'identifier les messages filtrés par les SMT ou pour lesquels les SMT ont échoué. Recherchez les valeurs suivantes:

  • Lorsqu'un SMT filtre un message, le type d'opération est smt_subscribe_filter_drop.

  • Si un SMT ne parvient pas à transformer un message, un response_code autre que OK s'affiche.

Un arriéré se forme

Si un arriéré de messages s'accumule dans l'abonnement, recherchez les erreurs INVALID_ARGUMENT signalées dans subscription/message_transform_latencies.

Pour résoudre les erreurs INVALID_ARGUMENT, ajoutez un sujet de lettres mortes à l'abonnement concerné. Le sujet des lettres mortes enregistre les messages qui n'ont pas pu être distribués aux abonnés, ainsi qu'un attribut appelé CloudPubSubDeadLetterSourceSMTErrorMessage qui explique la raison de l'échec.

Étape suivante