Session Log Viewer

The Session Log Viewer provides the ability to read and search session logs.

By default the last page of the log displays, enabling the user to determine from the last line of the log the circumstances in which the process exited (be they normal or abnormal). You can navigate to other pages using the arrow buttons at the bottom of the dialog: the double arrows will skip to the earliest/latest page and the single arrows will navigate to the previous/next page.

To view larger or smaller pages, adjust the value on the bottom right which controls the number of rows per page.

The more rows you display on the page, the longer it will take to retrieve each page from the database. Depending on the size of your log and the performance of your database server, this could take some time.

View stage IDs

You can select to view or hide stage IDs from the log via the View tab at the top of the dialog – select/deselect Stage ID from the Columns drop-down list. Stage IDs allow you to identify stages in a process diagram by ID rather than name. By displaying stage IDs, an advanced user may check for internal inconsistencies in a process.

Search the logs

You can search for text in on the current page by clicking Search at the top of the dialog. Each instance of the search term will be highlighted in turn. You can instantly see all instances by clicking Find All, which will highlight each instance with the selected highlight color. You may subsequently change the color and highlight another search term simultaneously. Clicking Clear will clear all highlights.

Text is only searched on the current page. However, when the end of the page is reached the Blue Prism interactive client will prompt you to search the next page. At this point you may also choose to search the entire log – in this case, Blue Prism will automatically fetch each page in turn, search the page and pause on the next instance of the search term or fetch the next page again if no instance is found. Once all pages have been searched in this manner, a popup message displays to indicate this. Please be aware that searching all pages may take some time.

You can enhance the search to use wildcards, match the whole word or case. See the information about wildcards and regular expressions for further information.

Log Parameter Viewer

Any input or output parameters that are entered into a process while the process is running can be viewed in the Log Parameter Viewer. Click View in the Parameters column on the Session Log Viewer to display the Log Parameter Viewer.

The Log Parameter Viewer also displays any input parameters that are automatically or manually entered into an input form when a process is run on Blue Prism Desktop.

Export logs

If you need to use the logs outside of Blue Prism, you can export logs in one of the following formats:

  • CSV file (suitable for use in a spreadsheet).

  • TXT file (as you see on the log viewer itself).
  • HTML file (suitable for markup in a web browser).

If you choose either HTML or CSV, the data in each row of the log will be separated into distinct columns of message datetime, message and stageid (where appropriate).

To export a log (or a section of a log), choose the appropriate export option from the file menu at the top left of the form. A dialog displays to guide you through the necessary steps. See Log Export Wizard for further details.