7.5. ログファイルの名前付きパイプへの置き換え

Directory Server インスタンスは、名前付きパイプログスクリプトを実行し、パイプの名前を指定するだけで、ロギングに名前付きパイプを使用できます。(サーバーがすでに実行中の場合は、ログを再度開く必要がありますが、それ以外の設定は必要ありません)。

# ds-logpipe.py /var/log/dirsrv/slapd-example/access

このように ds-logpipe.py を実行することには、実装が簡単であり、Directory Server 設定を変更する必要がない、という利点があります。これは、特に特定のイベントタイプを検索する場合に、高速のデバッグまたはモニターリングに役立ちます。

Directory Server インスタンスがロギング用に実際のファイルではなく名前付きパイプを頻繁に、または永続的に使用する場合には、(デフォルトでログファイルを使用するのと同じように) 名前付きパイプを作成してロギングに使用するようにインスタンスを再設定することができます。

インスタンスのログ設定には、3 つの項目を設定する必要があります。

これらの設定変更は、Directory Server Console で行うか、ldapmodify を使用して実行できます。

たとえば、これによりアクセスログが access.pipe に切り替わります。

# ldapmodify -D "cn=Directory Manager" -W -p 389 -h server.example.com -x

dn: cn=config
changetype: modify
replace: nsslapd-accesslog
nsslapd-accesslog: /var/log/dirsrv/slapd-instance/access.pipe
-
replace: nsslapd-accesslog-logbuffering
nsslapd-accesslog-logbuffering: off
-
replace: nsslapd-accesslog-maxlogsperdir
nsslapd-accesslog-maxlogsperdir: 1
-
replace: nsslapd-accesslog-logexpirationtime
nsslapd-accesslog-logexpirationtime: -1
-
replace: nsslapd-accesslog-logrotationtime
nsslapd-accesslog-logrotationtime: -1

インスタンスの init スクリプト設定ファイルを編集して、名前付きパイプを Directory Server インスタンスと共に起動およびシャットダウンできます。

プラグインは、名前付きパイプからログデータを読み取り、操作を実行するために呼び出すことができます。名前付きパイプログスクリプトによりプラグインを使用する場合、いくつかの考慮事項があります。

ds-logpipe.py /var/log/dirsrc/slapd-example/errors.pipe --plugin=/usr/share/dirsrv/data/example-funct.py example-funct.regex="warning" > warnings.txt

--plugin=/path/to/pluginname.py pluginname.arg1=foo pluginname.arg1=bar pluginname.arg2=baz

{'arg1': ['foo', 'bar'],
 'arg2': 'baz'}

def pre(myargs):
    retval = True
    myarg = myargs['argname']
    if isinstance(myarg, list): # handle list of values
    else: # handle single value
    if bad_problem:
        retval = False
    return retval

def plugin(line):
    retval = True
    # do something with line
    if something_is_bogus:
        retval = False
    return retval

def post(): # no arguments
    # do something
    # no return value