Try TT Now

TTM Network Administration

Manually Configuring TTM Logging for Log Files

TTM Log File

By default, TTM creates and saves its log file into the directory <root drive>:ttLogfiles and names it ttmd_yyyy-mm-dd.log, where yyyy is the four digit year, mm is the two-digit month, and dd is the two-digit day. When Guardian collects log files from TT machines, it also collects the ttmd_yyyy-mm-dd.log files. Both the TTM Daemon and TTM Router daemon write to this file.

If you want to use a different log file name or set a different directory in which to save it, you must do so in the environment variables. For procedures on editing environment variables, refer to Environmental Variables.

For a description of the log file output, refer to TTM Log Files.

TTM Logging Parameters

The following table describes the TTM logging parameters.

TTM Logging Parameters

Parameter

Description

LoggingType

ttmd.cfg installs with a default LoggingType setting of file.

Sets how TTM produces its log file according to the following values:

  • none: TTM does not produce a log file.
  • stderr: TTM produces its log output in a standard error stream. To see the stderr output, you must run TTM in a command window.
  • file: TTM writes its log information to a log file. TTM assigns the log file the value of the TTM_LOG_PATH environment variable.
  • both: TTM writes its log information to file and in a standard error stream. The log file is named according to the value of the TTM_LOG_PATH environment variable. To view the output of the standard error stream, you must have a command window open.

LogFileHistory

ttmd.cfg installs with a default LogFileHistory setting of 10.

Sets the number of days of log files that TTM retains. TTM deletes log files with dates that are older than the setting of LogFileHistory.

TTM checks for expired log files and deletes them whenever it starts up and daily at 00:00:01.

TracingLevel

ttmd.cfg installs with a default TracingLevel setting of normal.

Sets the level of detail that TTM logs. TracingLevel can have the following values:

  • normal: Logs whenever the TTM Daemon starts or stops, a client connects or disconnects, a session begins or ends, and errors occur.
  • trace1: In addition to the events logged in the normal trace level, trace1 logs client requests (when received and executed), whenever a listener or inbox is created, a messages is sent, and any advisories.
  • trace2: In addition to the events logged in the previous trace levels, trace2 logs the origination of inbound and outbound PGM sessions, and any PGM events.
  • trace3: In addition to the events logged in the previous trace levels, trace3 details the major points in the protocol chain.
  • trace4: In addition to the events logged in the previous trace levels, trace4 details the content of inbound and outbound packets in hexadecimal format.

WindowsEventLoggingMode

Sets the type of Windows Event Log to which TTM writes. Available values include:

  • None: TTM does not write to a Windows Event Log.
  • App: TTM writes to the Application Event Log.
  • Custom: TTM writes to a custom Event Log called Trading Technologies.

By default, the TTM Daemon behaves as if set to None.

PulseLogging

Sets whether TTM logs internal ‘Pulse’ library messages. This parameter has two settings:

  • false: Pulse logging is disabled
  • true: Pulse logging is enabled

This parameter is available in TTM Version 7.0.6 and higher. By default, TTM Version 7.0.6 and higher behave as if PulseLogging=true.

In previous versions of TTM, users may manually enable Pulse logging via the ttmd.cfg file.

StartCachingOffloadMinidumps

Sets whether TTM produces minidump logfiles when a slow consumer is detected. This parameter has two settings:

  • false: TTM does not create minidumps
  • true: TTM creates minidump logfiles when a slow consumer is detected.

This parameter is available in TTM Version 7.0.6 and higher. By default, TTM Version 7.0.6 and higher behave as if StartCachingOffloadMinidumps=false.

Configuring Logging Behavior in ttmd.cfg

You configure TTM’s logging behavior in ttmd.cfg using the parameters listed in the previous section called TTM Logging Parameters.

To configure TTM’s logging:

  1. Using Notepad, open the ttmd.cfg file located in <root drive>:ttconfig.
  2. On the Edit menu, click Find.
  3. In the Find what box, type the logging parameter whose value you want to change.
  4. Click Find Next.
  5. To close the Find dialog box, click Cancel.
  6. Drag to select the value of the parameter that you want to change, and the type the new value.

    For a list of parameters and the logging functions they affect, refer to TTM Logging Parameters.

  7. Save and then close ttmd.cfg.
  8. Stop and restart TTM.