qpid-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From gmur...@apache.org
Subject [qpid-dispatch] branch master updated: DISPATCH-1346 - Create prioritized message delivery section in routing chapter. This closes #513
Date Tue, 02 Jul 2019 01:03:02 GMT
This is an automated email from the ASF dual-hosted git repository.

gmurthy pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/qpid-dispatch.git


The following commit(s) were added to refs/heads/master by this push:
     new bd4e52f  DISPATCH-1346 - Create prioritized message delivery section in routing chapter.
This closes #513
bd4e52f is described below

commit bd4e52f616b5e53056c0e296aa096ae660e7af70
Author: Ben Hardesty <bhardest@redhat.com>
AuthorDate: Tue May 28 18:10:29 2019 -0400

    DISPATCH-1346 - Create prioritized message delivery section in routing chapter. This closes
#513
---
 docs/books/user-guide/routing.adoc | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/docs/books/user-guide/routing.adoc b/docs/books/user-guide/routing.adoc
index 4bee9ed..b3e926e 100644
--- a/docs/books/user-guide/routing.adoc
+++ b/docs/books/user-guide/routing.adoc
@@ -321,6 +321,40 @@ If a producer sends an unsettled delivery, the disposition may be ACCEPTED
or RE
 
 |===
 
+[id='prioritized-message-delivery']
+=== Configuring Addresses for Prioritized Message Delivery
+
+You can set the priority level of an address to control how {RouterName} processes messages
sent to that address. Within the scope of a connection, {RouterName} attempts to process messages
based on their priority. For a connection with a large volume of messages in flight, this
lowers the latency for higher-priority messages.
+
+Assigning a high priority level to an address does not guarantee that messages sent to the
address will be delivered before messages sent to lower-priority addresses. However, higher-priority
messages will travel more quickly through the router network than they otherwise would.
+
+[NOTE]
+====
+You can also control the priority level of individual messages by setting the priority level
in the message header. However, the address priority takes precedence: if you send a prioritized
message to an address with a different priority level, the router will use the address priority
level.
+====
+
+.Procedure
+
+* In the router's configuration file, add or edit an address and assign a priority level.
++
+--
+This example adds an address with the highest priority level. The router will attempt to
deliver messages sent to this address before messages with lower priority levels.
+
+[options="nowrap",subs="+quotes"]
+----
+address {
+    prefix: my-high-priority-address
+    priority: 9
+    ...
+}
+----
+`priority`:: The priority level to assign to all messages sent to this address. The range
of valid priority levels is 0-9, in which the higher the number, the higher the priority.
The default is 4.
+--
+
+.Additional resources
+
+* For more information about setting the priority level in a message, see the {AmqpSpecLink}.
+
 [id='routing-messages-between-clients']
 === Routing Messages Between Clients
 


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org


Mime
View raw message