Skip to main content

Service Bus Queues from Windows Azure - Death letter and poison messages

I will continue the series of posts about Service Bus Queues. In this post we will talk about death letter. First of all, this concept is common to Service Bus and is not specific only to Service Bus Queues.
We should imagine death letter as an internal queue in our queue where all the messages that cannot be processes are added. This kind of messages is called death messages. For example what is happening in the following situation with the message that is abandoned:
BrokeredMessage message = qc.Receive();
if (messsage !=null)
catch(Exception ex)
We will have a message that hangs on the queue and will be consumers over and over again without success. In this case we would need a method to mark the message as invalid. One solution is to invalidate the message and write this to a log. In this case even if the message is invalid we call the Complete() method. Be very careful when you call the Abandon() method. The message will be available in the queue again – it is very easy to create in this way messages that hang on the queue and cannot be processes.
Other option is to mark the message as “Differ”. In this case we will remain in the queue but we will be able to access it only by the message ID. This is not a valid case for our discussion.
Another solution is to mark the message as a poison message. A message marks as poison will be putted as a death letter.
message. DeadLetter()
message. DeadLetter(“…”,”…”)
In this way we mark the message as dead letter. The message is moved to death letter queue.
This sub-queue can be consumed by any other system or consumer and check the messages, log them and so on. The only thing that is not possible to do with it is to add the message to the original queue. To be an able to do this we will need to create a new BrokeredMessage with the same content. As a hint, the name of the sub-queue is [queueName]/$ DeadLetterQueue.
To be able to consume messages from this sub-queue we need to get the name of death letter queue. This can be very easy obtained using the FormatDeadLetterPath method of the QueueClient. After this step we obtained a normal QueueClient that can be used as we know it.
QueueClient deadletterQC = factory.CreateQueueClient(deadLetterQueuePath);
var message = deadletterQC.Receive();
We are not the only one that can put the messages in death letter queue. Windows Azure can mark a message from the queue as death when:
  • Message expired (TTL)
  • The maxim delivery count for a message is exceed
In this post we saw when is good to use death letter messages from Service Bus Queues. This type of messages can help us to decrease the complexity of our project. For example it is very simple to write a consumer that try for 3 times to process a message and if the action is without success to throw the message in the death letter queue.


Popular posts from this blog

ADO.NET provider with invariant name 'System.Data.SqlClient' could not be loaded

Today blog post will be started with the following error when running DB tests on the CI machine:
threw exception: System.InvalidOperationException: The Entity Framework provider type 'System.Data.Entity.SqlServer.SqlProviderServices, EntityFramework.SqlServer' registered in the application config file for the ADO.NET provider with invariant name 'System.Data.SqlClient' could not be loaded. Make sure that the assembly-qualified name is used and that the assembly is available to the running application. See for more information. at System.Data.Entity.Infrastructure.DependencyResolution.ProviderServicesFactory.GetInstance(String providerTypeName, String providerInvariantName) This error happened only on the Continuous Integration machine. On the devs machines, everything has fine. The classic problem – on my machine it’s working. The CI has the following configuration:

TeamCity.NET 4.51EF 6.0.2VS2013
It seems that there …

Entity Framework (EF) TransactionScope vs Database.BeginTransaction

In today blog post we will talk a little about a new feature that is available on EF6+ related to Transactions.
Until now, when we had to use transaction we used ‘TransactionScope’. It works great and I would say that is something that is now in our blood.
using (var scope = new TransactionScope(TransactionScopeOption.Required)) { using (SqlConnection conn = new SqlConnection("...")) { conn.Open(); SqlCommand sqlCommand = new SqlCommand(); sqlCommand.Connection = conn; sqlCommand.CommandText = ... sqlCommand.ExecuteNonQuery(); ... } scope.Complete(); } Starting with EF6.0 we have a new way to work with transactions. The new approach is based on Database.BeginTransaction(), Database.Rollback(), Database.Commit(). Yes, no more TransactionScope.
In the followi…

GET call of REST API that contains '/'-slash character in the value of a parameter

Let’s assume that we have the following scenario: I have a public HTTP endpoint and I need to post some content using GET command. One of the parameters contains special characters like “\” and “/”. If the endpoint is an ApiController than you may have problems if you encode the parameter using the http encoder.
using (var httpClient = new HttpClient()) { httpClient.BaseAddress = baseUrl; Task<HttpResponseMessage> response = httpClient.GetAsync(string.Format("api/foo/{0}", "qwert/qwerqwer"))); response.Wait(); response.Result.EnsureSuccessStatusCode(); } One possible solution would be to encode the query parameter using UrlTokenEncode method of HttpServerUtility class and GetBytes method ofUTF8. In this way you would get the array of bytes of the parameter and encode them as a url token.
The following code show to you how you could write the encode and decode methods.