Using the MSSLogToText Log Analysis Tool
Using the MSSLogToText Log Analysis Tool
Use MSSLogToText to convert an .etl file into a text file.
Note Optionally, use Microsoft Office Excel to format the output.
MSSLogToText source [destination] [/c[at[egories]]:cat1[+cat2][+cat3]...] [/m[ax[events]]:nnnn] [/b[aseurl]:url] [/f[rom]:["mm-dd[-yy]yy hh:mm:[ss]"] [/t[o]:["mm-dd-[yy]yy] hh:mm:[ss]"]
Part |
Description |
---|---|
source |
Specifies the path and file name of the log file to read. |
destination |
Specifies the file to write to. If unspecified, sourcefilename.txt is used, and the output is placed in the same path as specified in the source parameter. |
/c:cat1[+cat2] |
Specifies which categories to include in the extraction. Only events that fall within the listed categories are included. The category names include, but are not limited to:
|
/maxevents:nnn |
The maximum number of events to extract. This parameter has a direct impact on log file size. |
/baseurl:url |
The baseurl parameter specifies a URL string that is suffixed with a * wildcard and matched against the URL in each event. Only events that match are extracted. |
/from:datetime |
No events logged earlier than this date/time are included in the extraction. |
/to:datetime |
No events logged later than this date/time are included in the extraction. |
/h ,/? |
Displays this help message. |
To run the MSSLogToText log analysis tool
Click Start, click All Programs, click Microsoft Speech Application SDK, click Debugging Tools, and click Microsoft Speech Application SDK Command Prompt.
In the command window, type MSSLogToText, followed by the path and name of the .etl file to be converted. Ensure any command line parameters are quoted if they contain spaces. Press ENTER.
Optionally, perform the following steps in Excel.
On the File menu, click Open.
In the Open dialog box, select .txt in the File type box, browse to the destination text file that you named in the previous step, and then click Open.
Use the Text Import Wizard to format the text data into columns. Select Delimited as the type of data on the first screen. Enter the pipe character ( ¦ ) as the delimiter, and click Finish.
Output
Event information displayed in the output is defined by the Speech Server (MSS) event logging schema. In particular, the CommonEvent class defines certain properties, including:
Timestamp
PageUri
ApplicationInstance
These common properties form the first three columns of the output, followed by the name of the actual event (for example ListenElementCompleteEvent).
Each row displays the properties from a single event. Message text is also displayed for events that implement a Message property. For events that do not include message text, the field simply reads No message for this event. The remaining columns contain property–value pairs, always of the form PROP = VAL. The value for any event property that has not been supplied is output as PROPNAME = <null>.
See Also
Log File Extraction Utilities | Event Logging Class Hierarchy