[
https://issues.apache.org/jira/browse/DISPATCH-1350?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16855492#comment-16855492
]
ASF GitHub Bot commented on DISPATCH-1350:
------------------------------------------
jbyrne-redhat commented on pull request #517: DISPATCH-1350 - Update logging
and management doc
URL: https://github.com/apache/qpid-dispatch/pull/517#discussion_r290203778
##########
File path: docs/books/user-guide/managing-using-qdmanage.adoc
##########
@@ -53,30 +53,62 @@ For example, the following command executes a query
operation on a router, and t
$ qdmanage query --type listener
[
{
- "stripAnnotations": "both",
- "addr": "127.0.0.1",
- "multiTenant": false,
- "requireSsl": false,
- "idleTimeoutSeconds": 16,
- "saslMechanisms": "ANONYMOUS",
- "maxFrameSize": 16384,
- "requireEncryption": false,
- "host": "0.0.0.0",
- "cost": 1,
- "role": "normal",
- "http": false,
- "maxSessions": 32768,
- "authenticatePeer": false,
- "type": "org.apache.qpid.dispatch.listener",
- "port": "amqp",
- "identity": "listener/0.0.0.0:amqp",
+ "stripAnnotations": "both",
+ "addr": "127.0.0.1",
+ "multiTenant": false,
+ "requireSsl": false,
+ "idleTimeoutSeconds": 16,
+ "saslMechanisms": "ANONYMOUS",
+ "maxFrameSize": 16384,
+ "requireEncryption": false,
+ "host": "0.0.0.0",
+ "cost": 1,
+ "role": "normal",
+ "http": false,
+ "maxSessions": 32768,
+ "authenticatePeer": false,
+ "type": "org.apache.qpid.dispatch.listener",
+ "port": "amqp",
+ "identity": "listener/0.0.0.0:amqp",
"name": "listener/0.0.0.0:amqp"
}
]
----
For more information about `qdmanage`, see the {qdmanageManPageLink}.
+== Closing a connection
+
+If a consumer is processing messages too slowly, or has stopped processing
messages without settling their deliveries, you can close the connection. By
closing the connection, the "stuck" deliveries will be released, and they can
be redelivered to a different consumer.
+
+.Procedure
+
+. Find the ID of the connection with the slow consumer.
++
+--
+This command lists the connections for a router in the router network:
+
+[options="nowrap"]
+----
+$ qdstat -c -r Router.A
+Connections
+id host container role
dir security authentication tenant
+==================================================================================================================================
+ 2 127.0.0.1:5672
route-container out no-security anonymous-user
+ 10 127.0.0.1:5001 Router.B
inter-router out no-security anonymous-user
+ 12 localhost.localdomain:42972 161211fe-ba9e-4726-9996-52d6962d1276
normal in no-security anonymous-user
+ 14 localhost.localdomain:42980 a35fcc78-63d9-4bed-b57c-053969c38fda
normal in no-security anonymous-user
+ 15 localhost.localdomain:42982 0a03aa5b-7c45-4500-8b38-db81d01ce651
normal in no-security anonymous-user
+----
+--
+
+. Close the connection by setting its `adminStatus` to `deleted`.
++
+[options="nowrap"]
+----
+$ qdmanage update --type=connection --id=12 adminStatus=deleted
Review comment:
This might be obvious to Interconnect users (in which case, disregard it),
but it wasn't to me:
What information in the previous output indicated that connection ID=12 had
a slow consumer?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
> Update logging/monitoring documentation
> ---------------------------------------
>
> Key: DISPATCH-1350
> URL: https://issues.apache.org/jira/browse/DISPATCH-1350
> Project: Qpid Dispatch
> Issue Type: Improvement
> Components: Documentation
> Reporter: Ben Hardesty
> Priority: Major
>
> In the Dispatch Router user guide, the logging documentation should be
> enhanced to demonstrate the improvements made in DISPATCH-1289.
> In addition, management control for closing a connection should be documented.
>
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
