Turn on Syslogging

From truxwiki.com
Jump to navigation Jump to search

Using syslog can be wonderful when debugging.

Syslog.Server

You can use the Syslog.Server tool to be the syslog server on your local host.

Display to Console

The following command line will start the syslog tool listening on port 514 and displaying incoming messages to the console.

"C:\Program Files\Truxton\Tools\Syslog.Server.exe"

Log to a File

This command file will log any messages displayed on the console to the filename you specify.

"C:\Program Files\Truxton\Tools\Syslog.Server.exe" C:\Temp\Truxton.Syslog.txt

Entire ETL Layer

To turn syslogging on for the ETL processes:

  1. Stop the Truxton service.
    net stop truxton
    
  2. Edit the C:\ProgramData\Truxton\Settings\TruxtonSettings.xml
  3. Add the following lines fields:
    <truxton_options>
      <syslog>localhost</syslog>
      <syslogport>514</syslogport>
    </truxton_options>
    
  4. Start the Syslog.server management tool. You can specify a log file on the command line if you wish.
    Syslog.server c:\temp\log.txt
    
  5. Restart the Truxton service.
    net start truxton
    

Just My ETL

If you wish to log messages from just your ETL, you can add the syslog arguments to your ETL's section of TruxtonService.xml

<etl>
  <description>This ETL will decode Kryptos.</description>
  <exe controllable="yes" instances="1" queue="dekrypt">DeKrypt</exe>
  <arguments>--syslog localhost --syslogport 514</arguments>
</etl>