Skip to end of metadata
Go to start of metadata



Tracking MassTransit Online


MassTransit helps you keep track of each event and file received and sent even from the web by using a Web client contact with the appropriate privileges assigned. There are a couple of options for the Web client contacts to track MassTransit:

  • Log Viewer – the Log viewer allows you to track information from the Log window of the MassTransit Administrator application. The Log window keeps a record of each event as users contact others, move files, and process them in applications. To help you use the Log viewer to trouble-shoot, the Log viewer records the name of the user that launched MassTransit if permitted to. For contacts with Log viewing privileges, the MassTransit Web interface will have a “View Log” tab.
  • Reports – Reports is a feature which can be used through the MassTransit Web interface only. It allows Web client contacts to see reporting information based on privileges that are granted from the MassTransit Administrator contact information settings. For contacts with reporting privileges, the MassTransit Web interface will have a “Reports” tab.

Detailed information about the each of the tracking options and how to use them is displayed below.

NOTE:

Please note that in order to be able to track MassTransit online, you need to have the appropriate privileges set first. Contact the administrator of your MassTransit server for information on privileges.



Go to top


Log Viewer Tracking


As mentioned above, if you are allowed to use the Log Viewer, you will see a "View Log" tab in your account's user interface. Log into the MassTransit web site and open the "View Log" tab to see information from the Log window of the MassTransit Administrator application.


Go to top


Log Viewer Options


Depending on the assigned privileges, you will be able to see all log entries of the Log window or only log entries specified by the MassTransit administrator contacts. In addition, there are filters which you can set for displaying the information in a more convenient view and an option for auto-refreshing the displayed log entries.


Go to top


Log Viewer Filters


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:

    1. View Only filters:
         a. 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;
         b. Type – filters all entries of the specified type; these are the available types:
            i. All – shows all entries of all types;
            ii. Error – displays error entries;
           iii. 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;
            iv. 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);
            v. Output – log entries with information regarding services execution;
            vi. Spooling – displays printer processing messages;
           vii. Notification – all other messages that do not regard the rest of the described options;
           viii. Summary – shows summaries of the file transfers including number of transferred files, total transferred file size, average bandwidth throughput, and total transfer time;
            ix. Info – displays information about configuration settings like available disc space, remote administration configuration, IP address of your server, database, etc.;
         c. Severity – filters all entries of the specified severity:
            i. All – displays the entries of all severity types;
            ii. Error – displays only errors;
           iii. Warning – displays only warning messages;
            iv. Info – displays only information entries.

    2. View Entries Dated Between filters:
         a. 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);
         b. End Date – enter a date or select one from the calendar next to the field to filter all entries to the specified end date;
         c. Common Dates – for faster setting of a time interval, you can select from this drop-down menu one of the following options:
            i. Today – displays all entries from today only;
            ii. Yesterday – displays all entries from yesterday;
           iii. Last 7 Days – displays all entries for the last 7 days;
            iv. Last 14 Days – displays all entries for the last 14 days;
            v. Last 30 Days – displays all entries for the last 30 days;

    3. 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.


Go to top


Real-Time Refresh


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.

INFO:

The interval for auto refreshing the log viewer can be changed by the administrator of the MassTransit server. Contact the administrator if you want that interval to be increased/decreased.



Go to top


Reports


The Reports feature allows Web client contacts to see reporting information (through the MassTransit Web interface) based on privileges that are granted from the administrator of MassTransit. For contacts with reporting privileges, the MassTransit Web interface will have a “Reports” tab.

The available Reports for MassTransit are the following:

NOTE:

Please note that you may not be able to see all available reports if the administrator of your MassTransit server has not given you privileges to view them.




