Enable Debug Logging (On-prem Agent)

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

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

Here are the steps to do so:

1. Browse to the directory, “C:\Program Files\Hyperfish\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 Hyperfish 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 Hyperfish Support.