Arch Sub-System: Trace - TraceListenerFile

A TraceListener that writes trace messages into a ring of text files.

[C++] class TraceListenerFile: public TraceListener
[C#] class TraceListenerFile: TraceListener

Public Methods

Type	Name	Description
	Constructor()	Constructs an object
void	OnTrace()	Performs trace output

This trace listener writes traces into a ring of text files. If the last file has been written, the listener starts to overwrite the oldest files, beginning with the second file, preserving the very first file.

The first trace file is preserved to keep startup information that might be usefull when examining later traces.

The name of the file is made up with the following parts:
NameBase + "_" + DateOfStart + "_" + ProcessId + "_" + FileCounter + ".trace"

NameBase: Base file name that was given at the constructor (app specific)
DateOfStart: DateTime when the listener was created, Format: YYYYMMDDHHmm
ProcessId: Native process Id (decimal) to separate several processes started at the same time.
FileCounter: Decimal value with a range of [0..9]

Example: SemysBaseTest_200607111610_14405_0.trace

The files are created in the path context of the application or at an explicitly specified location (set at construction time).

The first file will be created with the first trace output.

Reference: net::semys
Implementation: Semys Architecture
See Also: Trace Sub-System

Goto: Main Page; This page is part of the Semys software documentation. See About: Documentation for details.