CakePHP3 のログをためす

この記事は、CakePHP3 Advent Calendar 2016の4日目の記事です。
CakePHP3.3のロギングを簡単に説明します。
CakePHP3.xのLogTraitを用いたものです。

環境

Welcome to CakePHP v3.3.7 Console
---------------------------------------------------------------
App : src
Path: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
PHP : 5.6.25

ロギングさせる方法

DB

config/app.php の Datasources 内の使用している設定(default)の、logをtrueにする。

PHP

自分でPHPのコードに埋めたログを吐き出す。

app.php

    /**
     * Configures logging options
     */
    'Log' => [
        'debug' => [
            'className' => 'Cake\Log\Engine\FileLog',
            'path' => LOGS,
            'file' => 'debug',
            'levels' => ['notice', 'info', 'debug'],
            'url' => env('LOG_DEBUG_URL', null),
        ],
        'error' => [
            'className' => 'Cake\Log\Engine\FileLog',
            'path' => LOGS,
            'file' => 'error',
            'levels' => ['warning', 'error', 'critical', 'alert', 'emergency'],
            'url' => env('LOG_ERROR_URL', null),
        ],
    ],

Controller / View(.ctp)

※ Componentも同じ

AppController.php

        $this->log("ʕ·ᴥ·ʔ I",'info');
        $this->log("ʕ·ᴥ·ʔ N",'notice');
        $this->log("ʕ·ᴥ·ʔ D",'debug');

        $this->log("（ ﾟᆸﾟ ）E",'error');
        $this->log("（ ﾟᆸﾟ ）W",'warning');
        $this->log("（ ﾟᆸﾟ ）C",'critical');
        $this->log("（ ﾟᆸﾟ ）A",'alert');
        $this->log("（ ﾟᆸﾟ ）E",'emergency');

$ tail -f *.log


==> debug.log <==
2016-12-03 07:06:29 Info: ʕ·ᴥ·ʔ I
2016-12-03 07:06:29 Notice: ʕ·ᴥ·ʔ N
2016-12-03 07:06:29 Debug: ʕ·ᴥ·ʔ D

==> error.log <==
2016-12-03 07:06:29 Error: （ ﾟᆸﾟ ）E
2016-12-03 07:06:29 Warning: （ ﾟᆸﾟ ）W
2016-12-03 07:06:29 Critical: （ ﾟᆸﾟ ）C
2016-12-03 07:06:29 Alert: （ ﾟᆸﾟ ）A
2016-12-03 07:06:29 Emergency: （ ﾟᆸﾟ ）E

ログレベル使い分け

公式ドキュメントより。
上からヤバイ順。

• Emergency: システム異常
• Alert: 速攻対応必要あり
• Critical: 致命的な状況
• Error: 不具合
• Warning: 警告
• Notice: 通常、しかしメッセージを出したいとき
• Info: なんらかの情報
• Debug: デバッグメッセージ

以上。