Session logs viewer

The session logs 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 arrowed buttons will skip to the earliest/latest page and the single arrowed buttons 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 client will prompt the user to search the next page. At this point you may also choose to search the entire log – in this case, the client 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 will inform the user. 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. Please see the pages on wildcards and regular expressions for further information.

Export logs

Should you have a need to use the log in a context outside of Blue Prism you may export the log to a flat file suitable for sending via email or copying to a portable storage medium.

Three file formats are available:

• plain text file (as you see on the log viewer itself
• html file (suitable for markup in a web browser)

• csv file (standing for comma separated values, this file format is designed for formatting tabular data making it suitable for use in a spreadsheet).

  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 will appear and guide you through the necessary steps. See Log Export Wizard for further details.