14.5.5.8 NTEventLogHandler

NTEventLogHandler クラスは、logging.handlers モジュールの中にありますが、ログ記録メッセージをローカルな Windows NT、Windows 2000 、または Windows XP のイベントログ (event log) に送信する機能をサポートします。この機能を使えるようにするには、 Mark Hammond による Python 用 Win32 拡張パッケージをインストールする必要があります。

クラス NTEventLogHandler( appname[, dllname[, logtype]]): NTEventLogHandler クラスの新たなインスタンスを返します。 appname はイベントログに表示する際のアプリケーション名を定義するために使われます。この名前を使って適切なレジストリエントリが生成されます。 dllname はログに保存するメッセージ定義の入った .dll または .exe ファイルへの完全に限定的な (fully qualified) パス名を与えなければなりません (指定されない場合、'win32service.pyd' が使われます - このライブラリは Win32 拡張とともにインストールされ、いくつかのプレースホルダとなるメッセージ定義を含んでいます)。これらのプレースホルダを利用すると、メッセージの発信源全体がログに記録されるため、イベントログは巨大になるので注意してください。 logtype は 'Application'、 'System' または 'Security' のいずれかであるか、デフォルトの 'Application' でなければなりません。

close( ): 現時点では、イベントログエントリの発信源としてのアプリケーション名をレジストリから除去することができます。しかしこれを行うと、イベントログビューアで意図したログをみることができなくなるでしょう - これはイベントログが .dll 名を取得するためにレジストリにアクセスできなければならないからです。現在のバージョンではこの操作を行いません (実際、このメソッドは何も行いません)。

emit( record): メッセージ ID、イベントカテゴリおよびイベント型を決定し、メッセージを NT イベントログに記録します。

getEventCategory( record): レコードに対するイベントカテゴリを返します。自作のカテゴリを指定したい場合、このメソッドをオーバライドしてください。このクラスのバージョンのメソッドは 0 を返します。

getEventType( record): レコードのイベント型を返します。自作の型を指定したい場合、このメソッドをオーバライドしてください。このクラスのバージョンのメソッドは、ハンドラの typemap 属性を使って対応付けを行います。この属性は __init__() で初期化され、DEBUG、INFO、 WARNING、 ERROR、および CRITICAL が入っています。自作のレベルを使っているのなら、このメソッドをオーバライドするか、ハンドラの typemap 属性に適切な辞書を配置する必要があるでしょう。

getMessageID( record): レコードのメッセージ ID を返します。自作のメッセージを使っているのなら、ロガーに渡されるmsg を書式化文字列ではなく ID にします。その上で、辞書参照を行ってメッセージ ID を得ます。このクラスのバージョンでは 1 を返します。この値は win32service.pyd における基本となるメッセージ ID です。

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