Collecting user statistics
Open Text Social Workplace lets you collect selected user activity statistics into a statistics file that by default is created daily at midnight. By default, each user record in the file 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.
Note
You must create a folder where Open Text Social Workplace will place the user statistics file before this file is generated. This folder can have any name and can be located on any writable volume accessible to the server.
Examples of paths for this folder are:
C:\Stats
D:\FCServer\Stats
If the server isn't running at midnight, the new daily file will begin when the server is restarted.
You should delete user statistics files regularly to maintain disk space availability. We recommend that you back up these files before deleting them in case you need them later to troubleshoot an ongoing problem.
Specifying what to record in the user statistics file
To customize what Open Text Social Workplace records in the user statistics file:
1 Open the Reports folder.
2 Open the Statistics Control form.
3 Update this form to specify the statistics to record.
For information about the fields on this form, click here.
Demystifying the user statistics file format
When you open the user statistics file with a plain text editor, you'll see fields separated by the delimiter used by the log format you chose on the Statistics Control form.
You can also import this file into a spreadsheet program.
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; the 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.
Viewing server statistics
You can see a cumulative summary of all server events that have occurred since the server was first installed in the server statistics file. This file is called stats.txt and is located in the Reports\Statistics Folder.
This file is updated daily at midnight. If the server isn't running at midnight, the new daily file will begin when the server is restarted.
The server statistics file contains the following information:
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 |
Server statistics |
|
Total Deliveries |
number of messages delivered |
Recoveries |
number of server recoveries (from power failures, and so on) |
Users Added |
number of user accounts added |
Users Deleted |
number of user accounts deleted |
Rejected Sessions |
number of times users could not connect because all sessions were in use. If this number is high, you might consider purchasing additional sessions. |
Auto-registers |
number of autoregistrations |
Write Protects |
number of times the server entered write-protect mode because of a lack of disk space or an excessive number of files. If this number is high, consider moving your FirstClass system to a volume with a larger storage capacity. |
Resetting server statistics counters
To reset server statistics counters, simply delete the stats.txt file.
|