Tools » History » Version 1

J. Moringen, 07/03/2011 12:57 PM
initial version

1 1 J. Moringen
h1. Tools
2 1 J. Moringen
3 1 J. Moringen
{{>toc}}
4 1 J. Moringen
5 1 J. Moringen
h2. Introspection
6 1 J. Moringen
7 1 J. Moringen
h3. Logger
8 1 J. Moringen
9 1 J. Moringen
The RSB logger participates in a [[Glossary|channel]] using one or more [[Glossary|transports]] and displays all [[Events|events]] published on the channel using a configurable style.
10 1 J. Moringen
11 1 J. Moringen
|_.Implementation Language |_.Project      |_.Repository Link          |
12 1 J. Moringen
| C++                      | rsb-cpp-tools | source:trunk/cpp/tools    |
13 1 J. Moringen
| Common Lisp              | cl-rsb-tools  | source:trunk/cl-rsb-tools |
14 1 J. Moringen
15 1 J. Moringen
_Example:_
16 1 J. Moringen
In the following example, the C++ version of the logger is instructed to participate in the channel designated by the root scope @/@. This means that the logger will display *all* events which are receivable using its configured transports. In this example, the configured transports depend on the RSB [[Configuration|configuration file]] and environment variables.
17 1 J. Moringen
<pre>
18 1 J. Moringen
[jmoringe@azurit logger]$ ./rsblogger --format detailed /
19 1 J. Moringen
Event
20 1 J. Moringen
  Scope  /
21 1 J. Moringen
  Id     ac5f449c-4aa1-4b03-a9e2-3fac7d38e651
22 1 J. Moringen
  Type   bytearray
23 1 J. Moringen
  Origin ab6e3a17-e11f-4c89-8c07-606a009e8439
24 1 J. Moringen
Timestamps
25 1 J. Moringen
  Create  2011-Jul-03 12:51:11.802849+??:??
26 1 J. Moringen
  Send    2011-Jul-03 12:51:11.802950+??:??
27 1 J. Moringen
  Receive 2011-Jul-03 12:51:11.810332+??:??
28 1 J. Moringen
  Deliver 2011-Jul-03 12:51:11.810572+??:??
29 1 J. Moringen
Payload (bytearray, length 100000)
30 1 J. Moringen
  0x0000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
31 1 J. Moringen
  0x0017 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
32 1 J. Moringen
  0x002e 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
33 1 J. Moringen
  0x0045 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ...
34 1 J. Moringen
-------------------------------------------------------------------------------
35 1 J. Moringen
Event
36 1 J. Moringen
  Scope  /
37 1 J. Moringen
  Id     3fd721ef-6e7c-4e81-bd5f-ff215b2b965f
38 1 J. Moringen
  Type   std::string
39 1 J. Moringen
  Origin 8e07e02a-0dee-44a2-8926-cc65c0285410
40 1 J. Moringen
Timestamps
41 1 J. Moringen
  Create  2011-Jul-03 12:51:20.102403+??:??
42 1 J. Moringen
  Send    2011-Jul-03 12:51:20.102482+??:??
43 1 J. Moringen
  Receive 2011-Jul-03 12:51:20.105319+??:??
44 1 J. Moringen
  Deliver 2011-Jul-03 12:51:20.105404+??:??
45 1 J. Moringen
Payload (std::string, length 3)
46 1 J. Moringen
  foo
47 1 J. Moringen
-------------------------------------------------------------------------------
48 1 J. Moringen
</pre>
49 1 J. Moringen
50 1 J. Moringen
h2. System-level and Debugging Tools
51 1 J. Moringen
52 1 J. Moringen
h3. Spread Sniffer
53 1 J. Moringen
54 1 J. Moringen
The Spread sniffer tool allows debugging low-level communication when the Spread transport is used. It displays raw payloads of Spread messages and, if possible, the corresponding decoded @Notification@ objects.
55 1 J. Moringen
56 1 J. Moringen
_Example:_
57 1 J. Moringen
<pre>
58 1 J. Moringen
[jmoringe@azurit build]$ ./spread-sniffer
59 1 J. Moringen
0000 12 10 73 F4 31 91 9D C2 48 C4 9C A9 92 33 03 ED 2A AB 32 05 2F 66 6F 6F 2F 
60 1 J. Moringen
0019 3A 0C 75 74 66 2D 38 2D 73 74 72 69 6E 67 4A 03 62 61 72 58 01 60 00 7A 24 
61 1 J. Moringen
0032 0A 10 62 AB 33 5F 9A F7 4A FE B2 D1 86 7B 81 3D 60 26 10 95 99 B0 85 FF E4 
62 1 J. Moringen
004B A9 02 18 CB 99 B0 85 FF E4 A9 02 
63 1 J. Moringen
#<NOTIFICATION {10046DFF41}>
64 1 J. Moringen
  Version       : 31 2E 30 ("1.0")
65 1 J. Moringen
  Id            : 73 F4 31 91 9D C2 48 C4 9C A9 92 33 03 ED 2A AB 
66 1 J. Moringen
  Scope         : 2F 66 6F 6F 2F ("/foo/")
67 1 J. Moringen
  Wire-Schema   : 75 74 66 2D 38 2D 73 74 72 69 6E 67 ("utf-8-string")
68 1 J. Moringen
  Data          : 62 61 72 ("bar")
69 1 J. Moringen
  Meta-Data     : #<META-DATA {10047D8681}>
70 1 J. Moringen
                    Sender-Id   : 62 AB 33 5F 9A F7 4A FE B2 D1 86 7B 81 3D 60 26 
71 1 J. Moringen
                    Create-Time : 1309689890213013
72 1 J. Moringen
                    Send-Time   : 1309689890213067
73 1 J. Moringen
                    Receive-Time: 0
74 1 J. Moringen
                    Deliver-Time: 0
75 1 J. Moringen
                    User-Times  : <empty sequence>
76 1 J. Moringen
                    User-Infos  : <empty sequence>
77 1 J. Moringen
  Num-Data-Parts: 1
78 1 J. Moringen
  Data-Part     : 0
79 1 J. Moringen
  Method        : <empty sequence>
80 1 J. Moringen
</pre>