Debian Codegraph @

contrib/imtuxedoulog/README.md

raw
1 # imtuxedoulog : Tuxedo ULOG input module
2
3 ### Module summary
4
5 This module is created to consume Tuxedo ULOG file.
6 This file has the following characteristics :
7 - the file name is compose of a prefix and the date of the file.
8 - the lines of logs are produced by call to userlog() tuxedo method.
9 - Tuxedo server based on JAVA writes java's exceptions as log lines in
10 ULOG file. This version of the module ignores those lines.
11 - The ECID (Execution Context ID) is extracted and placed as a structured
12 data named ECID.
13
14 ### Why this module instead of using imfile
15
16 As the file name is a rotation base of the current date, imfile must use
17 a glob to manage this rotation. Imfile must use fs notify implement of the
18 OS. This interface is implemented in imfile for Linux and Solaris but not
19 AIX.
20
21 Like imfile does, this module is using the same rsyslog core stream and
22 then gets advantages its evolves.
23
24 Primary we tried to integrating in imfile a "glob like" in polling mode,
25 it increased the module complexity and make it unmaintainable.
26
27 So imfile could not be a valid candidate on none fs notification OS like AIX.
28
29 ### Ulog log samples
30
31 This are different case of logs in the ULOG file according to the usage.
32
33 Case 1: second fraction precision = 2
34 ```
35 105211.70.sic-in2-tmsl1!IMSproxiCSFI4EC.26607818.1.0: TSAM_CAT:305:4563628752 ; I ;TPSUCCESS service
36 ^host ^prog lprog> ^text
37 ```
38
39 Case 2: second fraction precision = 3
40 ```
41 011458.705.sic-tst-tmsl1!LMS.5243392.772.3: TSAM_CAT:305: WARN: (23498) times logon TSAM Plus manager
42 ^host ^prog lprog> ^text
43 ```
44
45 Case 3: with ECID
46 ```
47 105211.704.sic-in2-tmsl1!IMSproxiCSFI4EC.26607818.1.0: ECID <000003GBORvD4iopwSXBiW01xG2M00001n>: 4563628752
48 ^host ^prog lprog> ^ecid ^text
49 ```
50
51 Case 4: with gtrid & ECID
52 ```
53 164313.151.sic-tst-tmsm1!ARTIMPP_UDB.42722.1.0: gtrid x0 ... a0f: ECID <000001833^5pVl3iY00f003UF^>: TRACE:at
54 ^host ^prog lprog> ^ecid ^text
55 ```