haufe.ztop 0.2.2

haufe.ztop implements real-time Zope request analysis on top of haufe.requestmonitoring.<br /><br />Features<br /><br />Before you can use any of these scripts you have to make sure that your Zope environment is known to the shell. A simple zopectl shell should be enough in most cases.<br />zanalyse<br /><br />Using zanalyse:<br /><br />zanalyse [-i intervall] [-n numberLongRequests] [[-b] requestsBasename] [[-d] startDate]<br /><br />prints an 'sar' like requests summary from the Zope requests log file identified by requestsBasename and startDate.<br /><br />The '-i' option specifies the granularity in minutes. It defaults to "10".<br /><br />requestsBasename is either an instance tag (in which case it expands to '/var/log/zope/requestsBasename/zope_requests.') or the name of a zope requests file (not ending in '.') or of a zope requests file family (ending in '.'). requestsBasename defaults to the instance tag 'Main'. startDate must have the format year, month and day, each with 2 digits e.g. '040803'. It defaults to the current date. Note that requestsBasename must be an instance tag or a family name, when you default startDate.<br /><br />Example output:<br /><br />$ bin/zanalyse -i 10 instance<br /><br />short load reqs rate avg min max median<br /> 0.05 217 0.36 145 3 24640 5<br /> 24640 /manage_menu<br /> 1385 /manage_main<br /> 1291 /Partner/manage_main<br /> 552 /Applikationen/manage_main<br /> 326 /Partner/manage_workspace<br /> 301 /manage_main<br /> 204 /p_/zopelogo_jpg<br /> 94 /Administration/manage_main<br /><br />ztop<br /><br />Using ztop:<br /><br />ztop [-i interval] [-s shortPeriod] [-m medPeriod] [-l longPeriod]<br /> [-n numberLongRequests [-t time] [-r]] [[-b] requestsBasename] [[-d] startDate]<br /><br />displays request information by analysis of the Zope requests log file identified by requestsBasename and startDate.<br /><br />Information contains summaries for up to three periods: 'short', 'med' and 'long'. Their length is given by shortPeriod (default: 120), medPeriod (default: 600) and longPeriod (default: 3600) in seconds. Summaries contain load averaged over the period, number of finished requests, request rate, average, min, max and median request times (in ms) and the numberLongRequests (default: 3) longest requests in this period. A period length of "0" suppresses information about this period.<br /><br />The information is repeated every interval seconds. interval defaults to the value of shortPeriod or 120. A "0" value causes 'ztop' to stop after one display.<br /><br />The '-t' option tells 'ztop' to display information for time and then to stop. time is an ISO datetime or time value, e.g. '2004-08-03T12:00:00' or '12:00:00'.<br /><br />The '-r' option tells 'ztop' to display information for the last restart time and then to stop. '-r' is equivalent to '-t <restartTime>'. This is meant to facilitate the analysis of restarts.<br /><br />requestsBasename is either an instance tag (in which case it expands to '/var/log/zope/requestsBasename/zope_requests.') or the name of a zope requests file (not ending in '.') or of a zope requests file family (ending in '.'). requestsBasename defaults to the instance tag 'Main'. startDate must have the format year, month and day, each with 2 digits e.g. '040803'. It defaults to the current date. Note that requestsBasename must be an instance tag or a family name, when you default startDate.<br /><br />Example output:<br /><br />$ bin/ztop -i 10 instance<br /><br />short load reqs rate avg min max median<br /> 0.00 4 0.03 9 4 25 4<br /> 25 /Control_Panel/ZTop/manage_monitor<br /> 4 /p_/ltab<br /> 4 /p_/sp<br /><br /> med load reqs rate avg min max median<br /> 0.00 20 0.03 17 4 146 8<br /> 146 /Control_Panel/ZTop/manage_monitor<br /> 25 /Control_Panel/ZTop/manage_monitor<br /> 25 /Control_Panel/ZTop/manage_monitor<br /><br /> long load reqs rate avg min max median<br /> 0.01 468 0.13 90 3 24640 6<br /> 24640 /manage_menu<br /> 1788 /Auftritte/manage_main<br /> 1385 /manage_main<br /><br />Installation<br /><br /> * add haufe.ztop to the eggs option of your buildout configuration<br /> * create the related scripts using a dedicated ztop part:<br /><br /> [buildout]<br /> parts = ... ztop ...<br /><br /> [ztop]<br /> recipe = zc.recipe.egg<br /> eggs = haufe.ztop

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	Control Panelztopmanage Monitor,  Default,  Defaults,  Ending,  Family,  Haufeztop,  Information,  Instance,  Interval,  Median,  Option,  Period,  Request,  Requests,  Requestsbasename,  Shortperiod,  Ztop
Users rating:	0/10