Siteminder Policy Server output from 'smpolicysrv -stats' explained
search cancel

Siteminder Policy Server output from 'smpolicysrv -stats' explained

book

Article ID: 15867

calendar_today

Updated On:

Products

CA Single Sign On Secure Proxy Server (SiteMinder) CA Single Sign On SOA Security Manager (SiteMinder) CA Single Sign-On

Issue/Introduction

The Siteminder Policy Server can dump the statistics in real time into the 'smps.log' file.  This is done either by manually running the 'smpolicysrv -stats' command.  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.  This is extremely useful for getting insight into the health of the server and for troubleshooting purposes.

Environment

PRODUCT: Siteminder

COMPONENT: Policy server

VERSION: 12.8.x

Resolution

Here is an example of the output in the 'smps.log' file from the 'smpolicysrv -stats' command:

[8688/2216][<Date> <Time>][CServer.cpp:8242][INFO][sm-Server-02360] Server 'Stats' command received
[8688/2216][[<Date> <Time>][CServer.cpp:4958][INFO][sm-Server-01990] ===================================================================================
[8688/2216][[<Date> <Time>][CServer.cpp:4959][INFO][sm-Server-02000] System Statistics
[8688/2216][[<Date> <Time>][CServer.cpp:5000][INFO][sm-Server-02020] Thread pool limit: 8
[8688/2216][[<Date> <Time>][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][<Date> <Time>][CServer.cpp:5004][INFO][sm-Server-02040] Connections: Current=0 Max=0 Limit=256 Exceeded limit=0
[8688/2216][[<Date> <Time>][CServer.cpp:5005][INFO][sm-Server-01990] ===================================================================================

   

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 this parameter 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

Powered by Wolken Software