名前

Perlbal::Manual::Debugging - Perlbalのデバッグ

バージョン

Perlbal 1.78.

説明

perlbalには二つのデバッグの方法があります。

そのうちの一つは管理コンソールを使う方法で、もう一つはデバッグメッセージを使う方法です。

コンソール内でデバッグする

管理サービスをセットアップする必要があり、欲しい情報を全てdumpするようにします。

このプロセスの包括的なドキュメントは the Perlbal::Manual::Management の manpage で見つけることができます。

デバッグ メッセージ

環境変数PERLBAL_DEBUG の値を 0 から 4 の間で設定することで、Perlbalがダンプするデバッグメッセージの量を制御することができます。

    PERLBAL_DEBUG = 0 # デバッグしない

    PERLBAL_DEBUG = 4 # 全てをデバッグする

デバッグレベル 1

PERLBAL_DEBUG を 1 に設定することで、基本的なデバッグを有効にすることができます:

    PERLBAL_DEBUG = 1

The following debugging messages are turned on:

• バックエンドへの接続が閉じた場合は、 Perlbal::BackendHTTP の manpage は Backend $self is done; closing... を出力します。
• When a connection to a backend is killed, the Perlbal::ClientProxy manpage prints Client ($self) closing backend ($backend)
• HTTPリクエストがパースに失敗すると、the Perlbal::HTTPHeaders manpage prints HTTP parse failure: $reason
• 接続がSSLに昇格した場合は、 Perlbal::TCPListener manpage は 出力します。socket upgraded to SSL!

デバッグレベル 2

デバッグレベルを2に設定することで、level 1からの全てのメッセージを全て取得する。

    PERLBAL_DEBUG = 2

その他にも幾つか受け取るでしょう:

• バックエンドへの接続が開かれ、書き込み可能であれば、the Perlbal::BackendHTTP manpage は Backend $self is writeable! を出力します。
• 応答が処理されてようとする場合、the Perlbal::BackendHTTP manpage は BackendHTTP: handle_response を出力します。
• バックエンドが読み出し可能な場合は、the Perlbal::BackendHTTP manpage は Backend $self is readable! を出力します。
• バックエンドへの接続にエラーがある場合は、the Perlbal::BackendHTTP manpage は BACKEND event_err を出力します。
• クライアントにkeep-aliveヘッダを送り返さなければならないと決めた場合には、 the Perlbal::ClientHTTPBase manpage は ClientHTTPBase::setup_keepalive($self) を出力します。
• クライアントがファイルの大部分の準備ができた場合には、,the Perlbal::ClientHTTPBase manpage は REPROXY SSL done を出力します。
• ファイルのチャックを読み込んだ長後でreproxyリクエストが送信されようとしている場合は、 the Perlbal::ClientHTTPBase manpage は REPROXY Sent: $sent を出力します。
• キュー内の全てのデータを書き(および、writeの通知を待つのを止めようとしている)場合は、 the Perlbal::ClientHTTPBase manpage はAll writing done to $self を出力します。
• クライアントのプロキシが閉じようとしている時は、 the Perlbal::ClientProxy manpage は Perlbal::ClientProxy closed を出力し、その後に again と saying $reason があるかも知れません。
• クライアントが切断された場合は、the Perlbal::ClientProxy manpage は ClientProxy::client_disconnected を出力します。
• バックエンドが高優先度のリクエストのクライアントをリクエストし、クライアントが利用可能な場合は、 Perlbal/Service が Got from fast queue, in front of $backlog others を出力します。
• バックエンドが低優先度のリクエストのクライアントをリクエストし、クライアントが利用可能な場合は、 Perlbal/Service は Backend requesting client, got PRIORITY = $cp-{fd}.>を出力します。
• バックエンドが低優先度のクライアントをリクエストし、クライアントが利用可能な場合は、 Perlbal/Service は Backend requesting client, got low priority = $cp-{fd}.> を出力します。
• ヘッダが読み込まれた場合、 the Perlbal::Socket manpage は Perlbal::Socket::read_headers($self) is_res=$is_res を出力します。

デバッグレベル 3

    PERLBAL_DEBUG = 3

デバッグレベルを3に設定することで、level 1 と 2 の全てのメッセージに加えて、以下を受け取るでしょう:

