App Control: How to Collect Server Logs for API or Web Page Errors (Web Console)

[#1]

Environment

• App Control Console: All Supported Versions

Objective

• "Something went wrong!" page error
• "API authentication failed. Some pages will not be functional. Please try to log out and log in again."
• "API appears not to be accessible."
• Active Directory error
• Username or password incorrect

Resolution

1. Browse to https://<servername>/support.php and select the Diagnostics tab.
   • Select the "Snapshot Server Logs" button
   • Set logging duration: 30 Minutes
   • Debug Level: High
   • Reporter Log Level: Minimum(default)
   • Script Debug Level: Minimum(default)
   • Active Directory Debug Level: Minimum(default)
   • Enable SQL Trace: Check the box
   • Start Logging
2. Navigate to https://<SERVERNAME>/shepherd_config.php and set the following property:

   Debugconsolecommunication: true
   

3. Reproduce the error several times
4. Go back to the Support.php page and "Stop Logging"
5. On the right side under Related Views, select "Available Log Files".
6. Save all files with today's date:
   • ReporterLog-date-time.log
   • ServerLog-date-time.bt9
   • PHPErrors-date-time.log
   • API-date-time.log
   • SQLTrace-date-time.csv
7. Navigate to https://<SERVERNAME>/shepherd_config.php and set the following:

   Debugconsolecommunication: false
   

8. If Syslog is enabled please restart the App Control Reporter Service due to a known issue that stops sending events after logging completes
9. Please also collect the IIS logs typically located here:

   C:\inetpub\logs\LogFiles\W3SVC45

10. Please zip and upload all collected data to Cb Vault

Related Content

App Control: What Items are Required to be Enabled for IIS?