You are here

README.txt in Performance Logging and Monitoring 5

Same filename and directory in other branches
  1. 6.2 README.txt
  2. 6 README.txt
  3. 7.2 README.txt
  4. 7 README.txt
By Khalid Baheyeldin

Copyright 2008 http://2bits.com

Description
-----------
This module provides performance statistics logging for a site, such as page generation
times, and memory usage, for each page load.

This module is useful for developers and site administrators alike to identify pages that
are slow to generate or use excessive memory.

Features include:
* Settings to enable detailed logging or summary logging. The module defaults to no
  logging at all.

* Detailed logging causes one database row to be written for each page load of the site.
  The data includes page generation time in milliseconds, and the number of bytes allocated
  to PHP, time stamp, ...etc.

* Summary logging logs the average and maximum page generation time, average and maximum memory
  usage, last access time, and number of accesses for each path.

* Summary is logged to APC, if installed, so as to not cause extra load on the database. This is
  the only mode recommended for live sites.

* A settings option is available when using summary mode with APC, to exclude pages with less
  than a certain number of accesses. Useful for large sites.

* Support for normal page cache.

Note that detailed logging is only suitable for a site that is in development or testing. Do NOT enable
detailed logging on a live site.

The memory measurement feature of this module depends on the memory_get_peak_usage() function, available
only in PHP 5.2.x or later.

Only summary logging with APC is the recommended mode for live sites, with a threshold of 2 or more.

Patches:
--------
For Drupal 5.x, a simple patch is needed if you want to use the module with Drupal's normal page caching
mode.

The patch is included in the patches directory in the module's tarball.

To apply the patch, check http://drupal.org/patch for instructions.

If you are using Drupal 6.x or higher, there is no need for this patch.

Bugs/Features/Patches:
----------------------
If you want to report bugs, feature requests, or submit a patch, please do so at the project page on
the Drupal web site at http://drupal.org/project/performance

Author
------
Khalid Baheyeldin (http://baheyeldin.com/khalid and http://2bits.com)

If you use this module, find it useful, and want to send the author a thank you note, then use the
Feedback/Contact page at the URL above.

The author can also be contacted for paid customizations of this and other modules.

File

README.txt
View source
  1. By Khalid Baheyeldin
  2. Copyright 2008 http://2bits.com
  3. Description
  4. -----------
  5. This module provides performance statistics logging for a site, such as page generation
  6. times, and memory usage, for each page load.
  7. This module is useful for developers and site administrators alike to identify pages that
  8. are slow to generate or use excessive memory.
  9. Features include:
  10. * Settings to enable detailed logging or summary logging. The module defaults to no
  11. logging at all.
  12. * Detailed logging causes one database row to be written for each page load of the site.
  13. The data includes page generation time in milliseconds, and the number of bytes allocated
  14. to PHP, time stamp, ...etc.
  15. * Summary logging logs the average and maximum page generation time, average and maximum memory
  16. usage, last access time, and number of accesses for each path.
  17. * Summary is logged to APC, if installed, so as to not cause extra load on the database. This is
  18. the only mode recommended for live sites.
  19. * A settings option is available when using summary mode with APC, to exclude pages with less
  20. than a certain number of accesses. Useful for large sites.
  21. * Support for normal page cache.
  22. Note that detailed logging is only suitable for a site that is in development or testing. Do NOT enable
  23. detailed logging on a live site.
  24. The memory measurement feature of this module depends on the memory_get_peak_usage() function, available
  25. only in PHP 5.2.x or later.
  26. Only summary logging with APC is the recommended mode for live sites, with a threshold of 2 or more.
  27. Patches:
  28. --------
  29. For Drupal 5.x, a simple patch is needed if you want to use the module with Drupal's normal page caching
  30. mode.
  31. The patch is included in the patches directory in the module's tarball.
  32. To apply the patch, check http://drupal.org/patch for instructions.
  33. If you are using Drupal 6.x or higher, there is no need for this patch.
  34. Bugs/Features/Patches:
  35. ----------------------
  36. If you want to report bugs, feature requests, or submit a patch, please do so at the project page on
  37. the Drupal web site at http://drupal.org/project/performance
  38. Author
  39. ------
  40. Khalid Baheyeldin (http://baheyeldin.com/khalid and http://2bits.com)
  41. If you use this module, find it useful, and want to send the author a thank you note, then use the
  42. Feedback/Contact page at the URL above.
  43. The author can also be contacted for paid customizations of this and other modules.