Visão geral das filas de mensagens mortas do Barramento de Serviço

As filas e as assinaturas de tópico do Barramento de Serviço do Azure fornecem uma subfila secundária chamada DLQ (fila de mensagens mortas). A fila de mensagens mortas não precisa ser explicitamente criada e não pode ser excluída ou gerenciada independentemente da entidade principal.

Este artigo descreve as filas de mensagens mortas no Barramento de Serviço. Grande parte da discussão é ilustrada pelo exemplo de Filas de mensagens mortas no GitHub.

A fila de mensagens mortas

A finalidade da fila de mensagens mortas é manter mensagens que não podem ser entregues a nenhum receptor ou mensagens que não puderam ser processadas. As mensagens podem ser removidas da DLQ e inspecionadas. Um aplicativo pode permitir que um usuário corrija os problemas e reenvie a mensagem.

De uma perspectiva de API e protocolo, a DLQ é bem semelhante a qualquer outra fila, com exceção de que essas mensagens podem ser enviadas apenas por meio da operação de mensagens mortas da entidade pai. Além disso, a vida útil não é observada, e você não pode colocar uma mensagem em estado morto na DLQ. A fila de mensagens mortas (DLQ) dá suporte total às operações normais, como entrega com peek-lock, recebimento e exclusão e operações transacionais.

Não há limpeza automática da DLQ. As mensagens permanecem na DLQ até você recuperá-las de lá explicitamente e concluir a mensagem morta.

Caminho para a fila de mensagens mortas

É possível acessar a fila de mensagens mortas usando a seguinte sintaxe:

<queue path>/$deadletterqueue
<topic path>/Subscriptions/<subscription path>/$deadletterqueue

No .NET, você pode usar o método FormatDeadLetterPath.

QueueClient.FormatDeadLetterPath(queuePath)
SubscriptionClient.FormatDeadLetterPath(topicPath, subscriptionName)

Contagem de mensagens da DLQ

A obtenção do número de mensagens na fila de mensagens mortas no nível do tópico não se aplica porque as mensagens não ficam no nível do tópico. Em vez disso, quando um remetente envia uma mensagem a um tópico, a mensagem é encaminhada para as assinaturas do tópico em milissegundos e, portanto, não reside mais no nível do tópico. Portanto, você pode ver mensagens na DLQ associada à assinatura do tópico. No exemplo a seguir, Service Bus Explorer mostra que atualmente há 62 mensagens em DLQ para a assinatura "test1".

Você também pode obter a contagem de mensagens DLQ usando o comando da CLI do Azure: az servicebus topic subscription show.

Movendo mensagens para a DLQ

Há várias atividades no Barramento de Serviço que fazem com que as mensagens sejam enviadas por push à DLQ de dentro do próprio mecanismo de mensagens. Um aplicativo também pode explicitamente colocar mensagens na DLQ. As duas propriedades a seguir (motivo de mensagens mortas e descrição de mensagens mortas) são adicionadas às mensagens mortas. Os aplicativos podem definir seus próprios códigos para a propriedade motivo de mensagens mortas, mas o sistema define os valores seguintes.

Motivo da mensagem morta	Descrição de erro da mensagem morta
HeaderSizeExceeded	A cota de tamanho para esse fluxo excedeu o limite.
TTLExpiredException	A mensagem expirou e foi colocada no estado de mensagem morta. Consulte a seção Vida útil para obter detalhes.
Session ID is null.	A entidade habilitada para sessão não permite uma mensagem cuja identificação de sessão seja nula.
MaxTransferHopCountExceeded	O número máximo de saltos permitidos para encaminhamentos entre filas de espera foi excedido. Esse valor é definido como 4.
MaxDeliveryCountExceeded	A mensagem não pôde ser consumida após as tentativas de entrega máximas. Consulte a seção Contagem de entrega máxima para obter detalhes.

Vida útil

Quando você habilita a mensagem morta em filas ou assinaturas, todas as mensagens que estão expirando são movidas para o DLQ. O código do motivo da mensagem morta é definido como: TTLExpiredException. As mensagens adiadas não serão limpas e movidas para a fila de mensagens mortas após expirarem. Este comportamento ocorre por design.