To view a report:

    1. Open the "Reports" tab of your user interface. This will display the list with reports.

    2. Click on the report you want to view. The report will be generated. In addition, you can filter the displayed results in the reports data by selected period/contact.
         a. From the Database area on the left, you can see information about the database used by Reporting:

           

         b. If the administrator of the MassTransit Server has configured a secondary database, you can use it to generate reports.
            i. To select the secondary database, click on the button on the right side of the Database area (see the image above). As a result, the following window appears:

              

            ii. Select the database to use to generate reports from the Database drop-down menu. After clicking OK, you will be redirected to the main Reports page. Subsequent reports will use data from the chosen database.
         c. Clicking on the following button will hide/show the menu with "Available Reports", "Report Parameters", and "Database" sections:

           

Below you will find details about the information displayed by the reports.

INFO:

As additional reports are released they will be made available through the MassTransit Latest Releases page.



Go to top


Server Summary Reports


Contact Expiration


NOTE:

In order to be able to see this report, the New contacts expire after __ days setting needs to be enabled by the administrator of the MassTransit server in the Special tab of the Setup window from the MassTransit Administrator application.

The Contact Expiration report displays a complete list of contacts that have expired or will expire in the next 30 days.

If you click on any of the column titles, the information in the table will be sorted by that column.

If you click on the CSV or XML button, you will be able to open/save the report in a *.csv or *.xml file format.


Go to top


Contact List


The Contact List report displays a complete list of contacts with configuration information about the contacts' IP addresses, phone, email address, time of last connection, expiration date (if configured), and mailbox location.

If you click on any of the column titles, the information in the table will be sorted by that column.

If you click on the CSV or XML button, you will be able to open/save the report in a *.csv or *.xml file format.


Go to top


Contacts by Type


The Contacts by Type report lists all active contacts and their type. The report also displays a graph with the active contacts by type.

If you click on any of the column titles, the information in the table will be sorted by that column.

If you click on the CSV or XML button, you will be able to open/save the report in a *.csv or *.xml file format.

To save only the chart, right click on it and select the Save as image... option. Then, select a location to save the image and click OK.


Go to top


Database Analysis


The Database Analysis displays detailed analysis of DBMS performance, memory usage, and configuration. There are the following sections with database analysis:

  • General analysis – DBMS type, version, etc.; if you click on the chart icon in the bottom right corner, a "DBMS SQL Query Performance" graph will be displayed showing the number of SQL queries per minute (to close the graph, click the red x in the top left corner):

   

  • Slow Queries – shows slow query log and time, and number of slow queries on the server if there are any; analysis of slow query;
  • Query Cache – shows cache size and analysis of the query cache;
  • Memory usage – displays the values in Megabytes (MB) of the following parameters: largest amount of memory ever allocated, configured maximum memory per thread, configured maximum size of global buffers, configured maximum system memory requirement, and physical RAM installed in server; shows also analysis of the memory usage;
  • Key buffer – displays the values of the following parameters: current MyISAM index space in MB, key cache miss rate, key buffer size in MB, key blocks used, key blocks unused, and key buffer fill in percents; analysis of the key buffer;
  • Table Scans – displays the values of the following parameters: read buffer size in KB, current full table scan ratio; information whether the read buffer size is OK;
  • Temporary Tables – displays the values of the following parameters: temporary table size in MB, maximum memory-based temporary table size in MB, total number of temporary tables created, total number of disk-based temporary tables created; analysis of the temporary tables;
  • Table Locking – displays the values of the following parameters: immediate table locks, table locks waited, immediate to wait ratio, concurrent INSERTs, low priority UPDATEs ON/OFF; analysis of the table locking.

If you click on the CSV or XML button, you will be able to open/save the report in a *.csv or *.xml file format.


Go to top


Error Summary


The Error Summary displays file transfer and connection errors grouped by error. The report also displays a graph of the errors by type.

If you click on the circle graph, a list will appear with detailed information about the error occurrences (to close the list, click the red x in the top left corner):

