Real-time Zope request analysis based on haufe.requestmonitoring
Project description
Introduction
haufe.ztop implements real-time Zope request analysis on top of haufe.requestmonitoring.
Requirements
Zope 2.12.0b2 or higher (or a Zope 2 trunk checkout)
haufe.requestmonitoring
Features
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.
zanalyse
Using zanalyse:
zanalyse [-i intervall] [-n numberLongRequests] [[-b] requestsBasename] [[-d] startDate]
prints an ‘sar’ like requests summary from the Zope requests log file identified by requestsBasename and startDate.
The ‘-i’ option specifies the granularity in minutes. It defaults to “10”.
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.
Example output:
$ bin/zanalyse -i 10 instance short load reqs rate avg min max median 0.05 217 0.36 145 3 24640 5 24640 /manage_menu 1385 /manage_main 1291 /Partner/manage_main 552 /Applikationen/manage_main 326 /Partner/manage_workspace 301 /manage_main 204 /p_/zopelogo_jpg 94 /Administration/manage_main
ztop
Using ztop:
ztop [-i interval] [-s shortPeriod] [-m medPeriod] [-l longPeriod] [-n numberLongRequests [-t time] [-r]] [[-b] requestsBasename] [[-d] startDate]
displays request information by analysis of the Zope requests log file identified by requestsBasename and startDate.
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.
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.
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’.
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.
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.
Example output:
$ bin/ztop -i 10 instance short load reqs rate avg min max median 0.00 4 0.03 9 4 25 4 25 /Control_Panel/ZTop/manage_monitor 4 /p_/ltab 4 /p_/sp med load reqs rate avg min max median 0.00 20 0.03 17 4 146 8 146 /Control_Panel/ZTop/manage_monitor 25 /Control_Panel/ZTop/manage_monitor 25 /Control_Panel/ZTop/manage_monitor long load reqs rate avg min max median 0.01 468 0.13 90 3 24640 6 24640 /manage_menu 1788 /Auftritte/manage_main 1385 /manage_main
Installation
add haufe.ztop to the eggs option of your buildout configuration
create the related scripts using a dedicated ztop part:
[buildout] parts = ... ztop ... [ztop] recipe = zc.recipe.egg eggs = haufe.ztop
Maintainer
Andreas Jung, Haufe Mediengruppe
License
haufe.ztop is published under the Zope Public License V 2.1 (ZPL) See LICENSE.txt.
Changelog
0.2.2 (2009/08/11)
additional fixes to zanalyse.py
0.2.1 (2009/08/11)
fixed spelling of ‘zanalyse’
0.2.0 (2009/05/12)
Initial release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file haufe.ztop-0.2.2.tar.gz
.
File metadata
- Download URL: haufe.ztop-0.2.2.tar.gz
- Upload date:
- Size: 10.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 40f985f1bef5436021d0940274d3c374f8061defc52b906812400e3a1170a661 |
|
MD5 | 055426db0c69027e65661f59c46a52f9 |
|
BLAKE2b-256 | 1f8d3dce580ecd39bc08ad40fc52078c511144ff005683caf5326b77f8f21659 |