Note: The Log Viewer feature is not available on MassTransit SFTP servers.
The Log Viewer feature allows Web client contacts to see information from the Log window (through the MassTransit Web interface) based on privileges that are granted from the MassTransit Administrator contact information settings. For contacts with log viewing privileges, the MassTransit Web interface will have a "View Log" tab.
Depending on the assigned privileges, the Web client contact will be able to see all log entries of the Log window or only log entries for specified contacts. In addition, there are filters which can be set for displaying the information in a more convenient view and an option for auto-refreshing the displayed log entries.
When you have set filters in the Log Viewer, the displayed results are the ones that satisfy the conditions from all filters.
The filters available in the Log Viewer are the following:
View Only filters:
Contacts – setting this filter displays log entries only for the specified contact (or a group of contacts); the available options in this drop-down menu are All and the contacts that you have privileges to see information about;
Type – filters all entries of the specified type; these are the available types:
All – shows all entries of all types;
Error – displays error entries;
Connection – displays connection entries which show information about the type of the connection (manual or automatic), when a connection has been established/dismantled, and whether the file transfer has begun/ended;
File Transfer – these entries show information about each of the transferred files – file name, size, transfer time, average bandwidth throughput, and cyclic redundancy check (CRC);
Output – log entries with information regarding services execution;
Spooling – displays printer processing messages;
Notification – all other messages that do not regard the rest of the described options;
Summary – shows summaries of the file transfers including number of transferred files, total transferred file size, average bandwidth throughput, and total transfer time;
Info – displays information about configuration settings like available disc space, remote administration configuration, IP address of your server, database, etc.;
Severity – filters all entries of the specified severity:
All – displays the entries of all severity types;
Error – displays only errors;
Warning – displays only warning messages;
Info – displays only information entries.
View Entries Dated Between filters:
Start Date – enter a date or select one from the calendar next to the field to filter all entries from the specified start date to the present date (or to the End Date, if specified);
End Date – enter a date or select one from the calendar next to the field to filter all entries to the specified end date;
Common Dates – for faster setting of a time interval, you can select from this drop-down menu one of the following options:
Today – displays all entries from today only;
Yesterday – displays all entries from yesterday;
Last 7 Days – displays all entries for the last 7 days;
Last 14 Days – displays all entries for the last 14 days;
Last 30 Days – displays all entries for the last 30 days;
Search Text – enter some text in this field if you want to filter all log entries that contain the entered text.
When you have set the desired filters, click on the FIND button to display the filtered information.
If you want to reset all set filters, just click on the RESET ALL button then FIND.
The Log Viewer has an option for auto refreshing the displayed log information in real time. By default, the option is disabled but you can enable it by clicking on the On radio-button in the REAL-TIME REFRESH area of the "View Log" tab. To disable auto refreshing of the Log Viewer, click on the Off radio-button.
Configure Log Viewer
Configure Log Viewer User Interface
You can customize the user interface of the "View Log" tab in the MassTransit web site. To do that, follow the steps below:
Open the mtweb.ini file located in the MTWeb directory. By default, this folder is placed on the system drive in:
on 64-bit machines:
for MassTransit 7.6 and later: C:\Program Files (x86)\Acronis\MassTransit Server\MTWeb
for MassTransit 7.1 to 7.6: C:\Program Files (x86)\Group Logic\MassTransit Server\MTWeb
for MassTransit 7.0.x: C:\Program Files (x86)\Group Logic\MassTransit Server 7\MTWeb
on 32-bit machines:
for MassTransit 7.1 and later: C:\Program Files\Group Logic\MassTransit Server\MTWeb
for MassTransit 7.0.x: C:\Program Files\Group Logic\MassTransit Server 7\MTWeb
Note: All lines beginning with a semicolon (;) in the mtweb.ini file are considered commented and therefore ignored. Please ensure that all settings you change are uncommented (if you see ";" characters at the beginning of any of the settings you modify, delete them).
Go to the USER INTERFACE section in the file.
To set the maximum number of pages to be returned in search results in the Log Viewer, change the setting below. The maximum value of the setting is 100. LOGVIEWER_MAX_PAGES = 20
To set the maximum number of pages of search results to show in page listing in the Log Viewer, modify the setting below. The maximum value is 25. LOGVIEWER_MAX_DISPLAYED_PAGES = 25
To set the maximum number of search results to show per page in the Log Viewer, modify the following setting. The maximum value is 100. LOGVIEWER_RESULTS_PER_PAGE = 30
You can configure a delay (in seconds) between completing one update and beginning the next when MassTransit Web is in live-update mode (REAL-TIME REFRESH is turned on). Values less than or equal to zero will be treated as 1 second. There is no maximum value. LOGVIEWER_UPDATE_DELAY_SECONDS = 10
Log entry timestamps can be displayed in 24-hour format or in 12-hour format with am/pm displayed. Set to true the setting below if you want to use the 24-hour format. Set to false to use the 12-hour format. LOGVIEWER_24_FORMAT = "false"
When you have configured all desired settings, save and close the mtweb.ini file.
Restart the Internet Information Services (IIS) from the IIS Manager in order to apply the changes immediately.
Note: For more customizations of the MassTransit Web user interface, please refer to the MTWeb page.
Configure a Contact to Use Log Viewer
As mentioned above, only Web client contacts can use the Log Viewer feature and since it is configurable per contact, you need to perform the following steps for every contact that would use the feature.
To configure a contact to use Log Viewer:
In the MassTransit Administrator, open the Contacts window by clicking on the Contacts button from the Navigation Bar or by selecting the Contacts option from the Window main menu.
In the Contacts window, highlight a Web client contact to be configured to use the Log Viewer feature and click on the Edit... button.
In the Contact Information window that appears, open the Security tab.
Under the Web Privileges area of the Security tab, check the Allow User To Access Log check box and click on the Configure... button. This will allow the user to view ALL log entries. If you want to restrict the displayed in his user interface log entries to specified contacts only, continue with the steps below. Otherwise, skip to step 6.
To limit the displayed to the Web client contact log entries:
Check the Limit Log To Listed Contacts check box from the Web Privileges area as shown below:
Then, specify the desired contacts that the user will be able to see log entries for from the Web Log & Files Limit Contact List area:
To choose the desired contacts, select them from the Add: drop-down menu;
To remove contacts from the list, select them from the Remove drop-down menu.
When you are ready with the contact configuration, click on the OK button to save the changes.
The edited Web client contact will be able to view the defined log entries the next time he/she logs into the MassTransit web site. The log information will be displayed in the View Log tab of the contact's user interface.
