Configuring LDL logging options

Article
06/11/2018

Applies to: Lync 2010 | Lync 2013 | Lync Server 2010 | Lync Server 2013

Lync SDN Interface 2.1.1 uses the logging infrastructure of the Enterprise Libraries 5.0. You can inspect and modify the configuration file by using the Microsoft Enterprise Library Configuration Tool. For a complete documentation on the options and capabilities of the logging infrastructure, see Configuring the Logging Application Block in the Enterprise Libraries documentation.

The Enterprise Libraries includes a configuration tool that provides an intuitive graphical user interface for adding and changing settings for the logging configuration. You can use this tool to configure the LDL logging options. This article explains how to configure the logging options in the LyncDialogListener.exe.config file.

Set logging configurations

To manually set the most common logging configurations:

Navigate to the LDL installation directory.
Open the LyncDialogListener.exe.config file with a text editor.
Search for the <loggingConfiguration> section and make appropriate changes to entries under the <listeners>, formatters and categorySource elements.

Here, the <listeners> element specifies the log output, including the log file location and file rotation policies. They refer to a particular formatter to be used. Each entry, an <add> element, under <listeners> specifies a type of logging. Modifications can include adding a new <add> entry to enable the specified type of logging, removing an <add> entry to disable the specified type of logging, and changing an existing <add> entry to change the specified type of logging.

The <formatters> element specifies the style for each log entry. The <categorySource> element specifies bindings of the log channels used in LDL and LSM to particular listeners. The switchValue could be Off or All indicating whether this log channel is active. For a more thorough investigation of issues, you must start the Debug channel by setting the switchValue to All, as shown. \
```
       <add switchValue="All" name="Debug">
         <listeners>
           <add name="LNEAppLog" />
         </listeners>
       </add>
```

The following example shows the LNEAppLog type of logging options containing a modified logging file path (in the boldface text).

<listeners>
  <add name="LNEAppLog"
     type="…" 
     listenerDataType="…" 
     fileName="C:\logdir\LyncDiagnostics.log" 
     footer="" 
     formatter="LNEDetailFormatter" 
     header="" 
     rollFileExistsBehavior="Increment" 
     rollInterval="Day" 
     rollSizeKB="100000" 
     traceOutputOptions="LogicalOperationStack, 
     DateTime, Timestamp, ProcessId, ThreadId, Callstack"/>
</listeners>

Lync Dialog Listener service logging types

The Lync Dialog Listener service default configuration supports the following types of logging.

Lync Dialog Listener logging configuration

Logging type	Description
LNEAppLog	Logging the application execution states, including Info and Error types of data as well as adding activated Debug channel. The output is recorded in the LyncDiagnostics.log file. This file won't contain any PII.
AllDataLog	Logging all input data, including SIP messages with SDP headers, and raw quality of experience reports.
QoEInputDataLog	Logging the quality of experience raw data from the Lync Server.
DialogDataLog	Logging the dialog data, including SIP messages and SDP headers.

Lync SDN Manager logging types

The LSM default configuration supports the following types of logging.

Lync SDN Manager logging configuration

Logging type	Description
LNEAppLog	Logging the application execution states, including Info, and Error types of data as well adding Debug, if activated. The output is recorded in the LyncSDNManager.log file. This file won’t contain any PII.
AllOutputLog	Logging all output data sent to Network Controllers. The output is recorded in the AllOutputManager.log file
AllInputLog	Logging all input data received from LDLs. This data can be replayed and the output is recorded in the AllInputManager.log file.
ErrorMsgLog	Logging individual messages about processing issues and the respective error messages for further investigation. The output is recorded in the ErrorMsgManager.log file.
LogOutputLog	Logging the messages received at the Message Receiver Log Service. The output is recorded in the LogOutput.log file. For more information, see Debugging Lync SDN Manager.
QoEInputDataLog	Logging the quality of experience raw data of the Lync Server received from LDLs. The output is recorded in the QoEInputManager.log file.
QoEDataLog	Logging the raw QoE reports. The output is recorded in the QoEDataManager.log file.
DialogDataLog	Logging the dialog data, including SIP messages, received from the LDLs. The output is recorded in the DialogData.log file.

Warning

The LyncDiagnostics.log as well as the LyncSDNManager.log will not contain person-identifiable information (PII), even in debug-level, while any of the other logs might also contain un-obfuscated user aliases, names and telephone numbers. Activate this logs with caution.