Обзор логирования — IO7 Framework

Внимание

Данная статья документации написана нейросетью. Возможны некоторые расхождения и неточность информации!

Обзор

IO7 предоставляет систему логирования на основе класса IO\Event и профилировщик IO\Profile\PinbaManager для анализа производительности.

Архитектура

IO\Event              — Логирование событий (echo, file, error_log, syslog, custom)
IO\Profile\PinbaManager — Профилировщик для Pinba (таймеры, метрики)

Уровни логирования

КонстантаЗначениеОписание
LOG_DEBUG0Отладочная информация
LOG_INFO1Информационные сообщения
LOG_WARNING2Предупреждения
LOG_ERROR3Ошибки
LOG_CRITICAL4Критические ошибки

Обработчики

КонстантаОписание
HANDLER_ECHOВывод на экран
HANDLER_FILEЗапись в файл
HANDLER_ERROR_LOGЧерез error_log()
HANDLER_SYSLOGЧерез syslog
HANDLER_CUSTOMПользовательский обработчик

Быстрый старт

Простое логирование

\IO\Event::info('Запрос обработан');
\IO\Event::error('Ошибка подключения к БД');
\IO\Event::debug('Параметры запроса', ['params' => $params]);

Настройка обработчиков

\IO\Event::start();
\IO\Event::addHandler('file');
\IO\Event::addHandler('syslog');

\IO\Event::addHandler('custom', function (int $level, string $message, array $context): void {
    sendToExternalSystem($message);
});

Профилирование

\IO\Profile\PinbaManager::init([
    'enabled' => true,
    'server' => '127.0.0.1:3002',
]);

$timerId = \IO\Profile\PinbaManager::start('api_request', ['endpoint' => '/api/users']);
// ... выполнение запроса
\IO\Profile\PinbaManager::stop($timerId);

PinbaManager использует gggeek/polyfill-pinba — чистую PHP-реализацию Pinba extension. Установка нативного расширения не требуется.

Конфигурация (.env)

# Уровень логирования
LOG_HANDLERS[]=echo
LOG_HANDLERS[]=file

# Файл логов
LOG_FILE=/var/log/io7/app.log
LOG_MAX_SIZE=10485760

Pinba настраивается через php.ini или PinbaManager::init():

pinba.enabled = 1
pinba.server = 127.0.0.1:3002

См. также