In addition, you can filter the displayed information by the following options from the Report Parameters section:

  • Start Date – enter or select a start date from the calendar to filter the errors starting from the chosen date; you can also add/subtract the year or the month in the field by clicking on the corresponding buttons below it;
  • End Date – enter or select an end date from the calendar to filter all errors to the chosen date; you can also add/subtract the year or the month in the field by clicking on the corresponding buttons below it;
  • Common Dates – this drop-down menu has options for faster filtering by the period that is selected; the available options are:
    • Today;
    • Yesterday;
    • Last 7 Days;
    • Last 14 Days;
    • Last 30 Days;
    • Last 365 Days;
    • Year To Date;
    • Previous Month;
    • Last Year.

When you have set the desired report parameters, click on the Run Report button to generate a report according to the selected parameters.

If you click on the CSV or XML button, you will be able to open/save the report in a *.csv or *.xml file format.

To save only a chart, right click on it and select the Save as image... option. Then, select a location to save the image into and click OK.


Go to top


File Summary


The File Summary displays a high level view of files in the system including number and size of files to send, sent, and received. You can also see information about the transferred file types.

To save only a chart, right click on it and select the Save as image... option. Then, select a location to save the image into and click OK.


Go to top


Server Summary


The Server Summary displays a high level view of MassTransit server configuration and status. This report includes the following sections:

  • MassTransit Server – displays information about the following parameters of the MassTransit Server: server name, server location, MassTransit Engine version, uptime in percents, last restart, previous shutdown, current uptime, SOAP interface version, and physical system memory;
  • Operating System / Web Server / PHP – displays information about the following parameters: operating system, computer name, DNS domain, user name of the user that MassTransit is run under, name of the server MassTransit is installed on, web server name and version, virtual directory support enabled/disabled, HTTP host, PHP version, path to the php.ini configuration file, value of the display_errors setting in PHP, value of the log_errors setting in PHP, value of the magic_quotes_gpc setting in PHP, value of the max_input_time setting in PHP, value of the memory_limit setting in PHP;
  • MassTransit Database – displays information about the following parameters of the MassTransit Database: type of the database, database version, database host, name of the user that MassTransit uses to connect to the database, MassTransit's database name, database query file name, database query file version, name of the override file of the database query file, database query override file version;
  • MassTransit Licensing – displays information about: identification number of the dongle, dongle flags, limit of the capacity model, installed licenses;
  • MassTransit Mailboxes – displays information about: default mailbox path, percents free space in the default mailbox disk, path to the default database, percents free space in the default database disk;
  • MassTransit Remote Administration – administrator address, port number for administrator notifications, port number for administrator requests, number of maximum connections allowed;
  • MassTransit Purging – displays information about: whether log purging is enabled, log purging duration, whether file purging is enabled, file purging duration;
  • mtweb.ini settings – displays the set values of the following settings of the mtweb.ini configuration file: MTWEB_MODE, LOGIN_MSG, SERVER_NAME, WATERMARK, LOGVIEWER_MAX_PAGES, LOGVIEWER_MAX_DISPLAYED_PAGES, LOGVIEWER_RESULTS_PER_PAGE, LOGVIEWER_UPDATE_DELAY_SECONDS, LOGVIEWER_24_FORMAT}}, MY_ACCOUNT_TAB_ENABLED, DISPLAY_NEW_JOB_TICKET_BUTTON, MAX_ROWS_TO_SHOW, SOAP_PROXY_ADDRESS, SOAP_PROXY_PORT, SOAP_WSDL, SOAP_TIMEOUT, DB_HOST, DB_PORT, DB_NAME, DB_USER (displayed with asterisk characters only), DB_PASSWORD (displayed with asterisk characters only), REPORTING_DB_USER (displayed with asterisk characters only), REPORTING_DB_PASSWORD (displayed with asterisk characters only), AUTHENTICATE_METHODS, AUTHENTICATION_TIMEOUT, CACHE_CLIENT_DATA, LANG, MEMORY_LIMIT, MFORCEHTMLJOBTICKET, MLIMITNUMFILESPERTRANSFER, LATEST_AVAILABLE_PLUGIN_VERSION, MINIMUM_REQUIRED_PLUGIN_VERSION, PLUGIN_FILENAME_WIN, PLUGIN_FILENAME_MAC, PLUGIN_FILENAME_MAC_10_4, HTTP_TRANSFER_ALLOWED, DEFAULT_FILE_TRANSFER_TRANSPORT, HTTP_STAGING_FOLDER, SECONDARY_DB_HOST, SECONDARY_DB_PORT, SECONDARY_DB_NAME, SECONDARY_DB_USER (displayed with asterisk characters only), SECONDARY_DB_PASSWORD (displayed with asterisk characters only), ACCOUNT_REQUEST_FROM, ACCOUNT_REQUEST_TO, ACCOUNT_REQUEST_SUBJECT, ACCOUNT_REQUEST_BODY, ENABLE_ACCOUNT_CREATION_EMAIL, ACCOUNT_CREATION_SUBJECT, ACCOUNT_CREATION_BODY, ENABLE_DEBUG_LOG, LOG_STACK_TRACE, LOG_CALLING_FUNCTION_FOR_EACH_MSG, LOG_DEBUG_LOG_VIEWER, LOG_SQL_CALLS, LOG_SQL_RESULTS, LOG_EXCEPTIONS, LOG_REPORT_DATA, LOG_CHART_XML, TRACK_MEMORY_USAGE, REPORTING_DB_HOST, REPORTING_DB_NAME, REPORTING_DB_PORT;
  • MassTransit LDAP/Active Directory Configuration – displays information about LDAP parameters: whether LDAP is enabled, LDAP primary domain, LDAP server address, LDAP server port, LDAP server bind domain name;
  • Average File Transfer Compression Ratios – displays the following ratios: receive compression ratio, send compression ratio, combined compression ratio.

