aboutsummaryrefslogtreecommitdiffstats
path: root/lib/private/Log.php
diff options
context:
space:
mode:
Diffstat (limited to 'lib/private/Log.php')
-rw-r--r--lib/private/Log.php237
1 files changed, 118 insertions, 119 deletions
diff --git a/lib/private/Log.php b/lib/private/Log.php
index 9975696ff06..301a25d12c1 100644
--- a/lib/private/Log.php
+++ b/lib/private/Log.php
@@ -1,38 +1,10 @@
<?php
declare(strict_types=1);
-
/**
- * @copyright Copyright (c) 2016, ownCloud, Inc.
- *
- * @author Arthur Schiwon <blizzz@arthur-schiwon.de>
- * @author Bart Visscher <bartv@thisnet.nl>
- * @author Bernhard Posselt <dev@bernhard-posselt.com>
- * @author Christoph Wurst <christoph@winzerhof-wurst.at>
- * @author Joas Schilling <coding@schilljs.com>
- * @author Julius Härtl <jus@bitgrid.net>
- * @author Morris Jobke <hey@morrisjobke.de>
- * @author Olivier Paroz <github@oparoz.com>
- * @author Robin Appelman <robin@icewind.nl>
- * @author Roeland Jago Douma <roeland@famdouma.nl>
- * @author Thomas Citharel <nextcloud@tcit.fr>
- * @author Thomas Müller <thomas.mueller@tmit.eu>
- * @author Victor Dubiniuk <dubiniuk@owncloud.com>
- *
- * @license AGPL-3.0
- *
- * This code is free software: you can redistribute it and/or modify
- * it under the terms of the GNU Affero General Public License, version 3,
- * as published by the Free Software Foundation.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU Affero General Public License for more details.
- *
- * You should have received a copy of the GNU Affero General Public License, version 3,
- * along with this program. If not, see <http://www.gnu.org/licenses/>
- *
+ * SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-FileCopyrightText: 2016 ownCloud, Inc.
+ * SPDX-License-Identifier: AGPL-3.0-only
*/
namespace OC;
@@ -42,6 +14,7 @@ use OC\AppFramework\Bootstrap\Coordinator;
use OC\Log\ExceptionSerializer;
use OCP\EventDispatcher\IEventDispatcher;
use OCP\ILogger;
+use OCP\IRequest;
use OCP\IUserSession;
use OCP\Log\BeforeMessageLoggedEvent;
use OCP\Log\IDataLogger;
@@ -62,42 +35,19 @@ use function strtr;
* MonoLog is an example implementing this interface.
*/
class Log implements ILogger, IDataLogger {
- private IWriter $logger;
- private ?SystemConfig $config;
private ?bool $logConditionSatisfied = null;
- private ?Normalizer $normalizer;
- private ?IRegistry $crashReporters;
- private ?IEventDispatcher $eventDispatcher;
+ private ?IEventDispatcher $eventDispatcher = null;
+ private int $nestingLevel = 0;
- /**
- * @param IWriter $logger The logger that should be used
- * @param SystemConfig $config the system config object
- * @param Normalizer|null $normalizer
- * @param IRegistry|null $registry
- */
public function __construct(
- IWriter $logger,
- SystemConfig $config = null,
- Normalizer $normalizer = null,
- IRegistry $registry = null
+ private IWriter $logger,
+ private SystemConfig $config,
+ private Normalizer $normalizer = new Normalizer(),
+ private ?IRegistry $crashReporters = null,
) {
- // FIXME: Add this for backwards compatibility, should be fixed at some point probably
- if ($config === null) {
- $config = \OC::$server->getSystemConfig();
- }
-
- $this->config = $config;
- $this->logger = $logger;
- if ($normalizer === null) {
- $this->normalizer = new Normalizer();
- } else {
- $this->normalizer = $normalizer;
- }
- $this->crashReporters = $registry;
- $this->eventDispatcher = null;
}
- public function setEventDispatcher(IEventDispatcher $eventDispatcher) {
+ public function setEventDispatcher(IEventDispatcher $eventDispatcher): void {
$this->eventDispatcher = $eventDispatcher;
}
@@ -106,9 +56,8 @@ class Log implements ILogger, IDataLogger {
*
* @param string $message
* @param array $context
- * @return void
*/
- public function emergency(string $message, array $context = []) {
+ public function emergency(string $message, array $context = []): void {
$this->log(ILogger::FATAL, $message, $context);
}
@@ -120,9 +69,8 @@ class Log implements ILogger, IDataLogger {
*
* @param string $message
* @param array $context
- * @return void
*/
- public function alert(string $message, array $context = []) {
+ public function alert(string $message, array $context = []): void {
$this->log(ILogger::ERROR, $message, $context);
}
@@ -133,9 +81,8 @@ class Log implements ILogger, IDataLogger {
*
* @param string $message
* @param array $context
- * @return void
*/
- public function critical(string $message, array $context = []) {
+ public function critical(string $message, array $context = []): void {
$this->log(ILogger::ERROR, $message, $context);
}
@@ -145,9 +92,8 @@ class Log implements ILogger, IDataLogger {
*
* @param string $message
* @param array $context
- * @return void
*/
- public function error(string $message, array $context = []) {
+ public function error(string $message, array $context = []): void {
$this->log(ILogger::ERROR, $message, $context);
}
@@ -159,9 +105,8 @@ class Log implements ILogger, IDataLogger {
*
* @param string $message
* @param array $context
- * @return void
*/
- public function warning(string $message, array $context = []) {
+ public function warning(string $message, array $context = []): void {
$this->log(ILogger::WARN, $message, $context);
}
@@ -170,9 +115,8 @@ class Log implements ILogger, IDataLogger {
*
* @param string $message
* @param array $context
- * @return void
*/
- public function notice(string $message, array $context = []) {
+ public function notice(string $message, array $context = []): void {
$this->log(ILogger::INFO, $message, $context);
}
@@ -183,9 +127,8 @@ class Log implements ILogger, IDataLogger {
*
* @param string $message
* @param array $context
- * @return void
*/
- public function info(string $message, array $context = []) {
+ public function info(string $message, array $context = []): void {
$this->log(ILogger::INFO, $message, $context);
}
@@ -194,9 +137,8 @@ class Log implements ILogger, IDataLogger {
*
* @param string $message
* @param array $context
- * @return void
*/
- public function debug(string $message, array $context = []) {
+ public function debug(string $message, array $context = []): void {
$this->log(ILogger::DEBUG, $message, $context);
}
@@ -207,19 +149,21 @@ class Log implements ILogger, IDataLogger {
* @param int $level
* @param string $message
* @param array $context
- * @return void
*/
- public function log(int $level, string $message, array $context = []) {
- $minLevel = $this->getLogLevel($context);
+ public function log(int $level, string $message, array $context = []): void {
+ $minLevel = $this->getLogLevel($context, $message);
+ if ($level < $minLevel
+ && (($this->crashReporters?->hasReporters() ?? false) === false)
+ && (($this->eventDispatcher?->hasListeners(BeforeMessageLoggedEvent::class) ?? false) === false)) {
+ return; // no crash reporter, no listeners, we can stop for lower log level
+ }
array_walk($context, [$this->normalizer, 'format']);
$app = $context['app'] ?? 'no app in context';
$entry = $this->interpolateMessage($context, $message);
- if ($this->eventDispatcher) {
- $this->eventDispatcher->dispatchTyped(new BeforeMessageLoggedEvent($app, $level, $entry));
- }
+ $this->eventDispatcher?->dispatchTyped(new BeforeMessageLoggedEvent($app, $level, $entry));
$hasBacktrace = isset($entry['exception']);
$logBacktrace = $this->config->getValue('log.backtrace', false);
@@ -241,18 +185,37 @@ class Log implements ILogger, IDataLogger {
$this->crashReporters->delegateMessage($entry['message'], $messageContext);
}
} else {
- if ($this->crashReporters !== null) {
- $this->crashReporters->delegateBreadcrumb($entry['message'], 'log', $context);
- }
+ $this->crashReporters?->delegateBreadcrumb($entry['message'], 'log', $context);
}
} catch (Throwable $e) {
// make sure we dont hard crash if logging fails
}
}
- public function getLogLevel($context) {
+ public function getLogLevel(array $context, string $message): int {
+ if ($this->nestingLevel > 1) {
+ return ILogger::WARN;
+ }
+
+ $this->nestingLevel++;
+ /**
+ * @psalm-var array{
+ * shared_secret?: string,
+ * users?: string[],
+ * apps?: string[],
+ * matches?: array<array-key, array{
+ * shared_secret?: string,
+ * users?: string[],
+ * apps?: string[],
+ * message?: string,
+ * loglevel: 0|1|2|3|4,
+ * }>
+ * } $logCondition
+ */
$logCondition = $this->config->getValue('log.condition', []);
+ $userId = false;
+
/**
* check for a special log condition - this enables an increased log on
* a per request/user base
@@ -262,21 +225,8 @@ class Log implements ILogger, IDataLogger {
$this->logConditionSatisfied = false;
if (!empty($logCondition)) {
// check for secret token in the request
- if (isset($logCondition['shared_secret'])) {
- $request = \OC::$server->getRequest();
-
- if ($request->getMethod() === 'PUT' &&
- !str_contains($request->getHeader('Content-Type'), 'application/x-www-form-urlencoded') &&
- !str_contains($request->getHeader('Content-Type'), 'application/json')) {
- $logSecretRequest = '';
- } else {
- $logSecretRequest = $request->getParam('log_secret', '');
- }
-
- // if token is found in the request change set the log condition to satisfied
- if ($request && hash_equals($logCondition['shared_secret'], $logSecretRequest)) {
- $this->logConditionSatisfied = true;
- }
+ if (isset($logCondition['shared_secret']) && $this->checkLogSecret($logCondition['shared_secret'])) {
+ $this->logConditionSatisfied = true;
}
// check for user
@@ -289,6 +239,8 @@ class Log implements ILogger, IDataLogger {
} elseif (in_array($user->getUID(), $logCondition['users'], true)) {
// if the user matches set the log condition to satisfied
$this->logConditionSatisfied = true;
+ } else {
+ $userId = $user->getUID();
}
}
}
@@ -296,24 +248,72 @@ class Log implements ILogger, IDataLogger {
// if log condition is satisfied change the required log level to DEBUG
if ($this->logConditionSatisfied) {
+ $this->nestingLevel--;
return ILogger::DEBUG;
}
- if (isset($context['app'])) {
- $app = $context['app'];
+ if ($userId === false && isset($logCondition['matches'])) {
+ $user = \OCP\Server::get(IUserSession::class)->getUser();
+ $userId = $user === null ? false : $user->getUID();
+ }
+ if (isset($context['app'])) {
/**
* check log condition based on the context of each log message
* once this is met -> change the required log level to debug
*/
- if (!empty($logCondition)
- && isset($logCondition['apps'])
- && in_array($app, $logCondition['apps'], true)) {
+ if (in_array($context['app'], $logCondition['apps'] ?? [], true)) {
+ $this->nestingLevel--;
return ILogger::DEBUG;
}
}
- return min($this->config->getValue('loglevel', ILogger::WARN), ILogger::FATAL);
+ if (!isset($logCondition['matches'])) {
+ $configLogLevel = $this->config->getValue('loglevel', ILogger::WARN);
+ if (is_numeric($configLogLevel)) {
+ $this->nestingLevel--;
+ return min((int)$configLogLevel, ILogger::FATAL);
+ }
+
+ // Invalid configuration, warn the user and fall back to default level of WARN
+ error_log('Nextcloud configuration: "loglevel" is not a valid integer');
+ $this->nestingLevel--;
+ return ILogger::WARN;
+ }
+
+ foreach ($logCondition['matches'] as $option) {
+ if (
+ (!isset($option['shared_secret']) || $this->checkLogSecret($option['shared_secret']))
+ && (!isset($option['users']) || in_array($userId, $option['users'], true))
+ && (!isset($option['apps']) || (isset($context['app']) && in_array($context['app'], $option['apps'], true)))
+ && (!isset($option['message']) || str_contains($message, $option['message']))
+ ) {
+ if (!isset($option['apps']) && !isset($option['loglevel']) && !isset($option['message'])) {
+ /* Only user and/or secret are listed as conditions, we can cache the result for the rest of the request */
+ $this->logConditionSatisfied = true;
+ $this->nestingLevel--;
+ return ILogger::DEBUG;
+ }
+ $this->nestingLevel--;
+ return $option['loglevel'] ?? ILogger::DEBUG;
+ }
+ }
+
+ $this->nestingLevel--;
+ return ILogger::WARN;
+ }
+
+ protected function checkLogSecret(string $conditionSecret): bool {
+ $request = \OCP\Server::get(IRequest::class);
+
+ if ($request->getMethod() === 'PUT'
+ && !str_contains($request->getHeader('Content-Type'), 'application/x-www-form-urlencoded')
+ && !str_contains($request->getHeader('Content-Type'), 'application/json')) {
+ return hash_equals($conditionSecret, '');
+ }
+
+ // if token is found in the request change set the log condition to satisfied
+ return hash_equals($conditionSecret, $request->getParam('log_secret', ''));
}
/**
@@ -324,20 +324,22 @@ class Log implements ILogger, IDataLogger {
* @return void
* @since 8.2.0
*/
- public function logException(Throwable $exception, array $context = []) {
+ public function logException(Throwable $exception, array $context = []): void {
$app = $context['app'] ?? 'no app in context';
$level = $context['level'] ?? ILogger::ERROR;
- $minLevel = $this->getLogLevel($context);
- if ($level < $minLevel && ($this->crashReporters === null || !$this->crashReporters->hasReporters())) {
- return;
+ $minLevel = $this->getLogLevel($context, $context['message'] ?? $exception->getMessage());
+ if ($level < $minLevel
+ && (($this->crashReporters?->hasReporters() ?? false) === false)
+ && (($this->eventDispatcher?->hasListeners(BeforeMessageLoggedEvent::class) ?? false) === false)) {
+ return; // no crash reporter, no listeners, we can stop for lower log level
}
// if an error is raised before the autoloader is properly setup, we can't serialize exceptions
try {
$serializer = $this->getSerializer();
} catch (Throwable $e) {
- $this->error("Failed to load ExceptionSerializer serializer while trying to log " . $exception->getMessage());
+ $this->error('Failed to load ExceptionSerializer serializer while trying to log ' . $exception->getMessage());
return;
}
$data = $context;
@@ -346,12 +348,9 @@ class Log implements ILogger, IDataLogger {
$data = array_merge($serializer->serializeException($exception), $data);
$data = $this->interpolateMessage($data, isset($context['message']) && $context['message'] !== '' ? $context['message'] : ('Exception thrown: ' . get_class($exception)), 'CustomMessage');
-
array_walk($context, [$this->normalizer, 'format']);
- if ($this->eventDispatcher) {
- $this->eventDispatcher->dispatchTyped(new BeforeMessageLoggedEvent($app, $level, $data));
- }
+ $this->eventDispatcher?->dispatchTyped(new BeforeMessageLoggedEvent($app, $level, $data));
try {
if ($level >= $minLevel) {
@@ -374,7 +373,7 @@ class Log implements ILogger, IDataLogger {
$app = $context['app'] ?? 'no app in context';
$level = $context['level'] ?? ILogger::ERROR;
- $minLevel = $this->getLogLevel($context);
+ $minLevel = $this->getLogLevel($context, $message);
array_walk($context, [$this->normalizer, 'format']);
@@ -399,7 +398,7 @@ class Log implements ILogger, IDataLogger {
* @param string|array $entry
* @param int $level
*/
- protected function writeLog(string $app, $entry, int $level) {
+ protected function writeLog(string $app, $entry, int $level): void {
$this->logger->write($app, $entry, $level);
}