Chapter 7   (Optional) Using the Server Statistics Controls

The Partner Agent Server logs all file transfers to and from the server. By default, when the Server is installed, a crontab entry is created that runs every night at midnight. This nightly job archives the transfer logs and then runs a statistics generation program on the logs.

The Statistics control pages are where you view server traffic, configure which statistics are logged, view previously generated statistics and generate statistics.

The main pages for viewing and changing the Statistics Controls are:

• Server Usage Monitor



• Server Usage Statistics Control Panel

Server Usage Monitor

---

The Server Usage Monitor page allows you to view traffic on the server in real time. The monitor lists all users currently logged into the server, (by user class and individually), the date and time of their login, user class, process ID of their login session, their transfer command and the bandwidth being consumed.

Figure 7-1    Statistics pages, Server Usage Monitor screen

This screen can be refreshed on a regular basis with the auto refresh feature or can be refreshed instantaneously with the Refresh button.

To generate an instant snapshot of server traffic, click Refresh.

To start repeated automatic updates:

1. Enter the number of seconds between updates in the Auto Refresh Every field.



2. Click Start Auto Refresh.




To disable auto-refresh mode, when it is enabled, click Stop Auto Refresh.

Server Usage Snapshot by User Class

This section lists, on a per user class basis, the number of users logged in, the maximum number of simultaneous users of that class that are allowed to be logged in, and bandwidth being used. It also displays the total network bandwidth being used.

Server Usage Snapshot by Connection

This section lists information about each connection. Next to each entry in the list of connections is a button to kill a connection.

To kill a connection, click Kill next to the connection.

Server Usage Statistics Control Panel

---

The server automatically generates a nightly set of server activity statistics based on the daily transfer logs. These statistics are saved as a set of HTML pages. They are accessed from the Server Usage Statistics Control Panel page.

To access this page, click Statistics on the left-hand side of the screen.

Figure 7-2    Statistics pages, Server Usage Statistics Control Panel screen

Server Usage Statistics Viewer

The Server Usage Statistics Viewer page allows you to view the archive of daily statistics reports. To access this page, from the Server Usage Statistics Control Panel page, click View previously generated statistics.

Figure 7-3    Statistics pages, Server Usage Statistics Control Panel, Server Usage Statistics Viewer screen

A maximum of twenty reports display per page. If there are more than twenty reports, use the Next and Previous links to view more pages of reports.

To view a report, click the appropriate link.

Server Usage Statistics Configuration Manager

The Server Usage Statistics Configuration Manager page allows you to change the settings on the statistics that are generated. Currently all statistics files are archived. You may want to disable one or more of the detailed reports if you are not interested in that level of detail, or if your logs are too large.

To access the Server Usage Statistics Configuration Manager page, from the Server Usage Statistics Control Panel page, click Configure statistics generation.

Figure 7-4    Statistics pages, Server Usage Statistics Control Panel, Server Usage Statistics Configuration Manager screen

On the Server Usage Statistics Configuration Manager page there are a list of report options that can be enabled or disabled. Each option has a checkbox. A checkmark in a item's checkbox means that item is enabled, no checkmark means it is disabled.

The following reports can be enabled or disabled:

Table 7-1    Report   Description

Upload	Statistics about files that were uploaded to the server.
Download	Statistics about files that were downloaded from the server.
Domain	Statistics about the number of different hosts that connected to the server.
Hourly	Statistics about the hourly server traffic during a 24 hour period.

To enable or disable a report:

1. Click in the appropriate checkbox.



2. To commit your changes click Change Stats Settings.

Server Usage Statistics Generator

The Server Usage Statistics Generator page allows you to generate statistics immediately. The default setting of the server is for statistics to be run every night when the nightly Partner Agent Server cron script runs. To access the Server Usage Statistics Generator page, from the Server Usage Statistics Control Panel page, click Generate statistics now.

Figure 7-5    Statistics pages, Server Usage Statistics Control Panel, Server Usage Statistics Generator screen

The initial settings are taken from your statistics settings. You can change the settings before you run the generation process. There are a list of report options that can be enabled or disabled. Each option has a checkbox. A checkmark in a item's checkbox means that item is enabled, no checkmark means it is disabled.

---

Note	Generating statistics could take several seconds or even several minutes for a heavily used server.

---

The following reports can be enabled or disabled:

Table 7-2    Report   Description

Upload	Statistics about files that were uploaded to the server.
Download	Statistics about files that were downloaded from the server.
Domain	Statistics about the number of different hosts that connected to the server.
Hourly	Statistics about the hourly server traffic during a 24 hour period.

To enable or disable a report, click in the appropriate checkbox.

To generate the statistics, click Generate Stats Now.

Once the statistics have been computed (this could take several minutes if you have a lot of traffic on your site), a link displays, that lets you view the statistics results.

To view the results, click Click Here To View The Results.

To return to the Server Usage Statistics Control Panel page, click Main Statistics Control Page.