summaryrefslogtreecommitdiff
path: root/modules/throttle/throttle.module
diff options
context:
space:
mode:
authorDries Buytaert <dries@buytaert.net>2003-01-23 09:24:20 +0000
committerDries Buytaert <dries@buytaert.net>2003-01-23 09:24:20 +0000
commit637004c5391eb48b473a80df1de425aaae8edc25 (patch)
tree97c9b38f58fe0d6f3280a022d89740a1cadd92db /modules/throttle/throttle.module
parent4dac201e7c447a1f7e09d7972a14f517bbbf3edc (diff)
downloadbrdo-637004c5391eb48b473a80df1de425aaae8edc25.tar.gz
brdo-637004c5391eb48b473a80df1de425aaae8edc25.tar.bz2
- Tidied up XHTML. Patch by Ulf.
- Added missing t() function. Patch by Stefan.
Diffstat (limited to 'modules/throttle/throttle.module')
-rw-r--r--modules/throttle/throttle.module8
1 files changed, 4 insertions, 4 deletions
diff --git a/modules/throttle/throttle.module b/modules/throttle/throttle.module
index ed95241eb..979c667e6 100644
--- a/modules/throttle/throttle.module
+++ b/modules/throttle/throttle.module
@@ -26,7 +26,7 @@ function throttle_help() {
<p>This module also adds a block that displays the current status of the throttle. You must have "access throttle block" privileges to view the block. As a general rule of thumb, only site administrators should be granted access to this block.</p>
- <p>The auto-throttle mechanism performs an extra database query in order to determine what the current throttle level should be. Fortunately the throttle can be tuned so these database queries only occur on a fraction of all pages geenrated by your site, reducing the overhead to an insignificant amount. Additionally, when the top-most throttle level is reached, all throttle queries are suspended for a configurable period of time. More detail follows.
+ <p>The auto-throttle mechanism performs an extra database query in order to determine what the current throttle level should be. Fortunately the throttle can be tuned so these database queries only occur on a fraction of all pages geenrated by your site, reducing the overhead to an insignificant amount. Additionally, when the top-most throttle level is reached, all throttle queries are suspended for a configurable period of time. More detail follows.</p>
<p>As with any new module, <i>throttle.module</i> needs to be enabled <?php print l("here", "admin/system/modules"); ?> before you can use it. Also refer to the permissions section below if you wish to access the throttle statistics block.</p>
@@ -38,19 +38,19 @@ function throttle_help() {
<blockquote>This first option on the throttle module configuration screen allows you to enable or disable the auto-throttling mechanism. Note that the access-log must also be enabled via the statistics.module for the auto-throttling mechanism to have any affect.</blockquote>
<h4>auto-throttle multiplier:</h4>
- <blockquote>This second option allows you to tune the auto-throttle mechanism. The auto-throttle mechanism supports six throttle levels, from 0 (off) to 5 (maximum). The current throttle level is based upon how many pages have been accessed on your site in the past 60 seconds - the more pages being displayed, the higher the throttle level. This multiplier defines how many hits are required to switch from one throttle level to the next.
+ <blockquote><p>This second option allows you to tune the auto-throttle mechanism. The auto-throttle mechanism supports six throttle levels, from 0 (off) to 5 (maximum). The current throttle level is based upon how many pages have been accessed on your site in the past 60 seconds - the more pages being displayed, the higher the throttle level. This multiplier defines how many hits are required to switch from one throttle level to the next.</p>
<p>For example, with a throttle multiplier of 20: Once 20 pages have been accessed on your site within a period of 60 seconds, the throttle level will be incremented to a level of 1. Once 40 pages have been accessed on your site within a period of 60 seconds, the throttle level will be incremented to a level of 2. And so on, until 100 pages are accessed on your site within a period of 60 seconds, at which time the throttle level will be set to a maximum level of 5.</p>
<p>Upon reaching a throttle level of 5, access logs and the auto-throttle checking mechanism is automatically disabled. It is only renabled by cron after a period of time defined by "auto-throttle cron test", explained below.</p></blockquote>
<h4>auto-throttle probability limiter:</h4>
- <blockquote>This option allows you to minimize the performance impact of the auto-throttle. If we refer to the probability limiter as P, then P% of all pages generated by your site will perform an extra database query to verify that the current throttle level is appropriate to the current server load.
+ <blockquote><p>This option allows you to minimize the performance impact of the auto-throttle. If we refer to the probability limiter as P, then P% of all pages generated by your site will perform an extra database query to verify that the current throttle level is appropriate to the current server load.</p>
<p>As a rule of thumb, the higher your multiplier, the lower your probability limiter should be. For example, if you have a multiplier of 100, then you logically don't need to check the throttle level more than once out of every 100 page views, so the probability limiter should be set to 1%. As database queries are "expensive", it's recommended that you keep the probability limiter to the smallest percentage possible, while still high enough to react quickly to a change in server load.</p></blockquote>
<h4>auto-throttle cron test:</h4>
- <blockquote>The auto-throttle dynamically adjusts its level upward, but not downward. That is to say, if you have a multiplier of 20 and you get 45 hits in one minute, your throttle level will be adjusted to a level of 2. If a few minutes later you only get 35 hits in one minute, the throttle level will NOT be adjusted down to a level of 1. This prevents the throttle from bouncing back and forth between two levels.
+ <blockquote><p>The auto-throttle dynamically adjusts its level upward, but not downward. That is to say, if you have a multiplier of 20 and you get 45 hits in one minute, your throttle level will be adjusted to a level of 2. If a few minutes later you only get 35 hits in one minute, the throttle level will NOT be adjusted down to a level of 1. This prevents the throttle from bouncing back and forth between two levels.</p>
<p>In order for the throttle level to be dropped, cron must be enabled. This option then defines how often the level will be dropped by one to test the server load. If the server load is no longer as high as it was, the level will stay where it is, until the cron test period passes again and cron drops the throttle level again. This process repeats until the throttle is returned to a throttle level of 0.</p></blockquote>