Difference between revisions of "Black Box"
| Line 7: | Line 7: | ||
==Thread Information== | ==Thread Information== | ||
| − | + | Every thread in a process gets a black box. | |
| − | * Thread id | + | Here are the items stored per thread: |
| − | * Type | + | |
| − | * fileid | + | * Thread id - the thread's operating system [https://learn.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-getcurrentthreadid id] |
| − | * lastfileid | + | * Type - Set by Truxton and will usually be 0xB58F0316910A765C (Worker Thread) which is where your code runs |
| − | * mediaid | + | * fileid - The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the [[TGUID#File_ID|file]] currently being processed. This corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[File Table|File]]<nowiki>]</nowiki></code> table. |
| − | * lastmediaid | + | * lastfileid - The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the [[TGUID#File_ID|file]] previously processed. This corresponds to the <code>[ID]</code> column of the <code><nowiki>[</nowiki>[[File Table|File]]<nowiki>]</nowiki></code> table. |
| + | * mediaid - The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media that contains the file being processed. This corresponds to the <code>[ID]</code> column of the <code>[Media]</code> table. | ||
| + | * lastmediaid - The [https://en.wikipedia.org/wiki/Universally_unique_identifier GUID] of the media of the last file processed. This corresponds to the <code>[ID]</code> column of the <code>[Media]</code> table. | ||
* activity | * activity | ||
* lastactivity | * lastactivity | ||
Revision as of 09:34, 29 May 2023
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
Contents
The black box is a place where values can be stored on a per thread basis.
Thread Information
Every thread in a process gets a black box. Here are the items stored per thread:
- Thread id - the thread's operating system id
- Type - Set by Truxton and will usually be 0xB58F0316910A765C (Worker Thread) which is where your code runs
- fileid - The GUID of the file currently being processed. This corresponds to the
[ID]column of the[File]table. - lastfileid - The GUID of the file previously processed. This corresponds to the
[ID]column of the[File]table. - mediaid - The GUID of the media that contains the file being processed. This corresponds to the
[ID]column of the[Media]table. - lastmediaid - The GUID of the media of the last file processed. This corresponds to the
[ID]column of the[Media]table. - 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
