Chapter 5: AcuServer Functions >

5.7 Tracking Server Statistics

AcuServer has an option to collect and report server statistics. When the COUNT_STATISTICS configuration variable (described in section 4.2.2) is set to "true", you can track memory usage, network reads and writes, socket select calls, and time spent in kernel, user, and idle modes. You can also track access to Vision, relative, and sequential data files, recording the number of file reads, writes, rewrites, deletes, and so on.

---

Note: In order to get memory information, start AcuServer with the new -d option ("acuserve -start -d"). If you do not specify the "-d" parameter, memory is not tracked, and so is reported as 0 at all times.

---

To get a detailed server history, use the command:

acuserve -statistics -t [parameter] [-n port] 

The available parameters are listed below:

Parameter	Short Description	Details
ALL (default)	All statistics	Returns all available statistics for an instance of acuserve
FILE	All data file statistics	Includes file statistics for all Vision, relative, and sequential files
MEMORY	Memory used	Total number of bytes of memory used by AcuServer
NETWORK	Users added	Total number of users who have connected
	Users removed	Total number of users who have disconnected
	Files opened	Total number of files that have been opened
	Files closed	Total number of files that have been closed
	Network bytes read	Total number of bytes read by AcuServer
	Network bytes written	Total number of bytes written by AcuServer
	Immediate select calls	Total number of times select() was called with no timeout
	Immediate select sockets	Total number of sockets returned when select() was called with no timeout
	Timed select calls	Total number of times select() was called with a timeout
	Timed select sockets	Total number of sockets returned when select() was called with a timeout
TIME	% Kernel time, last minute	Percentage of time spent in kernel mode in the last minute
	% Kernel time, last 5 minutes	Percentage of time spent in kernel mode in the last 5 minutes
	% Kernel time, last 15 minutes	Percentage of time spent in kernel mode in the last 15 minutes
	% User time, last minute	Percentage of time spent in user mode in the last minute
	% User time, last 5 minutes	Percentage of time spent in user mode in the last 5 minutes
	% User time, last 15 minutes	Percentage of time spent in user mode in the last 15 minutes
	% Idle time, last minute	Percentage of idle time in the last minute
	% Idle time, last 5 minutes	Percentage of idle time in the last 5 minutes
	% Idle time, last 15 minutes	Percentage of idle time in the last 15 minutes
	Uptime (days hours:minutes)	Amount of time the server has been running
VISION	Vision create	Total number of Vision files created
	Vision open	Total number of Vision files opened
	Vision close	Total number of Vision files closed
	Vision read	Total number of Vision records read dynically
	Vision read next	Total number of Vision records read sequentially (next)
	Vision read previous	Total number of Vision records read sequentially (previous)
	Vision write	Total number of Vision records written
	Vision rewrite	Total number of Vision records rewritten
	Vision delete	Total number of Vision records deleted
	Vision start	Total number of Vision files started
	Vision info	Total number of Vision info calls
	Vision remove	Total number of Vision files removed
	Vision rename	Total number of Vision files renamed
	Vision copy	Total number of Vision file copied
	Vision unlock	Total number of Vision records unlocked
RELATIVE	Relative create	Total number of relative files created
	Relative open	Total number of relative files opened
	Relative unlock	Total number of relative records unlocked
	Relative close	Total number of relative files closed
	Relative read	Total number of relative records read dynamically
	Relative read next	Total number of Relative records read sequentially (next)
	Relative read previous	Total number of relative records read sequentially (previous)
	Relative start	Total number of relative files started
	Relative write	Total number of relative records written
	Relative delete	Total number of relative records deleted
	Relative rewrite	Total number of relative records rewritten
	Relative remove	Total number of relative files removed
	Relative rename	Total number of relative files renamed
	Relative copy	Total number of relative files copied
	Relative info	Total number of relative info calls
SEQUENTIAL	Sequential create	Total number of sequential files created
	Sequential open	Total number of sequential files opened
	Sequential close	Total number of sequential files closed
	Sequential read	Total number of sequential records read
	Sequential write	Total number of sequential records written
	Sequential rewrite	Total number of sequential records rewritten
	Sequential remove	Total number of sequential files removed
	Sequential rename	Total number of sequential files renamed
	Sequential copy	Total number of sequential files copied

---

Note: Information about select() can be used to determine if clients are waiting a long time before getting noticed by AcuServer. When a client has to wait, the number of sockets returned by select() without a timeout will be large, in general, and also large in comparison to the number of calls to select() with a timeout. If the number of sockets returned by calls to select() without a timeout is small, then clients are getting serviced immediately.

---