collective.catalogtrace 1.0.0

Log details about ZCatalog query performance

collective.catalogtrace

Log details about ZCatalog query performance

Features

Logs details about each ZCatalog query:

• Query parameters
• Where the query was called
• Detailed execution:
  • Index name
  • Elapsed time
  • Count of persistent objects loaded
  • Count of new objects tracked by the Python GC

This information can be used to troubleshoot poor query performance.

There is some overhead to recording these measures.

Tracing is enabled for all queries if the TRACE_CATALOG_QUERIES environment variable is set.

Tracing can be enabled for specific requests by setting the catalogtrace cookie.

Installation

Install collective.catalogtrace with pip:

pip install collective.catalogtrace

And to create the Plone site:

make create-site

Contribute

• Issue tracker
• Source code

Prerequisites ✅

• An operating system that runs all the requirements mentioned.
• uv
• Make
• Git
• Docker (optional)

Installation 🔧

1. Clone this repository, then change your working directory.

   git clone [e-mail]:collective/collective.catalogtrace.git
   cd collective.catalogtrace
   

2. Install this code base.

   make install
   

License

The project is licensed under GPLv2.

Credits and acknowledgements 🙏

Generated using Cookieplone (0.9.10) and cookieplone-templates (888ff69) on 2025-11-03 14:45:41.122916. A special thanks to all contributors and supporters!