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

Cette page fournit quelques conseils de dépannage courants pour les abonnements avec des transformations de messages côté serveur.

Surveiller les transformations de messages côté serveur

Pour comprendre les performances et l'impact des transformations de messages côté serveur sur un abonnement, utilisez les métriques de surveillance suivantes :

La métrique subscription/message_transform_latencies mesure le temps nécessaire pour appliquer les transformations de messages côté serveur à un message. La métrique ne mesure que la latence des transformations de messages côté serveur et n'inclut pas d'autres parties du délai de remise des messages.

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 la transformation de messages côté serveur a entraîné le filtrage du message. Lorsqu'une transformation de messages côté serveur 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'une transformation de messages côté serveur 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 transformations de messages côté serveur ou pour lesquels les transformations de messages côté serveur ont échoué. Recherchez ces valeurs spécifiques :

  • Lorsqu'une transformation de messages côté serveur filtre un message, le type d'opération est smt_subscribe_filter_drop.

  • Si une transformation de messages côté serveur ne parvient pas à transformer un message, un response_code autre que OK s'affiche.

Une accumulation de messages se produit

Si vous constatez une accumulation de messages dans l'abonnement, recherchez les INVALID_ARGUMENT erreurs 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 de lettres mortes capture 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

  • Si vous rencontrez toujours des problèmes avec les transformations de messages côté serveur de votre abonnement, consultez la page Obtenir de l'aide.