imtuxedoulog : Tuxedo ULOG input module

Module summary

This module is created to consume Tuxedo ULOG file. This file has the following characteristics :

  • the file name is compose of a prefix and the date of the file.
  • the lines of logs are produced by call to userlog() tuxedo method.
  • Tuxedo server based on JAVA writes java's exceptions as log lines in ULOG file. This version of the module ignores those lines.
  • The ECID (Execution Context ID) is extracted and placed as a structured data named ECID.

Why this module instead of using imfile

As the file name is a rotation base of the current date, imfile must use a glob to manage this rotation. Imfile must use fs notify implement of the OS. This interface is implemented in imfile for Linux and Solaris but not AIX.

Like imfile does, this module is using the same rsyslog core stream and then gets advantages its evolves.

Primary we tried to integrating in imfile a "glob like" in polling mode, it increased the module complexity and make it unmaintainable.

So imfile could not be a valid candidate on none fs notification OS like AIX.

Ulog log samples

This are different case of logs in the ULOG file according to the usage.

Case 1: second fraction precision = 2

105211.70.sic-in2-tmsl1!IMSproxiCSFI4EC.26607818.1.0: TSAM_CAT:305:4563628752 ; I ;TPSUCCESS service
          ^host         ^prog               lprog>    ^text

Case 2: second fraction precision = 3

011458.705.sic-tst-tmsl1!LMS.5243392.772.3: TSAM_CAT:305: WARN: (23498) times logon TSAM Plus manager
           ^host        ^prog     lprog>    ^text

Case 3: with ECID

105211.704.sic-in2-tmsl1!IMSproxiCSFI4EC.26607818.1.0: ECID <000003GBORvD4iopwSXBiW01xG2M00001n>: 4563628752
           ^host         ^prog               lprog>          ^ecid                                ^text

Case 4: with gtrid & ECID

164313.151.sic-tst-tmsm1!ARTIMPP_UDB.42722.1.0: gtrid x0 ... a0f: ECID <000001833^5pVl3iY00f003UF^>: TRACE:at
           ^host         ^prog        lprog>                            ^ecid                        ^text