Server 'Stats' command received and smpolicysrv -stats command output explanations in Policy Server
Article ID: 15867
Updated On:
Products
Issue/Introduction
The Siteminder Policy Server can dump the statistics in real time into the 'smps.log' file.
Here is an example of the output in the 'smps.log' file from the 'smpolicysrv -stats' command:
[8688/2216][][CServer.cpp:8242][INFO][sm-Server-02360] Server 'Stats' command received
[8688/2216][][CServer.cpp:4958][INFO][sm-Server-01990] ===================================================================================
[8688/2216][][CServer.cpp:4959][INFO][sm-Server-02000] System Statistics
[8688/2216][][CServer.cpp:5000][INFO][sm-Server-02020] Thread pool limit: 8
[8688/2216][][CServer.cpp:5003][INFO][sm-Server-02030] Thread pool: Msgs=0 Throughput=0.000000/sec Response Time=0.000000ms Wait Time In Queue=0.000000ms Max HP Msg=0 Max NP Msg=0 Current Depth=0 Max Depth=0 Current High Depth=0 Current Norm Depth=0 Current Threads=8 Max Threads=8 Busy Threads=0
[8688/2216][][CServer.cpp:5004][INFO][sm-Server-02040] Connections: Current=0 Max=0 Limit=256 Exceeded limit=0
[8688/2216][][CServer.cpp:5005][INFO][sm-Server-01990] ===================================================================================
Environment
Policy Server 12.8 and 12.9
Resolution
This output in the smps.log can be logged when running manually the command in a command line:
smpolicysrv -stats
This can also be configured to run as a job and automatically dump the Policy Server statistics into the 'smps.log' file on a recurring basis (1).
This is extremely useful for getting insight into the health of the server and for troubleshooting purposes.
Note :
-stats: This switch produces current server runtime statistics such as thread pool limit, thread pool message, and the number of connections.
-resetstats: This switch resets the current server runtime statistics without restarting the Policy Server.
Stats Information:
Thread pool:
Msgs : This is the total number of requests that have been removed from the queue.
Throughput : Average number of request processed per second (see Additional Information section of this document for calculation details)
Response Time : Average response times.
Wait Time In Queue : Average time interval between Enqueue and Dequeue of the messages (request) from the queue
Max HP Msg : Maximum number of High Priority messages on the queue since the last reset of stats
Max. NP Msg : Maximum number of Normal Priority messages on the queue since the last reset of stats
Current Depth : Number of messages in the queue at the time of executing -stats
Max Depth : Maximum number of messages in the queue since the last rest of stats
Current High Depth : Number of High Priority messages in the queue at the time of executing -stats
Current Norm Depth : Number of Normal Priority messages in the queue at the time of executing -stats
Current Threads : Number of worker threads running at the time of executing -stats. This includes sum of busy and idle worker threads.
Max Threads : Maximum number of worker thread at any time.
Busy Threads : Number of worker threads actively processing request at the time of executing -stats
Deprecated Thread Pool information (available in older releases) :
Waits: This is the number of times that a thread went to get a request from the queue to process, but had to wait for one to arrive.
Misses: This is the number of times that a thread went to get a request from the queue to process, had to wait for one to arrive, but none came in before the thread went back to sleep.
Connections
Current : Current number of agent connections
Max : Maximum number of agent connections
Limit : Maximum allowable agent connections
Exceeded Limit : Number of times the connection limit was exceeded.
Thread and Connection Tuning
Some of these connections parameters can be configured by modifying the Siteminder Policy Server registry
Windows: regedit.exe
Linux: <Install_Dir>/siteminder/registry/sm.registry
Registry Hive: HKEY_LOCAL_MACHINE\SOFTWARE\Netegrity\SiteMinder\CurrentVersion\PolicyServer\
Key Name: Thread Pool Initial Size
Type: REG_DWORD
Default: 8
Purpose: Specifies the minimum number of worker threads that Policy Server opens on startup.
Key Name: Thread Pool Size
Type: REG_DWORD
Default: 8
Purpose: Specifies the maximum number of worker threads that can be opened.
Key Name: Tcp Max Server Connections
Type: REG_DWORD
Default: 256
Purpose: Specifies the maximum number of allowable agent connections.
Key Name: PriorityThreadCount
Type: REG_DWORD
Default : 5
Max : 20
Purpose: Number of High Priority Threads. (threads allocated to process high priority handshake messages)
NOTE: A value less than five or greater than 20 disables the registry key.
Additional Information
Feedback
