 |
About Statistics and Billing / Reporting
Monitoring system usage
The Server Monitor provides information about how your system is performing by displaying what tasks the server is currently running, the current load on your hardware, and a summary of what has happened since the server was last restarted. To view the Server Monitor, open the Core Services folder on the administrator's Desktop. The Server Monitor also provides information about FirstClass services and mirrored volumes.
The Session Monitor is a real-time online display showing the names of logged-in users and what they are doing. To view the Session Monitor, choose Admin > Session Monitor, or open the Core Services folder on the administrator's Desktop. Some tasks you can perform from this window are logging off users, viewing users' Desktops, or viewing users' résumés.
The Session Monitor
The Session Monitor is a real-time online display showing the names and activities of logged-in users. To start the Session Monitor, choose Admin > Session Monitor, or double-click Monitors and then Session Monitor.
The Session Monitor displays a row for each active session.
Column |
Description |
|
Connection Protocol - An icon indicates the connection protocol used to connect to the FirstClass server. |
ID |
|
|
Connection type - An icon indicates the type of connection. Note that all Internet connections have a single icon with characters indicating different protocols. For more information, see the Connection type icons table. |
|
Empty/Full - Indicates whether the user is approaching his daily connection limit or the inactivity limit. |
Name |
The user’s full name. |
User ID |
The user’s user ID. |
Action
|
The action the user is currently performing. If the field is blank, the user has performed no action in the last minute. |
Last Object |
The last object the user used. |
Open Objects |
All objects the user has open. |
Connection type icons
|
Mac OS X |
|
Windows |
|
Gateway |
|
Voice Services |
|
Internet Services |
|
Java |
|
HTTP |
|
LDAP |
|
NNTP |
|
FTP |
|
Finger |
|
IMAP4 |
|
SMTP |
|
|
Disk use statistics
When FirstClass performs an audit, it produces a Disk Usage report. This report records how much hard disk space is used by each of your users. A Disk Usage report is named DiskUse.txt.
Note
If audit does not run to completion (it reaches the scheduled end time before auditing all items in the network store), a diskuse.tmp file will be created. This file will be appended during the subsequent audit(s) until the entire network store has been audited. It will then be named diskuse.txt.
You can view a disk use statistics file using FirstClass or a text editor, or import it into a spreadsheet (see your spreadsheet program documentation for details).
The report contains a one-line entry for each user, with the following information:
• first column - the user's unique user ID
• second column - the name of the volume on which the user account is registered
• third column - the total space
For performance reasons, FirstClass no longer maintains this field. For backward compatibility with log analysis programs, this field remains, but is always zero.
• fourth column - the total number of files
For performance reasons, FirstClass no longer maintains this field. For backward compatibility with log analysis programs, this field remains, but is always zero.
• fifth column - the total referenced space
The total size, in kilobytes, of incoming and outgoing messages, documents, and uploaded files in the user's Mailbox and folders.
• sixth column - the total referenced files
The total number of incoming and outgoing messages, documents, and uploaded files in the user's Mailbox and folders.
• seventh column - the user's privileges
Special privileges granted to the user. This field can contain one or more of the following:
A - administrator (or subadministrator)
E - edit user information
U - view unlisted
V - view user information.
P indicates that the user's account was only partially audited.
Viewing a Disk Usage file using FirstClass
To view a Disk Usage report while you are logged into FirstClass:
1 Open the Reports folder on the administrator's Desktop.
2 Open the the Statistics Folder.
3 Hold down the shift key and double-click DiskUse.txt.
Viewing a Disk Usage file using a text editor
To view a Disk Usage report when you are not logged into FirstClass:
1 Open the FCNS folder (Windows) or fcns folder (Mac OS X) on your hard drive.
2 Open the Stats.dir folder.
3 Download the DiskUse.txt file to your computer.
4 Open the downloaded copy of DiskUse.txt.
Releasing disk space
In your System Profile, you can configure the minimum free disk space required on each volume on your server. When the amount of free disk space on a volume is less than or equal to this amount, the server refuses to accept messages from users or gateways on that volume.
There are several ways you can free up space:
• Use the Disk Usage report to identify users who are using excessive space. Ask these users to clean out their Mailboxes.
• Look for and delete files with large attachments (remove and delete the attachments before deleting the files).
• Make sure all aliases of a deleted item are also deleted. The space an item takes up is recovered only when all copies are deleted. Deleting a large file recovers no space unless the alias is also deleted from the sender's Mailbox (and from the Mailboxes of all other recipients).
• Delete old statistics and log files. We suggest that you back up these files before you delete them, in case you need to troubleshoot a recurring problem.
In Mac OS X, the statistics files are located in fcns\stats.dir. The log files are located in fcns\logfiles.
In Windows, the statistics files are located in FCNS/STATS.DIR. The log files are located in FCNS/LOGFILES.
To recover freed disk space, trash collection must be run after files are deleted. You can force a trash collection immediately, or wait until the next scheduled trash collection takes place.
User statistics
FirstClass lets you collect selected user activity statistics. By default, each record contains user ID, time, and date fields, plus other fields specific for the record type. A user statistics file is named either yymmdd or yymmddI where yymmdd is the date the log file was created and 'I' at the end of the date signifies the file is for Internet user statistics only. This file is updated daily at midnight. If the server is not running at midnight, the new daily file will begin when the server is restarted.
Creating customized user statistics reports
1 On the administrator's Desktop, open the Reports folder.
3 Complete the fields.
The number of actions you select and the activity level on your FirstClass system determines the size of your statistics file.
5 Close the form and save your changes.
Viewing a user statistics file
1 Open the folder you specified in the "Statistics folder path" field on the Statistics Control form.
2 Open any of the files that you wish to view.
The files open in TextEdit (Mac OS X) or Notepad (Windows).
The user statistics file format
A user statistics file consist of fields that are separated by the delimiter you specified on the Statistics Control form.
These are the common field types that can be applied to each record:
• the user ID (userID) of the user performing the action
• the date (date) the action was performed, in the format ddmmyy
• the time (time) the action was performed, in the format hh:mm:ss am|pm
• the IP address (IP address) of the computer where the action was performed
• the user's primary organizational unit (OU)
• the unique file ID (fileID) of the file or folder being processed.
FirstClass uses file IDs to access the files and folders on a volume
• the client ID (clientID)of the user performing the action.
FirstClass assigns a unique client ID to each user. The client ID is never assigned to another user.
• the message ID (messageID) of the message being processed
Every message in FirstClass has a unique message ID.
• the name of the object (obj name) being processed
• the type of object (obj type) being processed
• the parent object (parent obj) of the object being processed
An example of this is a conference item's parent object would be the conference.
• the file size (in bytes) (file size) of the object being processed.
• the IP address (if selected) of the client machine where the action was performed.
• the primary organizational unit (OU) (if selected) of the user performing the action.
User activities in the Journaling section
Record |
Action that generates this record: |
Checkboxes that generate this record |
Record format |
AddUser |
A user is added with the Admin > Add New User command. |
Add, Del, Change User |
AddUser, user ID, date, time, IP address, OU, new user ID, last name, first name, initial, client ID |
ApplyModel |
A user group's Model Desktop is updated and the remodel is applied to its members. |
Modeling |
ApplyModel, userID, date, time, IP address, OU, priv group name |
Approve |
A user approves or unapproves an object. |
Approve Items |
Approve, userID, date, time, IP address, OU, approved, conference, messageID, fileID where approved can be 0 (approved) or 1 (unapproved) |
Attach |
A file is successfully attached to a message. |
Upload/ Attach |
Attach, userID, date, time, IP address, OU, filename, file size, messageID |
ChangeUser |
A user info form is changed.
|
Add/Del/ Change user
|
ChangeUser, userID, date, time, IP address, OU, changed userID
|
Close |
An object (such as a message, folder, or conference) is closed. |
Object open |
Close, userID, date, time, IP address, OU, type, name, parent obj |
CommLinkFail |
A client/server link is broken. A logout record is generated at the same time. Use this record to identify modem/ TCP problems. |
Comm link failure, Modem carrier loss |
CommLinkFail, userID, date, time, IP address, OU, session number |
ConfDelivery |
An item is sent to a conference. |
Delivery to conference |
ConfDelivery, server, date, time, IP address, OU, conference name, from name, subject, messageID where conference name is the name of the conference to which the item was delivered, and from name is the name of the system on which the item originated (for items received from a gateway) |
ConfItemDel |
An item is deleted from a conference. |
Conference item delete |
ConfItemDel, userID, date, time, IP address, OU, subject, messageID, fileID |
ConfPermissions |
A user views the permissions of a conference. |
Conf. permissions, Edit conf. permissions |
ConfPermissions, userID, date, time, IP address, OU, obj name, fileID |
ConfSubscribe |
A user is granted a subscription to a conference. |
Conference subscribe |
ConfSubscribe, userID, date, time, IP address, OU, obj type, obj name, subscribed user ID |
Control |
A Control menu command is chosen from the Admin menu. |
Control/Sys/Broadcast |
Control, userID, date, time, IP address, OU, control command, success where success can have the value zero (successful) or Error 1030 (Access Denied) |
Create |
An object (such as a message, conference, or folder) is created. |
Message create, Conf. create /delete |
Create, userID, date, time, IP address, OU, obj type, parent obj, fileID |
DeleteUser |
A user account is deleted with the Admin > Delete User command. |
Add/Del/ Change user |
DeleteUser, userID, date, time, IP address, OU, deleted userID |
Directory |
A user searches the Directory. |
Directory search |
Directory, userID, date, time, IP address, OU, pattern |
Download |
A user downloads, from a conference, a file that is not attached to a message. |
Download/ Save attach |
Download, userID, date, time, IP address, OU, filename, messageID, fileID |
GetInfo |
A user chooses File > Get Info (Mac OS/Mac OS X) or Properties (Windows) to display information about an object. |
Get info |
GetInfo, userID, date, time, IP address, OU, obj name, fileID |
History |
A user displays the history of a message. |
View history |
History, userID, date, time, IP address, OU, subject, messageID, fileID |
Login |
A user logs in.
|
Session (login/ logout), Gateways
|
Login, userID, date, time, IP address, OU, interface, platform, link type, session #, modem speed, client version, protocol, network address where interface can be GUI, CLUI, or Gateway platform can be Mac OS, Windows, DOS, or VT100 link type can be Serial or LAN client version can be 7000 (version 7.0) and so on protocol can be AppleTalk, IPX, TCP/IP, or Local Network address can be: • network.node.socket in decimal (for example, 2.56.235) (AppleTalk) • network.node.socket in hexadecimal (for example, 000000D3.00-C2-EE-00-01-34.4032) (IPX) • IP address in dot format (for example, 198.133.37.10) (TCP/IP) |
Logout |
The server terminates a session, either because the user has logged off or the user's time has expired. |
Session (login/ logout) |
Logout, userID, date, time, IP address, OU, seconds since login |
MsgDelete |
A user deletes a message from his or her Mailbox. |
Message delete |
MsgDelete, userID, date, time, IP address, OU, subject, messageID, fileID |
MsgDelivery |
A message is delivered to a gateway or a user's Mailbox. |
Delivery to Mailbox |
MsgDelivery, server, date, time, IP address, OU, to, from, subject, messageID |
MsgForward |
A user forwards a message. Autoforwarded messages do not generate MsgForward records. |
Message forward |
MsgForward, userID, date, time, IP address, OU, subject, messageID, fileID |
MsgReply |
A user replies to a message. Autoreplied messages do not generate MsgReply records. |
Message reply |
MsgReply, userID, date, time, IP address, OU, subject, messageID, fileID |
Open |
An object (such as a message, conference, or folder) is opened. |
object open, Private chatting, Public chatting |
Open, userID, date, time, IP address, OU, obj type, obj name, fileID |
OpenDesktop |
The administrator opens a user's Desktop. |
Open user Desktop |
OpenDeskTop, userID, date, time, IP address, OU, opened userID |
Password |
A user tries to change his or her password. |
Password change |
Password, userID, date, time, IP address, OU, success where success can have the value 1030 (Access Denied), 1035 (Password Incorrect), or 0 (Successfully Changed) |
Résumés |
A user looks at a résumé or user info form. |
View résumés, View conference info |
Résumé, userID, date, time, IP address, OU, whose résumé, clientID, type where type can be zero (résumé) or 1 (user information form) |
SaveAttach |
A user saves a file attached to a message. |
Download/ Save attach |
SaveAttach, userID, date, time, IP address, OU, attachment name, file size, messageID |
Search |
A user performs a search. |
Searching |
Search, userID, date, time, IP address, OU, parent obj, search string, flags, number of hits, duration in seconds where flags indicates the checkboxes selected on the search form |
Upload |
A user uploads, to a conference, a file that is not attached to a message. |
Upload/ Attach |
Upload, userID, date, time, IP address, OU, filename, file size, fileID |
WhosOnline |
A user chooses Collaborate > Who's Online. |
Who's online |
WhosOnline, userID, date, time, IP address, OU, search pattern where search pattern is always empty |
Server statistics
The server statistics file (Stats.txt) is a cumulative summary of all server events that have occurred since the server was first installed. This file is updated daily at midnight. If the server is not running at midnight, the new daily file will begin when the server is restarted.
You can view a server statistics file using FirstClass or a text editor (see Disk use statistics), or import it into a spreadsheet (see spreadsheet program documentation for details).
The server statistics file is presented in standard, comma-delimited format, and contains the following information:
• Remote user statistics
Total Logins |
number of logins |
Total Opens |
number of windows opened |
Total Closes |
number of windows closed |
Total Creates |
number of messages and files created |
Total Submits |
number of messages sent |
Total DirSearches |
number of times the Directory was searched |
Total Timeouts |
number of sessions that ended because the daily time limit was exceeded |
Total Failed UIs |
number of sessions that ended because of link failures |
Bytes Uploaded |
number of bytes transferred to the server (uploaded files and attachments) |
Bytes Downloaded |
number of bytes transferred from the server (downloaded files and attachments) |
Total Connect |
total time all users were connected |
|