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 をソケットに送信します。 この関数はネットワークが処理待ち状態の時に発生しうる部分的送信を 行えます。

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