Risolvere i problemi relativi a una sottoscrizione con Single Message Transform (SMT)

Questa pagina fornisce alcuni suggerimenti comuni per la risoluzione dei problemi relativi alle sottoscrizioni con le trasformazioni dei messaggi di Pub/Sub.

Monitorare le trasformazioni dei messaggi di Pub/Sub

Per comprendere il rendimento e l'impatto delle trasformazioni dei messaggi di Pub/Sub su una sottoscrizione, utilizza le seguenti metriche di monitoraggio:

La metrica subscription/message_transform_latencies misura il tempo necessario per applicare le trasformazioni dei messaggi di Pub/Sub a un messaggio. La metrica misura solo la latenza delle trasformazioni dei messaggi di Pub/Sub e non include altre parti del tempo di consegna dei messaggi.

La metrica fornisce due etichette chiave:

  • status: indica se la trasformazione è andata a buon fine o se si è verificato un problema.

  • filtered: indica se la trasformazione dei messaggi di Pub/Sub ha causato il filtraggio del messaggio. Quando una trasformazione dei messaggi di Pub/Sub filtra un messaggio in una sottoscrizione, Pub/Sub lo riconosce e il messaggio non viene mai inviato ai sottoscrittori. Questa etichetta filtered è vera solo quando una trasformazione dei messaggi di Pub/Sub esegue il filtraggio. I messaggi filtrati utilizzando le funzionalità di filtraggio integrate di Pub/Sub non vengono visualizzati in questa metrica specifica.

La metrica subscription/byte_cost viene utilizzata per identificare i messaggi filtrati dalle trasformazioni dei messaggi di Pub/Sub o in cui le trasformazioni dei messaggi di Pub/Sub non sono riuscite. Cerca questi valori specifici:

  • Quando una trasformazione dei messaggi di Pub/Sub filtra un messaggio, l'operation_type è smt_subscribe_filter_drop.

  • Se una trasformazione dei messaggi di Pub/Sub non riesce a trasformare un messaggio, viene visualizzato un response_code diverso da OK.

Si sta accumulando un backlog

Se noti un backlog di messaggi in aumento nella sottoscrizione, controlla la presenza di INVALID_ARGUMENT errori segnalati in subscription/message_transform_latencies.

Per risolvere gli errori INVALID_ARGUMENT, aggiungi un argomento messaggi non recapitabili alla sottoscrizione di interesse. L'argomento messaggi non recapitabili acquisisce i messaggi che non è stato possibile consegnare ai sottoscrittori, insieme a un attributo denominato CloudPubSubDeadLetterSourceSMTErrorMessage che spiega il motivo dell'errore.

Passaggi successivi

  • Se continui a riscontrare problemi con le trasformazioni dei messaggi di Pub/Sub della sottoscrizione, consulta la sezione Richiedere assistenza.