Enabling Debug Logging for the On-premises Agent

Note: Applies to Directory hybrid (on-premises AD) deployments only

In some support scenarios, you may be asked by Directory Support to turn up the logging level for the Directory Agent.

Here are the steps to do so:

1   Browse to the directory, “C:\Program Files\LiveTilesDirectory\Service” and modify the HyperfishService.exe.config file with a text editor. 

2   Look for the two sections that contain:

<appender name="RollingFile" type="log4net.Appender.RollingFileAppender">
<file type="log4net.Util.PatternString" value="%envFolderPath{LocalApplicationData}\\Hyperfish\\logs\\service.log" />
<appendToFile value="true" />
<maximumFileSize value="1MB" />
<maxSizeRollBackups value="20" />
<threshold value="INFO"/>
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%level %date{yyyy-MM-dd HH:mm:ss,fff} &#9;%message%newline" />
</layout>
</appender>

<appender name="AgentRollingFile" type="log4net.Appender.RollingFileAppender">
<file type="log4net.Util.PatternString" value="%envFolderPath{LocalApplicationData}\\Hyperfish\\logs\\service.log" />
<appendToFile value="true" />
<maximumFileSize value="1MB" />
<maxSizeRollBackups value="20" />
<threshold value="INFO"/>
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%level %date{yyyy-MM-dd HH:mm:ss,fff} &#9;%message%newline" />
</layout>
</appender>

3   Change <threshold value=“INFO”/> to <threshold value=“DEBUG”/>, for both RollingFile and AgentRollingFile sections, then restart the Directory service.

4   Reproduce the issue you are experiencing, then zip up the most recent logfiles from "C:\Users\<hyperfishserviceaccount>\AppData\Local\Hyperfish\Logs" and send them to Directory Support.