Add cpu usage processor

doc/02-handlers-formatters-processors.md

@@ -160,6 +160,7 @@
 ## Processors
 
 - [_PsrLogMessageProcessor_](https://github.com/Seldaek/monolog/blob/main/src/Monolog/Processor/PsrLogMessageProcessor.php): Processes a log record's message according to PSR-3 rules, replacing `{foo}` with the value from `$context['foo']`.
+- [_CPUUsageProcessor_](https://github.com/Seldaek/monolog/blob/main/src/Monolog/Processor/CPUUsageProcessor.php): Adds the current avg cpu use to a log record.
 - [_ClosureContextProcessor_](https://github.com/Seldaek/monolog/blob/main/src/Monolog/Processor/ClosureContextProcessor.php): Allows delaying the creation of context data by setting a Closure in context which is called when the log record is used
 - [_IntrospectionProcessor_](https://github.com/Seldaek/monolog/blob/main/src/Monolog/Processor/IntrospectionProcessor.php): Adds the line/file/class/method from which the log call originated.
 - [_WebProcessor_](https://github.com/Seldaek/monolog/blob/main/src/Monolog/Processor/WebProcessor.php): Adds the current request URI, request method and client IP to a log record.

src/Monolog/Processor/CPUUsageProcessor.php

@@ -0,0 +1,66 @@
+<?php declare(strict_types=1);
+
+/*
+ * This file is part of the Monolog package.
+ *
+ * (c) Jordi Boggiano <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Monolog\Processor;
+
+use Monolog\LogRecord;
+
+/**
+ * Injects sys_getloadavg in all records @see https://www.php.net/manual/en/function.sys-getloadavg.php
+ *
+ * @author Johan Vlaar <[email protected]>
+ */
+class CPUUsageProcessor implements ProcessorInterface
+{
+    public const AVG_SYSTEM_LOAD_1_MINUTE = 0;
+    public const AVG_SYSTEM_LOAD_5_MINUTE = 1;
+    public const AVG_SYSTEM_LOAD_15_MINUTE = 2;
+
+    public const AVAILABLE_AVG_SYSTEM_LOAD = [
+        self::AVG_SYSTEM_LOAD_1_MINUTE,
+        self::AVG_SYSTEM_LOAD_5_MINUTE,
+        self::AVG_SYSTEM_LOAD_15_MINUTE,
+    ];
+
+    /**
+     * @var int
+     */
+    protected $avgSystemLoad;
+
+    /**
+     * @param int $avgSystemLoad
+     */
+    public function __construct(int $avgSystemLoad = self::AVG_SYSTEM_LOAD_1_MINUTE)
+    {
+        if (!in_array($avgSystemLoad, self::AVAILABLE_AVG_SYSTEM_LOAD, true)) {
+            throw new \InvalidArgumentException(sprintf('Invalid average system load: `%s`', $avgSystemLoad));
+        }
+        $this->avgSystemLoad = $avgSystemLoad;
+    }
+
+    /**
+     * {@inheritDoc}
+     */
+    public function __invoke(LogRecord $record): LogRecord
+    {
+        if (!function_exists('sys_getloadavg')) {
+            return $record;
+        }
+        $usage = sys_getloadavg();
+        if (false === $usage) {
+            return $record;
+        }
+
+        $record['extra']['cpu_usage'] = $usage[$this->avgSystemLoad];
+
+        return $record;
+    }
+}

tests/Monolog/Processor/CPUUsageProcessorTest.php

@@ -0,0 +1,43 @@
+<?php declare(strict_types=1);
+
+/*
+ * This file is part of the Monolog package.
+ *
+ * (c) Jordi Boggiano <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Monolog\Processor;
+
+use Monolog\Test\TestCase;
+
+/**
+ * Injects sys_getloadavg in all records @see https://www.php.net/manual/en/function.sys-getloadavg.php
+ *
+ * @author Johan Vlaar <[email protected]>
+ */
+class CPUUsageProcessorTest extends TestCase
+{
+    /**
+     * @covers Monolog\Processor\CPUUsageProcessor::__invoke
+     */
+    public function testProcessor()
+    {
+        $processor = new CPUUsageProcessor();
+        $record = $processor($this->getRecord());
+        $this->assertArrayHasKey('cpu_usage', $record->extra);
+        $this->assertIsFloat($record->extra['cpu_usage']);
+    }
+
+    /**
+     * @covers Monolog\Processor\CPUUsageProcessor::__invoke
+     */
+    public function testProcessorWithInvalidAvgSystemLoad()
+    {
+        $this->expectException(\InvalidArgumentException::class);
+        $this->expectExceptionMessage('Invalid average system load: `3`');
+        new CPUUsageProcessor(3);
+    }
+}