[
https://issues.apache.org/jira/browse/DISPATCH-1350?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16855483#comment-16855483
]
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_r290198211
##########
File path: docs/books/user-guide/logging.adoc
##########
@@ -37,28 +37,22 @@ The default module. This module applies defaults to all of
the other logging mod
This module provides information and statistics about the local router. This
includes how the router connects to other routers in the network, and
information about the remote destinations that are directly reachable from the
router (link routes, waypoints, autolinks, and so on).
-In this example, on `Router.A`, the `ROUTER` log shows that `Router.B` is the
next hop. It also shows the cost for `Router.A` to reach the other routers on
the network:
+.Using the `ROUTER` log to trace connections and links
+====
+In this example, `ROUTER` logs show the lifecycle of a connection and a link
that is associated with it.
[options="nowrap"]
----
-Tue Jun 7 13:28:27 2016 ROUTER (trace) Node Router.C next hop set: Router.B
-Tue Jun 7 13:28:27 2016 ROUTER (trace) Node Router.C valid origins: []
-Tue Jun 7 13:28:27 2016 ROUTER (trace) Node Router.C cost: 2
-Tue Jun 7 13:28:27 2016 ROUTER (trace) Node Router.B valid origins: []
-Tue Jun 7 13:28:27 2016 ROUTER (trace) Node Router.B cost: 1
-----
-
-On `Router.B`, the `ROUTER` log provides more information about valid origins:
-
-[options="nowrap"]
-----
-Tue Jun 7 13:28:25 2016 ROUTER (trace) Node Router.C cost: 1
-Tue Jun 7 13:28:26 2016 ROUTER (trace) Node Router.A created: maskbit=2
-Tue Jun 7 13:28:26 2016 ROUTER (trace) Node Router.A link set: link_id=1
-Tue Jun 7 13:28:26 2016 ROUTER (trace) Node Router.A valid origins:
['Router.C']
-Tue Jun 7 13:28:26 2016 ROUTER (trace) Node Router.A cost: 1
-Tue Jun 7 13:28:27 2016 ROUTER (trace) Node Router.C valid origins:
['Router.A']
+2019-04-05 14:54:38.037248 -0400 ROUTER (info) [C1] Connection Opened: dir=in
host=127.0.0.1:55440 vhost= encrypted=no auth=no user=anonymous
container_id=95e55424-6c0a-4a5c-8848-65a3ea5cc25a props= // <1>
+2019-04-05 14:54:38.038137 -0400 ROUTER (info) [C1][L6] Link attached: dir=in
source={<none> expire:sess} target={$management expire:sess} // <2>
+2019-04-05 14:54:38.041103 -0400 ROUTER (info) [C1][L6] Link lost: del=1
presett=0 psdrop=0 acc=1 rej=0 rel=0 mod=0 delay1=0 delay10=0 // <3>
+2019-04-05 14:54:38.041154 -0400 ROUTER (info) [C1] Connection Closed // <4>
----
+<1> The connection is opened. Each connection is identified with a unique ID
(`C1`). The log also shows some information about the connection.
+<2> A link is attached over the connection. The link is identified with a
unique ID (`L1`). The log also shows the direction of the link, and the source
and target addresses.
Review comment:
Is the link ID L6?
----------------------------------------------------------------
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]
