Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alexandre-daubois/monolog-processor-collection
A collection of Monolog processors
https://github.com/alexandre-daubois/monolog-processor-collection
log logger logging monolog monolog-processor psr-3 psr3
Last synced: about 2 months ago
JSON representation
A collection of Monolog processors
- Host: GitHub
- URL: https://github.com/alexandre-daubois/monolog-processor-collection
- Owner: alexandre-daubois
- License: mit
- Created: 2023-11-06T14:36:55.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2023-12-23T17:56:35.000Z (about 1 year ago)
- Last Synced: 2024-09-27T05:18:27.545Z (3 months ago)
- Topics: log, logger, logging, monolog, monolog-processor, psr-3, psr3
- Language: PHP
- Homepage: https://packagist.org/packages/alexandre-daubois/monolog-processor-collection
- Size: 52.7 KB
- Stars: 15
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Monolog Processor Collection
[](https://php.net/)
[](https://packagist.org/packages/alexandre-daubois/monolog-processor-collection)
[](https://packagist.org/packages/alexandre-daubois/monolog-processor-collection)
Welcome to the Monolog Processor Collection (MPC) - the ultimate suite of processors designed to enhance your logging
with the renowned [Monolog](https://github.com/Seldaek/monolog) library. This toolkit is meticulously crafted to
integrate seamlessly with PHP 8.1+, ensuring your logging captures the comprehensive details you need with minimal
overhead.
MPC is engineered for developers who demand more from their logs. Whether you're tracking down elusive bugs or
monitoring live production environments, processors enrich your log entries with invaluable context, turning
ordinary logs into a rich, actionable dataset.
MPC is compatible with worker mode of web servers, as relevant processors implement the `ResettableInterface`.
## Available Processors
The package provides the following processors:
- `BacktraceProcessor` adds the backtrace to the log record
- `ClientIpProcessor` adds the client IP address to the log record
- `EnvVarProcessor` adds the value of one or more environment variables to the log record
- `HighResolutionTimestampProcessor` adds the high resolution time to the log record
- `IsHttpsProcessor` adds a boolean value indicating whether the request is a secured HTTP request to the log record
- `PhpIniValueProcessor` adds the value of one or more PHP ini settings to the log record
- `ProtocolVersionProcessor` adds the HTTP protocol version to the log record
- `RequestSizeProcessor` adds the size of the request to the log record, headers included, in bytes
- `ResourceUsagesProcessor` adds the resource usage to the log record as returned by [getrusage()](https://www.php.net/manual/en/function.getrusage.php)
- `SapiNameProcessor` adds the name of the SAPI to the log record
- `SessionIdProcessor` adds the session ID to the log record, or null if no session is active
- `UuidProcessor` adds a UUID v7 to the log record to track records triggered during the same request
## Installation
The recommended way to install MPC is through [Composer](https://getcomposer.org/):
```bash
composer require alexandre-daubois/monolog-processor-collection
```
## Usage
All processor can be used in the same way as any other Monolog processor. For example:
```php
use Monolog\Logger;
$logger = new Logger('name');
$logger->pushProcessor(new BacktraceProcessor());
```
Some processors, like `EnvVarProcessor` and `PhpIniValueProcessor`, require you to specify more
arguments. For example:
```php
use Monolog\Logger;
$logger = new Logger('name');
$logger->pushProcessor(new EnvVarProcessor(['APP_ENV', 'APP_DEBUG']));
```
## Integration with Symfony and MonologBundle
You can register those processors to be used with Symfony and MonologBundle by adding the following configuration to
your `config/packages/monolog.php` file:
```php
use Monolog\Processor\ProcessorInterface;
use MonologProcessorCollection\BacktraceProcessor;
use MonologProcessorCollection\EnvVarProcessor;
use MonologProcessorCollection\ProtocolVersionProcessor;
use MonologProcessorCollection\EnvVarProcessor;
use MonologProcessorCollection\SapiNameProcessor;
return static function (ContainerConfigurator $configurator): void {
// ...
// register as many processors as you like, but keep in mind that
// each processor is called for each log record
$services = $configurator->services();
$services
->set(BacktraceProcessor::class)
->set(EnvVarProcessor::class)->args(['APP_ENV'])
->set(ProtocolVersionProcessor::class)
->set(SapiNameProcessor::class);
// ...
};
```
If you don't use autoconfigure, you need to tag the processors with `monolog.processor`:
```php
return static function (ContainerConfigurator $configurator): void {
// ...
$services = $configurator->services();
$services
->set(BacktraceProcessorAlias::class)
->tag('monolog.processor', ['handler' => 'main'])
->set(EnvVarProcessor::class)->args(['APP_ENV'])
->tag('monolog.processor', ['handler' => 'main']);
// ...
};
```
You can achieve the same configuration with YAML:
```yaml
# config/packages/monolog.yaml
services:
MonologProcessorCollection\BacktraceProcessor:
tags:
- { name: monolog.processor, handler: main }
MonologProcessorCollection\EnvVarProcessor:
arguments:
- APP_ENV
tags:
- { name: monolog.processor, handler: main }
```
Or XML:
```xml
APP_ENV
```