PHPのエラーログ管理を完全解説！初心者でもわかるMonologとLogstash入門

1. PHPのエラーログとは？

1. PHPのエラーログとは？

PHPのエラーログとは、プログラムが動いている途中で起きた失敗や問題点を文字として記録したものです。料理中に焦がしてしまった理由をメモするようなもので、後から見返すことで「なぜ失敗したのか」を落ち着いて確認できます。画面に突然英語のエラーが出ると不安になりますが、エラーログを読むことで原因が少しずつ見えてきます。PHPのテストやデバッグでは、このエラーログ管理がとても重要になります。

2. エラーログを出力する基本設定

2. エラーログを出力する基本設定

まずはPHPでエラーログを記録できるようにします。これは日記帳を用意する作業だと思ってください。設定をしないと、せっかくのエラーがどこにも残らず消えてしまいます。初心者のうちは「エラーはすべて記録する」設定がおすすめです。

ini_set('log_errors', 'On');
ini_set('error_log', __DIR__ . '/error.log');

echo $test;

上の例では、存在しない変数を使うことでエラーを発生させています。その内容がerror.logというファイルに保存されます。

Notice: Undefined variable: test

3. ログ管理が必要な理由

3. ログ管理が必要な理由

ログ管理をしないと、問題が起きた瞬間にしか原因がわかりません。これは防犯カメラがないお店と同じで、後から何が起きたのか調べられなくなります。PHPのエラーログ管理をしっかり行うことで、テストやデバッグが楽になり、同じミスを繰り返しにくくなります。特に初心者ほど「記録を残す習慣」が大切です。

4. Monologとは何か

4. Monologとは何か

Monolog（モノログ）は、PHPで使える有名なログ管理用の道具です。普通のエラーログが手書きメモだとしたら、Monologは整理されたノートのような存在です。エラーだけでなく、通常の動作メモも一緒に記録できるため、PHPのテストとデバッグがとてもやりやすくなります。

use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$log = new Logger('app');
$log->pushHandler(new StreamHandler(__DIR__ . '/app.log'));

$log->info('処理が開始されました');

処理が開始されました

5. Monologでエラーを記録する

5. Monologでエラーを記録する

Monologでは、エラーの種類ごとにわかりやすく記録できます。これは色分けされた付せんを貼る感覚に近いです。初心者でも「これは注意」「これは危険」と判断しやすくなります。

try {
    throw new Exception('問題が発生しました');
} catch (Exception $e) {
    $log->error($e->getMessage());
}

問題が発生しました

6. Logstashとは何か

6. Logstashとは何か

Logstash（ログスタッシュ）は、たくさんのログを集めて整理する仕組みです。Monologが日記を書く人だとしたら、Logstashは日記を集めて分類する係です。PHPだけでなく、さまざまなシステムのログを一か所にまとめられるため、大きなサービスでよく使われます。初心者のうちは「大量のログをまとめて見るための道具」と覚えておけば十分です。

7. MonologとLogstashの連携イメージ

7. MonologとLogstashの連携イメージ

PHPでMonologを使ってログを書き、そのログをLogstashが読み取ります。これは手紙を書いて郵便ポストに入れ、郵便局が仕分けする流れと似ています。PHPのエラーログ管理を段階的に理解することで、将来より大きなシステムにも対応できるようになります。

$log->warning('少し注意が必要な状態です');

少し注意が必要な状態です

8. 初心者が意識したいログ管理のポイント

8. 初心者が意識したいログ管理のポイント

最初から完璧を目指す必要はありません。まずは「エラーを必ず記録する」「後から読み返す」ことが大切です。PHPのテストとデバッグでは、ログは自分を助けてくれる味方になります。MonologやLogstashは難しそうに見えますが、考え方はとてもシンプルです。失敗を記録し、次に活かす。その積み重ねが理解につながります。