Internet Client Monitor Application
VTS features both an Internet Client Monitor script application and a VIC Monitor page that is a standard part of all new applications. Applications originally created using a version of VTS less than 8.0 can add the VIC Monitor page.
Both the Internet Client Monitor application and the VIC Monitor page enable you to view statistics on the number of VIC connections that are currently active, and to perform management tasks, such as relaying a message to a selected client workstation, or terminating VIC sessions.
The advantage of the VIC Monitor Page is that, as a page within an application, it is available to operators logging in remotely. This can provide a means of remotely monitoring and controlling VIC connections.
The advantage of the Client Monitor script application is that it can run concurrently with another application. This allows you to monitor and control VIC connections locally while your VTS/VTScada application remains on screen.
Note: The VIC Monitor page, when viewed via a VIC connection, will display only connections to the same realm as the current connection.
When viewed locally, the VIC Monitor page does no realm filtering, so every VIC connection to the current application will be displayed.
The VIC Monitor script application will show all VIC connections.
If the Internet Client Monitor application does not appear in the VAM, you may have to add it. The application directory for the Internet Client Monitor application is named "BrowserMon", and is stored in the VTS installation directory. (If you require instructions on adding an existing application to the VAM, please refer to Adding Existing Applications to the VAM.)
Information is displayed from all servers in the configured VTS/IS cluster.
The Internet Client Monitor application will look similar to the example shown following (broken into two images due to the size of the screen menu).
When one or more users create a VIC connection to any application running on the VTS/IS, the Internet Client Monitor will populate with data, displaying one row for each active connection.
All of the data columns can be sorted in either ascending or descending order. Click on a column title to sort by that column – the first click will sort the rows in ascending order and the next will sort by descending order. An arrow will appear beside the column title to indicate the sort order.
Double-clicking on the edge of a column heading will cause the column to the left to re-size to match the data displayed within it.
The following table lists the Internet Client Monitor’s functions and data:
|
Element |
Description |
|
|
Available only to the script application. The Pin button enables you to set the Internet Client Monitor on top of all other windows. |
|
|
The Logging button allows you to enable VTS/IS event logging. The output file is stored in the "BrowserMon" directory within the VTS installation directory as "Log.txt". This file contains the logged data, delineated by commas. See: Data Logged by the Internet Client Monitor. |
|
|
The Detail button controls whether or not information is displayed for the Client IP, Bytes Transferred, Bytes Received and Compression Ratio columns. By default, detail is not displayed. |
|
|
The Diagnostics button turns on diagnostic logging for subsequent VIC connections. Should you experience problems with your VIC connections, this log may help Trihedral engineers discover the source. VTS Internet Client Name Filter Dialog You will be prompted for a filter that allows you to filter which VIC clients logging is enabled for. Enter an asterisk, * to enable logging for all clients.
The log file will be named VTSDiag.TXT and will be saved to the VIC user’s My Documents directory. |
|
|
The Slay Connection button enables you to terminate the currently highlighted VIC session from the VTS/IS. |
|
|
The Send Message button enables you to send a message to a selected VIC, or to all VICs connected to the VTS/IS. Send Message Dialog
A Message area is provided, in which you can type whatever you wish to broadcast. The message will go only to the selected connection unless you check the Broadcast to all checkbox. |
|
|
The Force Changeover button allows you to force VIC clients to disconnect from this server. If you have configured for Redundant VIC, the client will automatically connect to the next highest ranked available server as defined by the VTS Internet Server List. An intended use for this button and the following one is to allow you to take the current server off-line for maintenance without interrupting any client sessions. |
|
|
The Enable New Clients button allows you to enable or disable new VIC connections to this server. (Enable and Disabled versions of the button shown) Note: Use of the Disable New Clients button remotely is a risky thing to do. Should your own connection be broken before you have re-enable new client connections, you will have to reset this option locally as you yourself will not be able to create a new remote connection. |
|
|
Available only to the script application. The View Custom Data Columns button allows you to display three more columns containing data that you program your application to display. The code required to populate these columns goes beyond the scope of the Developer’s Manual. |
|
Server Name |
Since the internet client monitor displays information from all servers in the VTS/IS cluster, it is important to know which server a particular client is connected to. |
|
Client Name |
Displays the name of the VIC that is currently viewing the application. |
|
Application |
The Application column displays the name of the VTS application that is currently being viewed by each VIC. Note: All of the columns in the Internet Client Monitor window may easily be resized: Rest the mouse pointer over the column's divider until it turns into a horizontal, double-headed arrow, and then click and drag to reposition the divider. |
|
Realm |
The Realm column displays the name of the realm that each VIC is currently connected to. |
|
UserName |
The UserName column displays the name of the user account for each currently logged on user. |
|
Page Name |
The Page Name column displays the name of the page within the VTS application that is currently being viewed by the VIC (if the application is a standard application). |
|
Page Information |
Provides a space for additional information about page to be displayed. The source of the information must be coded in by the developer. For example, if the VIC client is viewing the alarms page, the Page Information column will indicate which list option they are viewing. |
|
Session Time |
The Session Time column displays the duration of each VIC connection. |
|
Client IP Address |
Displays the IP address corresponding to each VIC that is currently connected to the VTS/IS. (Shown only when detail view is enabled) |
|
Bytes Txd |
The Bytes Txd column indicates the number of bytes transmitted from the VTS/IS to the VIC. (Shown only when detail view is enabled) |
|
Bytes Rxd |
The Bytes Rxd column indicates the number of bytes received by the VTS/IS from the VIC. (Shown only when detail view is enabled) |
|
Comp Ratio |
The Comp Ratio column indicates the compression ratio (i.e. the percentage that data has been compressed). (Shown only when detail view is enabled) |
|
Ping Time |
The Ping Time column provides an approximation of the time (in milliseconds) taken to communicate between the VTS/IS and the VIC. (Shown only when detail view is enabled) |
Data Logged by the Internet Client
Monitor