Use Microsoft Office Communications Server Tracer to examine an application's SIP protocol logs, and to collect logs for use in advanced troubleshooting.

To install Server Tracer, install Microsoft Unified Communications Managed API version 1.0 SDK, then use ucmaredist.msi to install the Unified Communications Managed API version 1.0 Redistribution Package. The default installation path for Office Communications Server Tracer is %Program Files%\Microsoft Office Communications Server 2007\Common\Tracing.

To launch Office Communications Server Tracer
  1. On the Windows taskbar, click Start, click Run, type cmd, and then click OK.

  2. At the command prompt, type cd \Program Files\Microsoft Office Communications Server 2007\Common\Tracing, and then press ENTER.

  3. Enter the appropriate OCSTracer.exe syntax, and then press ENTER.

Displaying OCSTracer.exe Help

To display the top level Help text for OCSTracer.exe syntax, at the command prompt type ocstracer and then press ENTER.

To display Help text for individual OCSTracer.exe commands, see the following example.

Copy Code
ocstracer list /?

Changing the Log File Directory

By default, log files are written to the directory %WINDIR%\Tracing. To change the directory log files are written to, modify the LogFileFolder attribute in the OCSTracer.ini file. By default, OCSTracer.ini is installed in the same directory as OCSTracer.exe.


Copy Code
//Start tracing for S4 and Collaboration.
OCSTracer.exe start /Component:S4 /Component:Collaboration
Copy Code
//Stop tracing.
OCSTracer Stop
Copy Code
//Convert an .etl file to a .txt file.
OCSTracer.exe format /LogFilePath:S4.etl /OutPutFile:S4.txt 

See Also