All Things WebSphere
Concerns and issues relating to all versions of WebSphere Application ServerTuesday, March 2, 2010
Dynacache flight recorder wsadmin script
To debug problems or examine the performance characteristics of Dynacache over long runs, we use a wsadmin script to collect cache statistics exposed by the Dynacache mbean at a periodic interval. Looking at these statistics helps understand the state of the cache and troubleshoot any performance issues in the operation of Dynacache. These statistics also help in tuning the cache and improving its effectiveness.
For those customers interested in a deep-dive of cache internals and operations and a wsadmin script for monitoring Dynacache I have provided the script here. The overhead of the script is less than 1%. It is retrieving current cache statistics from the Dynacache mbean. It is acceptable to run this script in a production environment.
The script accepts several parameters required and optional:
-nodeName - The name of the server node. This parameter is required only if the server name is not unique in the cell.
-cacheInstance -The JNDI name of the cache instance for which statistics will be collected. If not specified, statistics will be collected for the base cache only. "*" indicates all cache instances.
-sleepUnit -The unit for sleep intervals. Possible values: hours, minutes or seconds. Default is seconds.
-sleepInterval - The number of sleep units between polls. Default is 10.
-fileAppend - If specified, statistics are appended to the file, if it already exists. Otherwise, the file is recreated. optional
-csvSeparator - The character used for the CSV field separator. Default is ",". optional
-cacheType - An optional filter on caches. A single character should be specified as its value. A value of w or W or m or M specifies WXS-DynaCache, whereas a value of t or T specified traditional Dynacache. By default there cache filtering is turned off. The filter can be conveniently used with the 'cacheInstance' parameter. A parameter combination "-cacheInstance * -cacheType w" will collect statistics for all the configured WXS DynaCache instances in the environment
Usage:
./wsadmin.sh -lang jython -f DynaCacheStatisticsCSV.py <SERVER_NAME> <LOG_FILE> "-nodeName <NODE_NAME> -cacheInstance <*|CACHE_INSTANCE_NAME> -sleepUnit <hours|minutes|seconds> -sleepInterval <SLEEP_UNITS> "
Sample Usage:
nohup ./wsadmin.sh -user
WC_wcsperf1 is the server name, app11 is the node name and /wcsuser/scripts/dcmon/disk_cache_debug.log is the file that contains the recorded statistics.
Please verify that the cache statistics file is being written too once the wsadmin script is kicked off. Once the test run is over suck the cache statistics log file into microsoft excel or open-office as a CSV file and graph the relevant statistics. Interpretation of the statistics will be in a subsequent blog post.
Archives
December 2006 September 2008 January 2009 February 2009 March 2009 September 2009 October 2009 November 2009 December 2009 January 2010 February 2010 March 2010 April 2010 October 2010 January 2011 February 2011 April 2011 May 2011 June 2011 July 2011 August 2011 September 2011 October 2011 November 2011 December 2011 January 2012 February 2012 March 2012 April 2012 May 2012 June 2012 July 2012 August 2012 September 2012 October 2012 November 2012 January 2013 May 2013 June 2013 July 2013 September 2013 October 2013 June 2014 August 2014
Subscribe to Posts [Atom]
Post a Comment
Note: Only a member of this blog may post a comment.