• 応答ヘッダがクライアントに書き込まれる直前に、the Perlbal::BackendHTTP manpage は writing response headers to client を出力します。
• クライアントに書き込んでいる時に、the Perlbal::BackendHTTP manpage は content_length=VALUE および remain=VALUE を出力します。それらの値は定義されていない場合は undef です。
• クライアントへの書き込みが完了すると、 the Perlbal::BackendHTTP manpage は done detaching を出力します。
• クライアントにkeep-aliveヘッダ情報を送り返さないといけないと決めた場合には、 the Perlbal::ClientHTTPBase manpage は service's persist_client = $persist_clientを出力します。
• While determining if we should be sending keep-alive header information back to the client, if we were sent content-length or it's a head request, as we're doing a keep alive the Perlbal::ClientHTTPBase manpage prints doing keep-alive to client
• クライアントにkeep-aliveヘッダ情報を送信しない場合は、 the Perlbal::ClientHTTPBase manpage は doing connection: close を出力します。
• ユーザに結果の全てを送信し終えた直後に、 the Perlbal::ClientProxy manpage は ClientProxy::backend_finished を出力します。
• ユーザに応答を完全に送り終えて、stateをリセットしなければならない場合は、the Perlbal::ClientProxy manpage は ClientProxy::http_response_sent -- resetting state を出力します。
• クライアントに応答を書き込む時に、the Perlbal::ClientProxy manpage は ClientProxy::event_writeを出力します。
• クライアントに応答を書き込んだ後で、もし接続し続けていてバックエンドが読み続けることのきっかけを引き起こしているのであれば、the Perlbal::ClientProxy manpage は unstalling backendを出力します。
• リクエストを読む時に、the Perlbal::ClientProxy manpage は ClientProxy::event_read を出力します。
• リクエストを読み込み、ヘッダを読み込む直前に、the Perlbal::ClientProxy manpage は no headerreading.を出力します。
• When reading a request, if we're not buffering to disk or we're no longer reading, as we disable reads, the Perlbal::ClientProxy manpage prints disabling reads.
• As we're reading, the Perlbal::ClientProxy manpage prints reading $read_size bytes (VALUE bytes remain), where VALUE bytes remain can be <undef>
• 各読み込みの後で、the Perlbal::ClientProxy manpage は read $len bytesを出力します。
• リクエストを読み終えた後で、the Perlbal::ClientProxy manpage は done_reading = $done_reading, backend = BACKENDを出力します。BACKEND は undefの場合もありえます。
• ヘッダをバックエンドに送信し、クライアントからの読み込みを完了する前に応答する場合は、クライアントから更に読み込むことが却下されます。この場合には、 the Perlbal::ClientProxy manpage は already responded.を出力します。クライアントがデータの送信を続ける場合は、 the Perlbal::ClientProxy manpage は already responded [2]を出力し、読み込みを諦めます。
• 読み込みの後で、書き込むことができるバックエンドがある場合には、そうする直前に the Perlbal::ClientProxy manpage は got a backend. sending write to it.を出力します。
• 読み込みの後で、利用可能なバックエンドが無い場合は、 the Perlbal::ClientProxy manpage は no backend. read_ahead = $self-{read_ahead}.>を出力します。
• ディスクへのファイルのスプーリングを既に開始したと知って、そうし続けようとする場合には、 the Perlbal::ClientProxy manpage は bureason = $self-{bureason}>を出力します。
• バックエンドが利用できず、リクエストをしようとする場合は、 the Perlbal::ClientProxy manpage は finally requesting a backendを出力します。
• ヘッダを読み込もうとしクライアントが切断された場合は、 the Perlbal::Socket manpage は client disconnectedを出力します。
• ヘッダから続く\r\nを削除する必要がある場合は、 the Perlbal::Socket manpage は throwing away leading \r\nを出力します。
• ヘッダをパケットから読んでいて、その終わりでヘッダの終わりを見つけられない場合は、 the Perlbal::Socket manpage は can't find end of headersを出力します。
• いくつかのヘッダを読むと、the Perlbal::Socket manpage は pre-parsed headers: [$hstr]を出力します。
• After reading headers, if there's additional content that we've read, we push it back; when we do so, the Perlbal::Socket manpage prints pushing back $len bytes after header
• bogusヘッダを受け取った場合は、パースの失敗のより接続を閉じる直前に、 the Perlbal::Socket manpage は bogus headers を出力します。
• 妥当なヘッダを受け取った場合は、the Perlbal::Socket manpageは got valid headersを出力します。
• クライアントからバッファされたデータを読み込んでいる場合は、 the Perlbal::Socket manpage は draining readbuf from $self to $dest: [$$bref]を出力します。

デバッグレベル 4

デバッグレベルを4に設定することで、レベル1から3までの全てのメッセージを取得することができます。

更に、 write が再定義され、write が呼ばれるときにはいつも最初にwrite($self, <$clen>"$content") from ($pkg, $filename, $line) が出力されます。

    PERLBAL_DEBUG = 4

参照

the Perlbal::Manual::Configuration manpage, the Perlbal::Manual::Management manpage.