參考文件：http://neeke.github.io/SeasLog/

什麼是SeasLog

SeasLog是一個C語言編寫的PHP擴充套件，提供一組規範標準的功能函式，在PHP專案中方便、規範、高效地寫日誌，以及快速地讀取和查詢日誌。

一．什麼是日誌系統

1. 記錄系統執行時的資訊

2. 系統日誌、應用程式日誌、安全日誌

3. 日誌功能不應該影響到使用者的正常使用

二．為什麼需要日誌功能

1. 瞭解系統執行情況

2. 記錄使用者操作資訊

3. 收集資料

三．為什麼選擇SeasLog

1. 高效能（C語言做的 先將日誌寫入記憶體達到一定量再寫入檔案比頻繁寫入檔案好）。

2. 無需配置

3. 功能完善、

4. 使用簡單

四．安裝SeasLog

1.首先要下載SeasLog

$lastLogger_1 = SeasLog::getLastLogger();

SeasLog::setLogger('testModule/app1');
$lastLogger_2 = SeasLog::getLastLogger();

2.在windows系統配置SeasLog

找到適合自己php版本的seaslog.dll,將 php_seaslog.dll放在php安裝目錄的的ext下面

修改php.ini的配置，並增加應的引數配置

seaslog.disting_type = 1

seaslog.disting_by_hour = 1 開啟每小時劃分一個檔案

seaslog.use_buffer = 1 開啟buffer。預設關閉。當開啟此項時，日誌預存於記憶體，當請求結束時(或異常退出時)一次寫入檔案。

seaslog.buffer_size = 100 設定緩衝數量為100. 預設為0,即無緩衝數量限制.當buffer_size大於0時,緩衝量達到該值則寫一次檔案.

seaslog.level = 3 記錄的日誌級別.預設為0,即所有日誌均記錄。當level為1時,關注debug以上級別(包括debug)，以此類推。level大於8時，所有日誌均不記錄

儲存php.ini並且重新伺服器語言，然後執行phpinfo();可以看到

五.SeasLog Logger的使用

 1.獲取與設定basePath 

直接使用 SeasLog::getBasePath()，將獲取php.ini(seaslog.ini)中設定的seaslog.default_basepath 的值。

使用 SeasLog::setBasePath() 函式，將改變 SeasLog::getBasePath() 的取值。

2.設定logger與獲取lastLogger

$lastLogger_1 = SeasLog::getLastLogger();

   SeasLog::setLogger('testModule/app1');
   $lastLogger_2 = SeasLog::getLastLogger();

與basePath相類似的，

直接使用 SeasLog::getLastLogger()，將獲取php.ini(seaslog.ini)中設定的seaslog.default_logger 的值。

使用 SeasLog::setLogger() 函式，將改變 SeasLog::getLastLogger() 的取值。

3.快速寫入log

上面已經設定過了basePath與logger，於是log記錄的目錄已經產生了，

log記錄目錄 = basePath / logger / {fileName}.log log檔名，以 年月日 分檔案，如今天是2014年02月18日期，那麼 {fileName} = 20140218;

還記得 php.ini 中設定的 seaslog.disting_type 嗎？

預設的 seaslog.disting_type = 0，如果今天我使用了 SeasLog ，那麼將產生最終的log檔案：

• LogFile = basePath / logger / 20140218.log
• log格式統一為： {type} | {pid} | {timeStamp} |{dateTime} | {logInfo}
  

<?php
           SeasLog::setBasePath('E:www/seaslog/log/base_test');
          SeasLog::info('this is a info');
     ?>

seaslog.disting_type = 0   產生檔案 20160224.log

  seaslog.disting_type = 1 ， seaslog.disting_by_hour = 0     產生檔案 info.20160224.log

  4.常量列表

SeasLog 共將日誌分成8個級別

• SEASLOG_DEBUG "debug"
• SEASLOG_INFO "info"
• SEASLOG_NOTICE "notice"
• SEASLOG_WARNING "warning"
• SEASLOG_ERROR "error"
• SEASLOG_CRITICAL "critical"
• SEASLOG_ALERT "alert"
• SEASLOG_EMERGENCY "emergency"

var_dump(SEASLOG_DEBUG,SEASLOG_INFO,SEASLOG_NOTICE);
/*
string('debug') debug級別
string('info')  info級別
string('notice') notice級別
*/

