jbyrne-redhat commented on a change in 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]
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