If you click on the CSV or XML button, you will be able to open/save the report in a *.csv or *.xml file format.


Go to top


Status Reports


Bandwidth and Thruput Over The Last 24 Hours


The Bandwidth and Thruput Over The Last 24 Hours report is a comparison of raw network I/O vs. throughput (including compression) during the previous 24 hours.

The available charts in this report are:

  • Combined Thruput Of All Communication Methods;
  • TCP/IP Send/Receive Bandwidth;
  • TCP/IP Receive Bandwidth;
  • TCP/IP Send Bandwidth.

If you click the arrow button in the upper right corner of each small chart, you will be able to view it larger in the area above.

In addition, you can filter the displayed information using the Report Parameters section:

  • Select time span – this drop-down menu has options for faster filtering by the period that is selected; these are the available options:
    • Last 3 Hours;
    • Last 6 Hours;
    • Last 12 Hours;
    • Last 24 Hours;
    • Last 48 Hours;
    • Last 72 Hours;
  • Automatic Updates radio button – when it is on, the displayed information is being updated automatically; otherwise, the information does not update unless you do that manually; in the upper right corner of the report, there is a time stamp of the last update time.

When you have set the desired report parameters, click on the Run Report button to generate a report according to the selected parameters.

To save only a chart, right click on it and select the Save as image... option. Then, select a location to save the image into and click OK.


Go to top


MassTransit Performance Counters


The MassTransit Performance Counters report displays various MassTransit performance counters during the previous 24 hours.

The available charts in this report are:

  • Client, File, & Log Records Updated;
  • Active Connections;
  • Successful vs. Failed Web Logins;
  • Actions, Contacts, Files & Log Entries;
  • Client, Files, & Log Records Update;
  • Connections By Communication Method
  • Successful vs. Failed Connections.

If you click the arrow button in the upper right corner of each small chart, you will be able to view it larger in the area above.

In addition, you can filter the displayed information using the Report Parameters section:

  • Select time span – this drop-down menu has options for faster filtering by the period that is selected; these are the available options:
    • Last 3 Hours;
    • Last 6 Hours;
    • Last 12 Hours;
    • Last 24 Hours;
    • Last 48 Hours;
    • Last 72 Hours;
  • Automatic Updates radio button – when it is on, the displayed information is being updated automatically; otherwise, the information does not update unless you do that manually; in the upper right corner of the report, there is a time stamp of the last update time.

