ApplicationXtender - How to collect additional logs

Applies to

ApplicationXtender Connector 16.3, 8.1, 8.2
ApplicationXtender Desktop 16.3, 7.0, 8.1
ApplicationXtender for Office 16.3, 8.1, 8.2
ApplicationXtender License Server 16.3, 7.0, 8.1
ApplicationXtender Web Access.NET 16.3, 7.0, 8.1
ApplicationXtender Web Services 16.3, 7.0, 8.1
ApplicationXtender Workflow Manager 16.3, 7.0, 8.1
ApplicationXtender Administrator 16.3, 20.3, 20.4

Summary

To enable verbose logging for the different AX applications.

Resolution

You can collect logs by following the steps outlined in this article for each ApplicationXtender product and/or module.

AX Administrator
Web Access
Web Services
AX for Office
Workflow Manager
License Server
AX Connector

For AX Administrator

Backup current web.config file and then replace the system.diagnostics with the below.

Set your Trace Level to Verbose for the most information available. Set back to Warning when triage is complete to prevent unneeded logging from occurring.
Modify AxAdminMessage.log with pathname if want to direct the log file to a specific location. If the log file is not desired, Comment out each “axFileListener1” line that is not already commented out.

<system.diagnostics>
    <trace autoflush="true">
      <listeners>
        <add name="axEventLogListener" />
        <!--<add name="axFileListener1"/>-->
      </listeners>
    </trace>
    <sources>
      <!--This trace source logs AX Administrator events-->
      <source name="AXAdminTrace" switchName="AXAdminSwitch" switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="axEventLogListener" />
          <add name="axFileListener1"/>
        </listeners>
      </source>
      <!-- This trace source logs AXEngine events -->
      <source name="AXAdminEngineTrace" switchName="AdminEngineSwitch" switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="axEventLogListener" />
          <add name="axFileListener1"/>
        </listeners>
      </source>
      <!-- This trace source logs Database Library events -->
      <source name="XSDatabaseLib" switchName="DBSwitch" switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="axEventLogListener" />
          <!--<add name="axFileListener1"/>-->
        </listeners>
      </source>
      <!-- This trace source logs DB SQL commands -->
      <source name="XSSQLTrace" switchName="SQLSwitch" switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="axEventLogListener" />
          <!--<add name="axFileListener1"/>-->
        </listeners>
      </source>
	  <source name="ADFSTrace" switchName="ADFSSwitch" switchType="System.Diagnostics.SourceSwitch">
        <listeners>
          <add name="axEventLogListener" />
          <!--<add name="axFileListener1"/>-->
        </listeners>
      </source>
    </sources>
    <switches>
      <!--Trace Level.  Possible levels: Off, Error, Warning, Information, Verbose-->
      <add name="DBSwitch" value="Warning" />
      <add name="SQLSwitch" value="Warning" />
      <add name="AdminEngineSwitch" value="Verbose" />
      <add name="AXAdminSwitch" value="Verbose" />
	  <add name="ADFSSwitch" value="Warning" />
    </switches>
    <sharedListeners>
      <!-- Write trace events to Windows Event Log at level of AXTraceLevel
              - only use this when AXTraceLevel set to Error or Warning
                else too much data in Windows Event log 
        -->
      <add name="axEventLogListener" type="System.Diagnostics.EventLogTraceListener" initializeData="AxAdminEventLog" />
      <!--Write trace events to log file.-->
      <add name="axFileListener1" type="System.Diagnostics.TextWriterTraceListener" initializeData="AxAdminMessage.log" traceOutputOptions="DateTime, ProcessId, ThreadId" />
    </sharedListeners>
  </system.diagnostics>

For Web Access

Backup current web.config file and then replace the system.diagnostics with the below.

