WCF service tracing

Each IEE installation includes a WCF Service Trace Viewer to track the detailed communication between external applications and IEE web services. WCF service tracing can track both the client calls to a web service and the server activity in receiving and processing the client calls.

Most of this information is more easily viewable in the application service log files, but WCF traces are sometimes useful in diagnosing the root cause of web service failures.

Important! Do not enable WCF Service Tracing unless absolutely necessary. File size grows quickly. If an external system is sending requests without any errors, but IEE is not receiving the requests, enabling WCF Service Tracing might be necessary for troubleshooting. However, disable WCF Service Tracing as soo n as the troubleshooting is complete.

The IEE configuration files include WCF service tracing information, but it is commented out and disabled by default. To trace, you must enable WCF service tracing.

Enabling WCF Service Tracing

Remove the comment tags around the service.diagnostics element. (Search for "<!-- Uncomment to write to trace/message log" to find the section.)

To trace...

  • Server activity for application-server-hosted web services, edit Enterprise Edition\bin\IeeServiceRunner.exe.config. IEE writes this trace information to Enterprise Edition\logs\ItronServiceHostTrace.svclog.

  • Server activity for IIS-hosted Web services, edit Enterprise Edition\Web\Web.config. IEE writes this trace information to Enterprise Edition\WebService\ItronServiceHostTrace.svclog.

  • Client calls from Commercial & Industrial Customer Care or MM CC Web application, edit Enterprise Edition\Web\Web.config. IEE writes this trace information to Enterprise Edition\logs\ItronServiceClientTrace.svclog.

  • Client calls from the IEE rich client, edit Enterprise Edition\bin\UIApplication.exe.config. IEE writes this trace information to Enterprise Edition\logs\ItronServiceClientTrace.svclog.

Viewing Trace Files

  1. Run <application server>\Enterprise Edition\Tools\SvcTraceViewer.exe.

  2. Use the File menu to open the trace file you want to view.

If you open both a client and server trace file at the same time, you can see the flow of messages between the client and the server.