T-Plan Home
T-Plan Robot Enterprise 4.0.2 Doc Collection
GUI Reference
10/06/15

T-Plan Robot Enterprise 4.0.2 Log Viewer

The Log Viewer window displays a list of available T-Plan Robot Enterprise log files and allows to manage them.

The log capturing functionality was introduced in the 2.3.4 release to make debugging of the environment, Robot application and even test scripts easier. As most Java and Robot's internal errors are printed out into the console (command prompt) which is not well visible to the end users, the application introduced a new mechanism which copies all console output and into a log file.

This log facility should not be confused with the script execution log which serves a different purpose and its content is different.

Each Robot application start creates a new log file. The file is however preserved only if at least one application log gets recorded. Empty log files (meaning log files with no content besides the log header) are deleted automatically when the owning Robot instance is closed.

The log files are stored in the <tempDir>/tprapplogs folder where <tempDir> is the temporary file directory provided by the underlying OS. Be aware that the OS may delete the logs at any time, for example when on a system restart (the /tmp folder on Linux/Unix) or when a clean up of temporary files is requested (Windows). Each log file name consists of the tprapplogs prefix followed by a time stamp (the number of elapsed milliseconds since 01/01/1970). This name convention ensures that the log file list sorted by name is also sorted chronologically.

Result
      Manager Window
  1. The header pane provides an overview with a link to the current T-Plan Robot Enterprise log folder. Selection of the link opens the folder in the system default application such as Windows Explorer on Windows.
  2. The log file list shows all available log files sorted chronologically (the newest log first). The log file used by the current Robot instance is marked as "current".
  3. The log viewer displays contents of the currently selected log file. Each log consists of a log header with the information about the start date, T-Plan Robot Enterprise version, the Java/OS identification and the maximum memory (heap size) that the Robot instance is allowed to allocate. The header is followed by the "RECORDED APPLICATION LOGS" section which lists all captured console logs in the chronological order.
  4. The Find button allows to search the currently displayed log for a string.
  5. The Mail to T-Plan button opens the default system mail client and prepares an E-mail message with the current log file contents to be sent to the T-Plan support. Should you experience an internal error use this control to send the data to T-Plan for evaluation.
  6. The Delete button deletes the selected file or files immediately. The button is disabled when the currently used log file is selected.
  7. The Close button closes the window.
  8. The Help button opens this help topic.