<system.diagnostics>
<trace autoflush="true">
<listeners>
<add name="axEventLogListener" />
<!--<add name="axFileListener1"/>-->
</listeners>
</trace>
<sources>
<!--This trace source logs Web Access events-->
<source name="AXWXTrace" switchName="WXSwitch" switchType="System.Diagnostics.SourceSwitch">
<listeners>
<add name="axEventLogListener" />
<!--<add name="axFileListener1" />-->
</listeners>
</source>
<!-- This trace source logs AXEngine events -->
<source name="AXEngineTrace" switchName="EngineSwitch" switchType="System.Diagnostics.SourceSwitch">
<listeners>
<add name="axEventLogListener" />
<!--<add name="axFileListener1"/>-->
</listeners>
</source>
<!-- This trace source logs Database Library events -->
<source name="XSDatabaseLib" switchName="DBSwitch" switchType="System.Diagnostics.SourceSwitch">
<listeners>
<add name="axEventLogListener" />
<!--<add name="axFileListener1"/>-->
</listeners>
</source>
<!-- This trace source logs DB SQL commands -->
<source name="XSSQLTrace" switchName="SQLSwitch" switchType="System.Diagnostics.SourceSwitch">
<listeners>
<add name="axEventLogListener" />
<!--<add name="axFileListener1"/>-->
</listeners>
</source>


<!--Enable WCF verbose log to diagnose Rendering Service connection issues-->
<!--<source name="System.ServiceModel"
switchValue="Information, ActivityTracing"
propagateActivity="true">
<listeners>
<add name="sdt"
type="System.Diagnostics.XmlWriterTraceListener"
initializeData= "C:\Temp\WXWCF.svclog" />
</listeners>
</source>-->
</sources>
<switches>
<!--Trace Level. Possible levels: Off, Error, Warning, Information, Verbose-->
<add name="DBSwitch" value="Warning" />
<add name="SQLSwitch" value="Warning" />
<add name="EngineSwitch" value="Warning" />
<add name="WXSwitch" value="Warning" />
</switches>
<sharedListeners>
<!-- Write trace events to Windows Event Log at level of log switch
- only use this when switch set to Error or Warning
else too much data in Windows Event log
-->
<add name="axEventLogListener" type="System.Diagnostics.EventLogTraceListener" initializeData="AxWebEventLog" />
<!--Write trace events to log file.-->
<add name="axFileListener1" type="System.Diagnostics.TextWriterTraceListener" initializeData="AxWebMessage.log" traceOutputOptions="DateTime, ProcessId, ThreadId" />
</sharedListeners>
</system.diagnostics>

Windows Event Viewer log is enabled by default.
Enable File log by uncommenting file listener in each/specific source.
<add name="axFileListener1"/>
Change the log level to verbose for each/desired switch if you need more detail.
Enable the Rendering Service connection log by uncommenting System.ServiceModel source.

For Web Services

To turn on the Web Service verbose logs, open the Web.config file in the Web Services folder. Comment the axEventLogListener and uncomment the axFileListener. Change the AXTraceLevel switch to Verbose.

For AX for Office

To turn on AXO verbose logs, open Office, click the Add-ins tabs in the ribbon and select the Verbose item in the dropbox.

For Workflow Manager

To collect Workflow Manager logs, you can do one of the following:
1. Export the error log in WWSKLogger Console
2. Export the log in Windows Event Viewer.
To enable EDB verbose Log, you can change the log setting in web.config:
To enable WIM log, add below key in <appSettings> in WIM.exe.config

For License Server

In the registry key:

create a DWORD value named “LicenseServerLogLevel”. The value can be 0(debug), 1(info), and 2(error). The default one is 1.

We recommend backing up your registry files (SYSTEM.DAT and USER.DAT) before making any changes. CASO is not responsible for improper modification of the system registry. Using Registry Editor incorrectly can cause serious issues that may require you to reinstall Windows.

For AX Connector

In the configuration file ‘Connector.exe.config’, make the below change in the section ‘loggingConfiguration’.