Contagem máxima de entregas

Há um limite para o número de tentativas de entrega de mensagens para filas e assinaturas do Barramento de Serviço. O valor padrão é 10. Sempre que uma mensagem for entregue com peek-lock, mas tiver sido explicitamente abandonada ou seu bloqueio tiver expirado, o número de entregas da mensagem aumentará. Quando a contagem da entrega excede o limite, a mensagem é movida para o DLQ. O motivo das mensagens mortas para a mensagem no DLQ é definido como: MaxDeliveryCountExceeded. Esse comportamento não pode ser desabilitado, mas você pode definir a contagem de entrega máxima para um número alto.

Erros ao processar as regras de assinatura

Se você habilitar as mensagens mortas em exceções da avaliação de filtro, todos os erros que ocorrerem durante a execução de uma regra de filtro SQL de uma assinatura serão capturados no DLQ junto a mensagem incorreta. Não use essa opção em um ambiente de produção no qual você tenha tipos de mensagem que são enviados para o tópico e que não têm assinantes, já que isso pode resultar em uma grande carga de mensagens na DLQ. Por esse motivo, certifique-se de que todas as mensagens enviadas para o tópico tenham pelo menos uma assinatura correspondente.

Mensagens mortas no nível de aplicativo

Além dos recursos de mensagens mortas fornecidas pelo sistema, os aplicativos podem usar a DLQ para rejeitar explicitamente mensagens inaceitáveis. Elas podem incluir mensagens que não puderam ser processadas adequadamente devido a qualquer tipo de problema no sistema, mensagens que mantêm cargas malformadas ou mensagens que falham na autenticação quando algum esquema de segurança no nível de mensagem é usado.

No .NET, isso pode ser feito chamando o método ServiceBusReceiver.DeadLetterMessageAsync.

Recomendamos que você inclua o tipo da exceção no DeadLetterReason e o rastreamento de pilha da exceção no DeadLetterDescription, pois isso facilita a solução de problemas, resultando em mensagens mortas. Lembre-se de que, como resultado, algumas mensagens poderão exceder o limite de cota de 256 KB para o Nível Padrão do Barramento de Serviço do Azure. Você pode fazer o upgrade do namespace do Barramento de Serviço do nível padrão para o nível premium para ter cotas e limites mais altos.

Mensagens mortas em cenários de encaminhamento automático

Mensagens são enviadas para a fila de mensagens mortas sob as seguintes condições:

• Uma mensagem que passe por mais de quatro filas ou tópicos encadeados.
• A fila ou o tópico de destino é desabilitado ou excluído.
• O tópico ou a fila de destino excede o tamanho máximo de entidade.

Mensagens mortas em envio por meio de cenários

• Se a fila de espera ou o tópico de destino estiverem desabilitados, a mensagem será enviada para uma fila de transferência de mensagens mortas (TDLQ) da fila de espera original.
• Se a fila ou entidade de destino exceder o tamanho da entidade, a mensagem será enviada para um TDLQ da fila de origem.

Enviar mensagens mortas para serem reprocessadas

Após resolver o problema que fez com que a mensagem fosse colocada na fila de mensagens mortas, você poderá reenviar a mensagem para a fila de espera ou o tópico a serem reprocessados.

Ferramentas como o Azure Service Bus Explorer permitem a movimentação manual de mensagens entre filas e tópicos. Se houver muitas mensagens na fila de mensagens mortas que precisem ser movidas, um código como este poderá ajudar a mover todas elas de uma vez só. Os operadores costumam preferir ter uma interface do usuário de solução de problemas para informar quais tipos de mensagens apresentaram falha de processamento, de quais filas de espera eram provenientes e as razões de terem falhado e, ao mesmo tempo, continuarem podendo reenviar lotes de mensagens para serem reprocessados. Ferramentas como o ServicePulse com NServiceBus oferecem essas funcionalidades.

Conteúdo relacionado

Consulte Habilitar mensagens mortas para uma fila ou assinatura para saber mais sobre as maneiras diferentes de configurar as mensagens mortas sobre a expiração de mensagens.