Debugging in the Admin Console
The Debugging section of the admin console at Debugging > Debugging controls debugging options as well as the execution of Java scripts.
The Compare option is used to compare the structural differences between two selected KBs.
Any two KBs located on the same server may be compared by defining one of them as the source KB, and the other one as the target KB. The comparison will produce an Excel report listing all of the differences, as a downloadable link. Differences are organized by the type of item, i.e. Tables, Fields, Choices, Rules, Actions, Searches, Groups, Teams, Email Templates, Data Conversion, and Views. These items are displayed on separate tabs in the Excel file. If either the target or the source KB is broken and cannot be compared correctly, the system will report this damage so that the admin can contact Agiloft Support for assistance.
To start debugging, click the Start Debug Output button. Debugging is automatically turned off after twenty minutes. Clicking the button again before twenty minutes have passed resets the timer.
Standard server logs contain many standard output messages like Info, Warning, or Errors. When debugging starts, the server outputs yet another message prepended with Debug. In most cases, the standard server outputs are enough to identify issues that arise. Debugging is useful only if standard server outputs do not give the cause of the problem.
Click “Stop Debugging” to manually end the debugging session.
In certain cases, attention must be brought to Agiloft regarding problems discovered through debugging. Click Send Debug Logs to send a copy of the logs to Agiloft for inspection.
The Bean Shell button brings up a separate window to run Java scripts for testing and debugging purposes. From this window, the admin gains full control over the Java Virtual Machine (JVM) that runs the Agiloft system.
BeanShell debugging allows runtime manipulations of parameters and instrumentation. For example, if the admin knows a specific class name, the class may be instantiated, and all of its methods may be invoked from this window.
Debugging and testing in this mode is strongly discouraged unless the admin has significant prior experience with Java/BeanShell and debugging. Misuse may result in a system crash or data corruption.
This option controls browser debugging. To start, click Start Debugging.
Slow GUI Operation Detection
Agiloft automatically tracks the length of time each GUI operation takes to complete. If a GUI operation takes longer than the specified limit to complete, the system creates an entry in the server logs. This allows admins and developers to determine the frequency and context of slow GUI operations.
To set a new limit, enter the number of seconds in the box and click Set Limit. The limit is applied immediately.
Show Current Activities
This shows activities that are running on the Agiloft system at the moment the Show activities button is clicked. The screen does not show any processes that may have already completed prior to the button click.
For small operations, the table of activities is usually empty at any instant in time. To ensure a non-empty output in small operations for testing purposes, importing multiple records or scheduling a mass edit/delete should suffice.