Мониторинг и анализ логов PHP

Расширенные примеры просмотра и анализа логов PHP

Ниже приведены нестандартные техники работы с журналами PHP, включающие скриптовую автоматизацию и асинхронную обработку.

Пример 1: Скрипт на PHP с цветовой подсветкой ошибок и загрузкой последних строк

Следующий скрипт читает конец лога (последние 50 строк), выделяет критические ошибки красным, предупреждения жёлтым, остальные сообщения серым.

// color_highlight.php
$logFile = '/var/log/php_errors.log';
$lines = 50;
$handle = fopen($logFile, 'r');
if ($handle) {
    fseek($handle, -max(1, filesize($logFile) * 0.1), SEEK_END); // смещение
    $buffer = stream_get_contents($handle);
    fclose($handle);
    $allLines = explode("\n", $buffer);
    $lastLines = array_slice($allLines, -$lines);
    foreach ($lastLines as $line) {
        if (preg_match('/PHP Fatal error|PHP Catchable fatal error/i', $line)) {
            $color = 'red';
        } elseif (preg_match('/PHP Warning/i', $line)) {
            $color = 'orange';
        } else {
            $color = 'gray';
        }
        echo "<span style='color: $color'>" . htmlspecialchars($line) . "</span><br>";
    }
}

Результат: на веб-странице отображаются последние записи с цветовой индикацией серьёзности.

[25-Nov-2024 10:23:45 UTC] PHP Fatal error:  Uncaught TypeError: ...
[25-Nov-2024 10:23:44 UTC] PHP Warning:  Undefined array key ...

Пример 2: Асинхронный мониторинг с ReactPHP

Использование библиотеки ReactPHP для неблокирующего чтения лога в реальном времени. Скрипт запускается из командной строки и выводит каждую новую строку с меткой времени.

// async_tail.php
require 'vendor/autoload.php';
use React\EventLoop\Factory;
use React\Stream\ReadableResourceStream;

$loop = Factory::create();
$stream = fopen('/var/log/php_errors.log', 'r');
fseek($stream, 0, SEEK_END); // начинаем с конца
$readable = new ReadableResourceStream($stream, $loop);
$readable->on('data', function ($chunk) {
    echo '[' . date('H:i:s') . '] ' . $chunk;
});
$loop->run();

После запуска скрипта каждая новая запись в логе немедленно выводится в консоль. Это аналог tail -f, реализованный на PHP.

[11:05:32] [25-Nov-2024 11:05:32 UTC] PHP Notice: Undefined variable: x
[11:05:33] [25-Nov-2024 11:05:33 UTC] PHP Stack trace: ...

Пример 3: Объединение логов из нескольких файлов с помощью multitail

Утилита multitail позволяет отображать несколько лог-файлов одновременно в одном окне терминала. Установка: apt install multitail.

multitail /var/log/php_errors.log /var/log/php-fpm.log /var/log/nginx/error.log

Каждому файлу выделяется собственная панель с цветом. Переключение между панелями - клавиша b. Можно фильтровать строки по ключевым словам прямо в процессе просмотра.

Результат: на экране терминала одновременно обновляются три лога.

+-----[ /var/log/php_errors.log ]----------------------+
| PHP Fatal error: ...                                   |
| PHP Warning: ...                                       |
+-----[ /var/log/php-fpm.log ]-------------------------+
| WARNING: [pool www] server reached pm.max_children...  |
+-----[ /var/log/nginx/error.log ]--------------------+
| 2024/11/25 11:00:00 [error] ...                       |

Пример 4: Анализ логов PHP с помощью Logstash и Elasticsearch (централизованное логирование)

Для сложной инфраструктуры логи отправляются в Elasticsearch через Logstash. Пример конфигурации Logstash для парсинга стандартного PHP-лога.

# logstash.conf
input {
  file {
    path => "/var/log/php_errors.log"
    start_position => "beginning"
    sincedb_path => "/dev/null"
  }
}
filter {
  grok {
    match => { "message" => "%{TIMESTAMP_ISO8601:timestamp} %{GREEDYDATA:message}" }
  }
}
output {
  elasticsearch {
    hosts => ["localhost:9200"]
    index => "php-logs-%{+YYYY.MM.dd}"
  }
}

После запуска Logstash логи индексируются, и в Kibana можно строить дашборды с графиками ошибок, фильтрацией по временным интервалам и полям.

Результат: централизованное хранение и визуализация логов. Пример запроса в Kibana: message: "Fatal error".

Пример 5: Использование inotifywait для реакции на изменения в логе

Утилита inotifywait отслеживает изменения файловой системы. С её помощью можно запускать произвольный скрипт при каждой новой записи в лог PHP.

#!/bin/bash
inotifywait -m -e modify /var/log/php_errors.log |
while read file event; do
    tail -n1 /var/log/php_errors.log >> /tmp/php_last_error.log
    # дополнительно: отправить уведомление через Telegram
    curl -s -X POST https://api.telegram.org/botTOKEN/sendMessage -d chat_id=ID -d text="Новая ошибка"
done

Скрипт работает в фоне, копирует последнюю строку в отдельный файл и уведомляет администратора. Проблема: при высокой частоте записей возможна потеря сообщений. Решение - использовать буфер с отметками времени.

Пример 6: Частичное восстановление повреждённого лога с помощью strings

Если файл лога повреждён (бинарный мусор), утилита strings извлекает все читаемые строки.

strings /var/log/php_errors.log | grep -i "error" | head -30

Выводятся только те фрагменты, которые содержат подстроку “error”. Это может помочь выявить текстовые сообщения среди двоичного шума.