14.5.5.5 SocketHandler

14.5.5.5 SocketHandler

SocketHandler クラスは、logging.handlers モジュールの中にありますが、ログ出力をネットワークソケットに送信します。基底クラスでは TCP ソケットを用います。

クラス SocketHandler( host, port): アドレスが host および port で与えられた遠隔のマシンと通信するようにした SocketHandler クラスのインスタンスを生成して返します。

close( ): ソケットを閉じます。

handleError( )

emit( ): レコードの属性辞書を pickle 化し、バイナリ形式でソケットに書き込みます。ソケット操作でエラーが生じた場合、暗黙のうちにパケットは捨てられます。前もって接続が失われていた場合、接続を再度確立します。受信端でレコードを逆 pickle 化して LogRecord にするには、makeLogRecord 関数を使ってください。

handleError( ): emit() の処理中に発生したエラーを処理します。よくある原因は接続の消失です。次のイベント発生時に再度接続確立を試みることができるようにソケットを閉じます。

makeSocket( ): サブクラスで必要なソケット形式を詳細に定義できるようにするためのファクトリメソッドです。デフォルトの実装では、TCP ソケット (socket.SOCK_STREAM) を生成します。

makePickle( record): レコードの属性辞書を pickle 化して、長さを指定プレフィクス付きのバイナリにし、ソケットを介して送信できるようにして返します。

send( packet): pickle 化された文字列 packet をソケットに送信します。この関数はネットワークが処理待ち状態の時に発生しうる部分的送信を行えます。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。