always require a message paramter for data logging

also ensure it plays well with current log reader

Signed-off-by: Arthur Schiwon <blizzz@arthur-schiwon.de>

apps/workflowengine/lib/Helper/LogContext.php

@@ -33,7 +33,7 @@ class LogContext {
 	protected $details;
 
 	public function setDescription(string $description): LogContext {
-		$this->details['description'] = $description;
+		$this->details['message'] = $description;
 		return $this;
 	}
 

apps/workflowengine/lib/Service/Logger.php

@@ -162,8 +162,10 @@ class Logger {
 			return;
 		}
 
+		$details = $logContext->getDetails();
 		$this->flowLogger->logData(
-			$logContext->getDetails(),
+			$details['message'],
+			$details,
 			['app' => Application::APP_ID, 'level' => $context['level']]
 		);
 	}

lib/private/Log.php

@@ -340,7 +340,7 @@ class Log implements ILogger, IDataLogger {
 		}
 	}
 
-	public function logData(array $data, array $context = []): void {
+	public function logData(string $message, array $data, array $context = []): void {
 		$app = $context['app'] ?? 'no app in context';
 		$level = $context['level'] ?? ILogger::ERROR;
 
@@ -350,6 +350,7 @@ class Log implements ILogger, IDataLogger {
 
 		try {
 			if ($level >= $minLevel) {
+				$data['message'] = $message;
 				if (!$this->logger instanceof IFileBased) {
 					$data = json_encode($data, JSON_PARTIAL_OUTPUT_ON_ERROR | JSON_UNESCAPED_SLASHES);
 				}

lib/private/Log/LogDetails.php

@@ -80,6 +80,16 @@ abstract class LogDetails {
 			'userAgent',
 			'version'
 		);
+
+		if(is_array($message) && !array_key_exists('Exception', $message)) {
+			// Exception messages should stay as they are,
+			// anything else modern is split to 'message' (string) and
+			// data (array) fields
+			$shortMessage = $message['message'] ?? '(no message provided)';
+			$entry['data'] = $message;
+			$entry['message'] = $shortMessage;
+		}
+
 		return $entry;
 	}
 

lib/public/Log/IDataLogger.php

@@ -28,15 +28,15 @@ namespace OCP\Log;
  * Interface IDataLogger
  *
  * @package OCP\Log
- * @since 18.0.0
+ * @since 18.0.1
  */
 interface IDataLogger {
 
 	/**
 	 * allows to log custom data, similar to how logException works
 	 *
-	 * @since 18.0.0
+	 * @since 18.0.1
 	 */
-	public function logData(array $data, array $context = []): void;
+	public function logData(string $message, array $data, array $context = []): void;
 
 }