ログの出力レベル

出力するログの種類は、LoggerLevel 環境変数によって制限することができます。設定可能なレベルは以下の4つで、ログの多い順に debug > info > warn > error となります。

debug

最も出力が多く、すべてのログが出力されます。プラグインなどにより出力される debug レベルのログも対象となります。主に、開発環境向けです。

info

Movable Type の動作に関して正常系のユーザー操作に関するログを出力します。たとえば、サインインやサインアウト、記事などのオブジェクト作成や更新などです。ユーザーの操作イベントの監視はもちろん、イベントをトリガーに何かする場合などに有効です。

warn

Movable Type の動作に関してシステムに影響を及ぼすほどではないが、何らかの異常が発生した場合に記録されます。

error

Movable Type の動作に関して、システムへの影響を及ぼす恐れのある異常が発生した場合に記録されます。たとえば、データベースやディスクへの書き込みが失敗した場合などです。また、ユーザーのサインイン失敗などのセキュリティ上のエラーについても記録されます。

出力されるログファイル

ログファイルは、LoggerPath 環境変数で指定されたディレクトリに al-yyyymmdd.log というファイル名で出力されます。yyyymmdd には、サーバーの現在日付が入ります。

ログ出力モジュール

ログの出力モジュールとして Log::Log4perl と Log::Minimal に対応しています。いずれかのモジュールがインストールされていない場合は動作しません。LoggerModule 環境変数で明示的に Log4perl か Minimal を指定することができます。また、対応するプラグインにより追加されたログ出力モジュールを指定することも可能です。

LoggerModule Your::Plugin::Log

ログモジュールを開発する

プラグインで ログモジュールを追加すれば、Log::Log4perl、Log::Minimal 以外のログモジュールを利用したり、Slack や syslog に出力するといったことを行うこともできます。

モジュールは、MT::Util::Log を継承し、debug, info, warn, error というサブルーチンを用意います。

package Your::Plugin::Log;
use strict;
use warnings;
use MT;
use base qw(MT::Util::Log);

sub new {
    my ( $self, $level, $file ) = @_;

    # do something

    return $self;
}

sub debug {
    my ( $class, $msg ) = @_;

    # do something
}

sub info {
    my ( $class, $msg ) = @_;

    # do something
}

sub warn {
    my ( $class, $msg ) = @_;

    # do something
}

sub error {
    my ( $class, $msg ) = @_;

    # do something
}

1;

LoggerLevel (none | debug | info | warn | error)

出力するログのレベルを指定します。情報量が多い順に debug > info > warn > error です。指定がないあるいは、none が指定されている場合。または、存在しないレベルが指定されている場合は ログは出力されません。

default: none

LoggerPath

ログファイルの出力先ディレクトリ名を指定します。絶対パスでの指定を推奨しますが、相対パスを指定した場合は MT_HOMEからの相対パスとして処理されます。ログには機密情報も含まれるので、ウェブからのアクセスができない場所を指定してください。値を指定しない場合は、ログは出力されません。

default: 指定なし

LoggerModule

ログ出力モジュールを指定します。標準では Log4perl か Minimal が利用可能です。ただし、それぞれ 利用する Perl モジュールがインストールされていない場合は、システムログにその旨がログとして残り、ログファイルの出力は行いません。

default: Log4perl