5.SeasLog Analyzer的使用

SeasLog在擴充套件中使用管道呼叫shell命令 grep -wc快速地取得count值，並返回值(array || int)給PHP。

 $countResult_1 = SeasLog::analyzerCount();
     $countResult_2 = SeasLog::analyzerCount(SEASLOG_WARNING);
     $countResult_3 = SeasLog::analyzerCount(SEASLOG_ERROR,date('Ymd',time()));

<span style="font-size:18px;"><?php 
SeasLog::setBasePath('E:www/seaslog/log/base_test');

SeasLog::log(SEASLOG_ERROR,'this is a error test by ::log');
SeasLog::debug('this is a {userName} debug',array('{userName}' => 'neeke'));
SeasLog::info('this is a info log');
SeasLog::notice('this is a notice log');
SeasLog::warning('your {website} was down,please {action} it ASAP!',array('{website}' => 'github.com','{action}' => 'rboot'));
SeasLog::error('a error log');
SeasLog::critical('some thing was critical');
SeasLog::alert('yes this is a {messageName}',array('{messageName}' => 'alertMSG'));
SeasLog::emergency('Just now, the house next door was completely burnt out! {note}',array('{note}' => 'it`s a joke'));
?></span>

<span style="font-size:18px;"><?php </span>

<span style="font-size:18px;">$data = SeasLog::analyzerCount();
print_r($data);
echo "<br/>";
$data1 = SeasLog::analyzerCount(SEASLOG_WARNING);
print_r($data1);
echo "<br/>";
$data2 = SeasLog::analyzerCount(SEASLOG_ERROR,date('Ymd',time()));
print_r($data2);
echo "<br/>";</span>

<span style="font-size:18px;">?></span>

獲取某型別log列表

SeasLog在擴充套件中使用管道呼叫shell命令 grep -w快速地取得列表，並返回array給PHP

執行：

$detailErrorArray_inAll   = SeasLog::analyzerDetail(SEASLOG_ERROR);
$detailErrorArray_today   = SeasLog::analyzerDetail(SEASLOG_ERROR,date('Ymd',time()));


echo "<pre>";
print_r($detailErrorArray_inAll);
echo "</pre>";


echo "<pre>";
print_r($detailErrorArray_today);
echo "</pre>";

輸出：

SeasLog::analyzerDetail(SEASLOG_ERROR,date('Ymd',time()));
只取得當前模組下，當前一天內,level為SEASLOG_ERROR 的資訊列表:

同理，取當月
$detailErrorArray_mouth = SeasLog::analyzerDetail(SEASLOG_ERROR,date('Ym',time()));

使用SeasLog進行健康預警

預警的配置

[base]
wait_analyz_log_path = /log/base_test

[fork]
;是否開啟多執行緒 1開啟 0關閉
fork_open = 1

;執行緒個數
fork_count = 3

[warning]
email[smtp_host] = smtp.163.com
email[smtp_port] = 25
email[subject_pre] = 預警郵件 -
email[smtp_user] = [email protected]
email[smtp_pwd] = seaslog#demo
email[mail_from] = [email protected]
email[mail_to] = [email protected]
email[mail_cc] = [email protected]
email[mail_bcc] =

[analyz]
; enum
; SEASLOG_DEBUG      "debug"
; SEASLOG_INFO       "info"
; SEASLOG_NOTICE     "notice"
; SEASLOG_WARNING    "warning"
; SEASLOG_ERROR      "error"
; SEASLOG_CRITICAL   "critical"
; SEASLOG_ALERT      "alert"
; SEASLOG_EMERGENCY  "emergency"

test1[module] = test/bb
test1[level] = SEASLOG_ERROR
test1[bar] = 1
test1[mail_to] = [email protected]

test2[module] = 222
test2[level] = SEASLOG_WARNING

test3[module] = 333
test3[level] = SEASLOG_CRITICAL

test4[module] = 444
test4[level] = SEASLOG_EMERGENCY

test5[module] = 555
test5[level] = SEASLOG_DEBUG

crontab配置

;每天凌晨3點執行
0 3 * * * /path/to/php /path/to/SeasLog/Analyzer/SeasLogAnalyzer.php