Skip to main content

zps - A zope processes inspector

zps is addressed to the manager of zope and plone sites that want to get quickly get informations about the running instances of zope.

Installation

easy_install psutil
easy_install rt.zps

Thanks to @der_sven_ you can find up to date debian packages here:

Usage

zps basic usage is straightforward:

[user@localhost]$zps
CWD:      /home/user/plone1
User:     user
PID:      1234
Conf:     /home/user/plone1/parts/instance/etc/zope.conf
Address:  8081
Memory:   1.96%

CWD:      /home/user/plone2
User:     user
PID:      12345
Conf:     /home/user/plone2/parts/instance/etc/zope.conf
Address:  8082
Memory:   1.96%

The default action is to report, for each running instance of zope that it founds:

  • the Current Working Directory (CWD)

  • the id of the user who is running the process

  • the process PID

  • the zope configuration file used by the instance

  • the port (as calculated parsing the configuration file)

  • the memory usage

To obtain usage information for zps just type zps –help, you will get this:

[user@localhost]$zps
zps - report a snapshot of the current zope processes.

USAGE:
zps
zps --help
zps --pid 1111
zps --port 8080
zps --grep plone

As you can see zps can filter the results per zps or port, e.g., if calling zps returns the report about the two instances above, you will have the following:

[user@localhost]$zps --pid 1234
CWD:      /home/user/plone1
User:     user
PID:      1234
Conf:     /home/user/plone1/parts/instance/etc/zope.conf
Address:  8081
Memory:   1.96%

[user@localhost]$zps --port 8082
CWD:      /home/user/plone2
User:     user
PID:      12345
Conf:     /home/user/plone2/parts/instance/etc/zope.conf
Address:  8082
Memory:   1.96%

In the case no instance is found, you will have:

[user@localhost]$zps
No running zope instance found

TODO: filter output information It may happen that your server starts to be crowded. In that case the output of zps is quickly parsable. Two command line flags should then be introduced:

  • –show

  • –hide

TODO: colorize output It would be a nice feature to highlight with colors the memory usage. If the output is in the range:

  • 0%-5%: green

  • 0%-10%: yellow

  • 10%-20%: red

  • 20%-100%: blinking red

Examples

[user@localhost]$zps --hide CWD,User,Memory
PID:      1234
Conf:     /home/user/plone1/parts/instance/etc/zope.conf
Address:  8081

PID:      12345
Conf:     /home/user/plone2/parts/instance/etc/zope.conf
Address:  8082

[user@localhost]$zps --hide CWD,User,Memory
CWD:      /home/user/plone1
User:     user
Memory:   1.96%

CWD:      /home/user/plone2
User:     user
Memory:   1.96%

Changelog

0.9.6 (2014-03-20)

  • psutils 2 compatibility [alert]

0.9.5 (2014-02-14)

  • Python3 compatibility [alert]

0.9.4 (2012-10-29)

  • fixing a crash when zope.conf file is not found [alert]

  • handling help flags, fixes #1, fixes #2 [alert]

  • cosmetic fixes [alert]

0.9.3 (2012/02/10)

  • moved to github [ale-rt]

  • heavy refactoring [ale-rt]

  • added –grep flag [ale-rt]

  • fix address calculations [ale-rt]

  • sorting process list [ale-rt]

  • tests [ale-rt]

0.9.2 (2010/06/10)

  • Fixed documentation [keul]

  • Fixed computing addresses in the form of ip:port [alert]

0.9.1 (2010/06/10)

  • Fixed egg structure [fdelia]

  • pid option [alert, fdelia]

  • port option [alert, fdelia]

  • Refactoring [alert]

  • Documentation [alert]

0.9.0 (2010/05/05)

  • Initial release [alert]

Metadata

Release files for rt.zps 0.9.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rt.zps 0.9.6
File Size Uploaded Provenance Actions
rt.zps-0.9.6.zip 23.1 kB Without provenance Details for rt.zps-0.9.6.zip

Release files / rt.zps-0.9.6.zip

Download URL rt.zps-0.9.6.zip
Size 23.1 kB
Tags Source
SHA-256 checksum
How to use checksums
c69038f5a4d6c603c441c46aff4bcf0851197b1579d71fa4892ab51428ac7c7f
BLAKE2b-256 checksum
How to use checksums
b15f5998ab27976ea021bdf69785da5b2811dd928f69c57f0b4d338b65e36649
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for rt.zps 0.9.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page