When you have set the desired report parameters, click on the Run Report button to generate a report according to the selected parameters.

To save only a chart, right click on it and select the Save as image... option. Then, select a location to save the image into and click OK.


Go to top


Server Performance Over the Last 24 Hours


The Server Performance Over the Last 24 Hours shows an overview of key server functions such as open connections, SQL server performance, and bandwidth usage over the previous 24 hours.

The available charts in this report are:

  • DBMS SQL Query Performance;
  • MassTransit SQL Usage;
  • MySQL Server Status;
  • TCP/IP Thruput;
  • Number of File Transfer Errors;
  • Total MassTransit Thruput;
  • Amount of Data Sent and Received;
  • Number of Files Sent and Received.

If you click the arrow button in the upper right corner of each small chart, you will be able to view it larger in the area above.

In addition, you can filter the displayed information using the Report Parameters section:

  • Select time span – this drop-down menu has options for faster filtering by the period that is selected; these are the available options:
    • Last 3 Hours;
    • Last 6 Hours;
    • Last 12 Hours;
    • Last 24 Hours;
    • Last 48 Hours;
    • Last 72 Hours;
  • Automatic Updates radio button – when it is on, the displayed information is being updated automatically; otherwise, the information does not update unless you do that manually; in the upper right corner of the report, there is a time stamp of the last update time.

When you have set the desired report parameters, click on the Run Report button to generate a report according to the selected parameters.

To save only a chart, right click on it and select the Save as image... option. Then, select a location to save the image into and click OK.


Go to top


Usage Reports


Most Active Contacts by Bytes Transferred


The Most Active Contacts by Bytes Transferred report shows top 25 active contacts based on number of bytes transferred. The report also gives information about: IP addresses of the contacts, total number of files transferred, total file size transferred in Megabytes, average file size transferred in Megabytes, total transmit time (hours:minutes:seconds), average throughput (KB per minute).

If you click on any of the column titles, the information in the table will be sorted by that column.

Clicking on the chart icons that are in the first row of some of the table columns, the information from the column will be displayed in a chart. To close the chart, click the red x from the top left corner of the chart window.

In addition, you can filter the displayed information by date from the Report Parameters section:

  • Start Date – enter or select a start date from the calendar to filter the errors starting from the chosen date; you can also add/subtract the year or the month in the field by clicking on the corresponding buttons below it;
  • End Date – enter or select an end date from the calendar to filter all errors to the chosen date; you can also add/subtract the year or the month in the field by clicking on the corresponding buttons below it;
  • Common Dates – this drop-down menu has options for faster filtering by the period that is selected; these are the available options:
    • Today;
    • Yesterday;
    • Last 7 Days;
    • Last 14 Days;
    • Last 30 Days;
    • Last 365 Days;
    • Year To Date;
    • Previous Month;
    • Last Year.

When you have set the desired report parameters, click on the Run Report button to generate a report according to the selected parameters.

If you click on the CSV or XML button, you will be able to open/save the report in a *.csv or *.xml file format.

To save only a chart, right click on it and select the Save as image... option. Then, select a location to save the image into and click OK.


Go to top


Most Active Contacts by Files


The Most Active Contacts by Files report shows top 25 active contacts based on number of files transferred.

If you click on any of the column titles, the information in the table will be sorted by that column.

Clicking on the chart icons that are in the first row of some of the table columns, the information from the column will be displayed in a chart. To close the chart, click the red x from the top left corner of the chart window.

In addition, you can filter the displayed information by date from the Report Parameters section:

  • Start Date – enter or select a start date from the calendar to filter the errors starting from the chosen date; you can also add/subtract the year or the month in the field by clicking on the corresponding buttons below it;
  • End Date – enter or select an end date from the calendar to filter all errors to the chosen date; you can also add/subtract the year or the month in the field by clicking on the corresponding buttons below it;
  • Common Dates – this drop-down menu has options for faster filtering by the period that is selected; these are the available options:
    • Today;
    • Yesterday;
    • Last 7 Days;
    • Last 14 Days;
    • Last 30 Days;
    • Last 365 Days;
    • Year To Date;
    • Previous Month;
    • Last Year.

