Using the MSSLogToText Log Analysis Tool

  • Article

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:

  • AudioStreams

  • CallAnalysisMessages

  • CallControlMessages

  • CallStatisticsMessages

  • CompiledGrammars

  • DetailedCallAnalysisMessages

  • DetailedLatencies

  • DetailedSRMessages

  • OperationalMessages

  • PlatformDiagnostics

  • ScriptDiagnostics

/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

  1. Click Start, click All Programs, click Microsoft Speech Application SDK, click Debugging Tools, and click Microsoft Speech Application SDK Command Prompt.

  2. 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.

  3. Optionally, perform the following steps in Excel.

  4. On the File menu, click Open.

  5. 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.

  6. 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