Small company logo:
   History
 
Advertising banner:
 
 F22800
Home • Help • Administering OTSW • F22800
 
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.
06092010_122716_1.pngNote
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.