You are here

Home » API reference » Devel 5

README.txt in Devel 5

Same filename in this branch
  1. 5 README.txt
  2. 5 performance/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

performance/README.txt
View source 
  1. 

  2. By Khalid Baheyeldin

  3. 

  4. Copyright 2008 http://2bits.com

  5. 

  6. Description

  7. -----------

  8. This module provides performance statistics logging for a site, such as page generation

  9. times, and memory usage, for each page load.

  10. 

  11. This module is useful for developers and site administrators alike to identify pages that

  12. are slow to generate or use excessive memory.

  13. 

  14. Features include:

  15. * Settings to enable detailed logging or summary logging. The module defaults to no

  16.   logging at all.

  17. 

  18. * Detailed logging causes one database row to be written for each page load of the site.

  19.   The data includes page generation time in milliseconds, and the number of bytes allocated

  20.   to PHP, time stamp, ...etc.

  21. 

  22. * Summary logging logs the average and maximum page generation time, average and maximum memory

  23.   usage, last access time, and number of accesses for each path.

  24. 

  25. * Summary is logged to APC, if installed, so as to not cause extra load on the database. This is

  26.   the only mode recommended for live sites.

  27. 

  28. * A settings option is available when using summary mode with APC, to exclude pages with less

  29.   than a certain number of accesses. Useful for large sites.

  30. 

  31. * Support for normal page cache.

  32. 

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

  34. detailed logging on a live site.

  35. 

  36. The memory measurement feature of this module depends on the memory_get_peak_usage() function, available

  37. only in PHP 5.2.x or later.

  38. 

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

  40. 

  41. Patches:

  42. --------

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

  44. mode.

  45. 

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

  47. 

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

  49. 

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

  51. 

  52. Bugs/Features/Patches:

  53. ----------------------

  54. If you want to report bugs, feature requests, or submit a patch, please do so at the project page on

  55. the Drupal web site at http://drupal.org/project/performance

  56. 

  57. Author

  58. ------

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

  60. 

  61. If you use this module, find it useful, and want to send the author a thank you note, then use the

  62. Feedback/Contact page at the URL above.

  63. 

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