Manual:Maxlag parameter/ja

(Wikimediaのように)複製データベースクラスター上でMediaWikiを稼働させている場合、 高い編集率によってスレイブサーバが遅延することがあります. スレイブの遅延を和らげる一つの方法は遅延がある値を超えたときはすべてのボットとメンテナンスタスクを自動的に停止させることです. サーバーサイドスクリプトにおいて、これはwfWailForSlavesを使用することで行われます. MediaWiki 1.10において、導入されたmaxlagパラメータはクライアントサイドで同じことを行うことを可能にします. MediaWiki 1.10において、導入されたmaxlagパラメータはクライアントサイドで同じことを行うことを可能にします.

maxlagパラメータはURLパラメータ、POSTデータもしくはクッキーを通してindex.phpに渡すことが出来ます. For example, [ this link] edits this page unless the lag is greater than 1 second while [ this one] (with -1 at the end) shows you the actual lag without editing.

指定された遅延がリクエストの時点で越えている場合、次のフォーマットを持ったリスポンスボディと一緒に503ステータスコードが返されます:



次のようなHTTPヘッダーが設定されます:


 * Content-Type: text/plain
 * Retry-After: リトライをする前にクライアントが待つ推奨の最小秒数.
 * X-Database-Lag: もっとも遅延したスレーブの遅延秒数

Wikimediaのwiki群に対する推奨される使い方は次の通りです:


 * maxlag=5(5秒)を使います. Mediawikiの多くのサーバサイドにスクリプトで使用される適切で活動的ではない値です、より高い値はより活動的な振る舞いを意味し、低い値はより快適であることを意味します.
 * 遅延エラーを受け取る場合、再び試す前に少なくとも5秒間はスクリプトを停止させて下さい. ビジーループに陥らないように注意して下さい.
 * この値によって、高いデータベースロードの時に低いデューティサイクルを得る可能性があります. それはOKで、オフピークを待って下さい. 編集を拒否することでユーザーの時間を無駄にしたくないので高いロードの時は人間を優先します.
 * 普通ではない高いもしくは持続する遅延はirc.freenode.net上のに報告されます.

アップストリームサーバのタイムアウトが原因で、Squidが503ステータスコードを持つエラーメッセージを生成することもあります. Clients should treat these errors differently, because they may occur consistently when you try to perform a long-running expensive operation. Repeating the operation on timeout would use excessive server resources and may leave your client in an infinite loop. 次の内容によってsquidエラーとMediaWikiの遅延条件を区別出来ます:


 * X-Database-Lag header is distinctive to slave lag errors in MediaWiki
 * squildエラーではRetry-Afterは存在しません
 * X-Squid-Errorヘッダーはsquidエラーで表示されます
 * The response body in slave lag errors will match the regex

For testing purposes, you may intentionally make the software refuse a request by passing a negative value, such as in the following URL: [].

The maxlag parameter is checked in Wiki.php, and also applies to the API.