When you have set the desired report parameters, click on the Run Report button to generate a report according to the selected parameters.

If you click on the CSV or XML button, you will be able to open/save the report in a *.csv or *.xml file format.

To save only a chart, right click on it and select the Save as image... option. Then, select a location to save the image into and click OK.


Go to top


Usage Details


The Usage Details report shows server usage by:

  • data transferred by month:

  • data transferred by hour of the day:

  • data transferred by day of the week:

In addition, you can filter the displayed information by date from the Report Parameters section:

  • Start Date – enter or select a start date from the calendar to filter the errors starting from the chosen date; you can also add/subtract the year or the month in the field by clicking on the corresponding buttons below it;
  • End Date – enter or select an end date from the calendar to filter all errors to the chosen date; you can also add/subtract the year or the month in the field by clicking on the corresponding buttons below it;
  • Common Dates – this drop-down menu has options for faster filtering by the period that is selected; these are the available options:
    • Today;
    • Yesterday;
    • Last 7 Days;
    • Last 14 Days;
    • Last 30 Days;
    • Last 365 Days;
    • Year To Date;
    • Previous Month;
    • Last Year.

When you have set the desired report parameters, click on the Run Report button to generate a report according to the selected parameters.

If you click on the CSV or XML button, you will be able to open/save the report in a *.csv or *.xml file format.

To save only a chart, right click on it and select the Save as image... option. Then, select a location to save the image into and click OK.


Go to top


Contact Reports


Files Transferred by Contact


The Files Transferred by Contact report lists all files sent and received by a single contact within specified period.

If you click on any of the column titles, the information in the table will be sorted by that column.

In addition, you can filter the displayed information by date from the Report Parameters section:

  • Start Date – enter or select a start date from the calendar to filter the errors starting from the chosen date; you can also add/subtract the year or the month in the field by clicking on the corresponding buttons below it;
  • End Date – enter or select an end date from the calendar to filter all errors to the chosen date; you can also add/subtract the year or the month in the field by clicking on the corresponding buttons below it;
  • Common Dates – this drop-down menu has options for faster filtering by the period that is selected; these are the available options:
    • Today;
    • Yesterday;
    • Last 7 Days;
    • Last 14 Days;
    • Last 30 Days;
    • Last 365 Days;
    • Year To Date;
    • Previous Month;
    • Last Year;
  • Choose a contact from the popup menu or type a name – in this section you can specify for which contact to generated the report; to filter by a contact, select its user name from the drop-down menu or type it in the field below.

When you have set the desired report parameters, click on the Run Report button to generate a report according to the selected parameters.

If you click on the CSV or XML button, you will be able to open/save the report in a *.csv or *.xml file format.


Go to top


Usage by Contact


The Usage by Contact report displays number and size of files sent and received by specified contacts.

If you click on any of the column titles, the information in the table will be sorted by that column.

In addition, you can filter the displayed information by the following options from the Report Parameters section:

  • Start Date – enter or select a start date from the calendar to filter the errors starting from the chosen date; you can also add/subtract the year or the month in the field by clicking on the corresponding buttons below it;
  • End Date – enter or select an end date from the calendar to filter all errors to the chosen date; you can also add/subtract the year or the month in the field by clicking on the corresponding buttons below it;
  • Common Dates – this drop-down menu has options for faster filtering by the period that is selected; these are the available options:
    • Today;
    • Yesterday;
    • Last 7 Days;
    • Last 14 Days;
    • Last 30 Days;
    • Last 365 Days;
    • Year To Date;
    • Previous Month;
    • Last Year.

When you have set the desired report parameters, click on the Run Report button to generate a report according to the selected parameters.

If you click on the CSV or XML button, you will be able to open/save the report in a *.csv or *.xml file format.

To save only a chart, right click on it and select the Save as image... option. Then, select a location to save the image into and click OK.


Go to top