Manual:Maxlag parameter/ja

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

maxlag パラメーターは、URL パラメーター、POST データ、 Cookie を通して api.php に渡せます. 秒数の整数値です. For example, [/w/api.php?action=query&titles=MediaWiki&format=json&maxlag=1 this link] shows metadata about the page "MediaWiki" unless the lag is greater than 1 second while [/w/api.php?action=query&titles=MediaWiki&format=json&maxlag=-1 this one] (with -1 at the end) shows you the actual lag without metadata.

リクエストに対して指定した時間以上のラグが発生した場合、ステータスコード503が返されます（なおAPIリクエストの場合は200が返されます. を参照してください）. この場合、以下のようなレスポンスボディとなります:

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


 * Retry-After: 再試行をする前にクライアントが待つ推奨の最小秒数.
 * X-Database-Lag: もっとも遅延した複製の遅延秒数

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

See also API:Etiquette#The maxlag parameter.
 * maxlag=5 (5秒)を指定する. これはリクエストが激しくならない適切な値で、Pywikibot の既定値にもなっています. 大きい値にするほど動作が激しくなり、小さい値にするほど控えめになります.
 * 遅延エラーを受け取る場合、再び試す前に少なくとも5秒間はスクリプトを停止させて下さい. ビジーループに陥らないように注意して下さい.
 * この値によって、データベースの負荷が高いときに低いデューティサイクルを得る可能性があります. それはOKで、負荷が高い状態が終わるのを待ってください. 編集を拒否することで利用者の時間を無駄にしたくないため、負荷が高いときは人間を優先します.
 * 普通ではない高いもしくは持続する遅延はIRC上のに報告されます.
 * Interactive tasks (where a user is waiting for the result) may omit the maxlag parameter. Noninteractive tasks should always use it.

アップストリーム サーバーのタイムアウトが原因で、キャッシュ層 (Varnish または 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. 以下のいずれかを使用して、キャッシュ層のエラーとMediaWikiの遅延条件を区別できます:


 * X-Database-Lag header is distinctive to replication lag errors in MediaWiki
 * Varnish エラーでは Retry-After はありません
 * X-Squid-Errorヘッダーはsquidエラーで表示されます
 * 複製遅延エラーでのレスポンス ボディは正規表現の  にマッチします

テストの目的のために、負の値を渡すことで故意にソフトウェアにリクエストを拒否させることが出来ます. 例えば次のURLです: [/w/api.php?action=query&titles=MediaWiki&format=json&maxlag=-1 /w/api.php?action=query&titles=MediaWiki&format=json&maxlag=-1]

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