Black Box

From truxwiki.com
Revision as of 17:08, 28 May 2023 by Sam (talk | contribs)
Jump to navigation Jump to search

The Truxton ETL processes have a "black box" that contains information about the process. It is a process equivalent of an aircraft black box. The contents are dumped upon request to an XML file.

Contents

The black box is a place where values can be stored on a per thread basis.

Thread Information

Each slot contains the following information.

  • Thread id
  • Type
  • fileid
  • lastfileid
  • mediaid
  • lastmediaid
  • activity
  • lastactivity
  • flushloopcount
  • sourcecodefile
  • linenumber
  • lastupdate
  • lastupdatesecondsago
  • laststatusmediaid
  • laststatusmessage
  • getmessagecount

Slots

There are 20 slots where information can be stored.

  • Slot Number
  • value
  • sourcecodefile
  • linenumber


Dump File Location

The state information will be written to a file in a folder named "Truxton\\Debug Dumps" with a timestamp and process id in the filename. If the logdir option was not set, the root folder for the dump folder will be in the Program Data folder, usually the hidden C:\ProgramData folder.

Examples

Individual Process

If an indevidual process was told to dump its state and logdir was set to "E:\Logs\" then the dump file would be something like this:
E:\Logs\Truxton\\Debug Dumps\\20230523_174359_Process_1234_DebugDump.xml