| 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 |
``` |