LogstashFormatter squashes the base message array and the context and extras subarrays into one. More...

Inheritance diagram for MediaWiki\Logger\Monolog\LogstashFormatter:

Collaboration diagram for MediaWiki\Logger\Monolog\LogstashFormatter:

Public Member Functions
	__construct (string $applicationName, ?string $systemName=null, string $extraKey='', string $contextKey='ctxt_', $version=self::V0)
	TODO: See T247675 for removing this override. More...

	format (array $record)

Public Attributes
const	V0 = 0

const	V1 = 1

Protected Member Functions
	fixKeyConflicts (array $fields, array $context)
	Rename any context field that would otherwise overwrite a message key. More...

	formatMonologV0 (array $record)
	Borrowed from monolog/monolog 1.25.3 https://github.com/Seldaek/monolog/blob/1.x/src/Monolog/Formatter/LogstashFormatter.php#L87-L128. More...

	formatMonologV1 (array $record)
	Borrowed mostly from monolog/monolog 1.25.3 https://github.com/Seldaek/monolog/blob/1.25.3/src/Monolog/Formatter/LogstashFormatter.php#L130-165. More...

	formatV0 (array $record)
	Prevent key conflicts. More...

	formatV1 (array $record)
	Prevent key conflicts. More...

	normalizeException (\Throwable $e, int $depth=0)
	Use a more user-friendly trace format than Monolog\Formatter\NormalizerFormatter. More...

Protected Attributes
array	$reservedKeys
	Keys which should not be used in log context. More...

int	$version
	Logstash format version to use. More...

Detailed Description

LogstashFormatter squashes the base message array and the context and extras subarrays into one.

This can result in unfortunately named context fields overwriting other data (T145133). This class modifies the standard LogstashFormatter to rename such fields and flag the message. Also changes exception JSON-ification which is done poorly by the standard class.

Since: 1.29

Definition at line 13 of file LogstashFormatter.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Logger\Monolog\LogstashFormatter::__construct	(	string	$applicationName,
		?string	$systemName = `null`,
		string	$extraKey = `''`,
		string	$contextKey = `'ctxt_'`,
			$version = `self::V0`
	)

TODO: See T247675 for removing this override.

Parameters

string	$applicationName	The application that sends the data, used as the "type" field of logstash
string \| null	$systemName	The system/machine name, used as the "source" field of logstash, defaults to the hostname of the machine
string	$extraKey	The key for extra keys inside logstash "fields", defaults to ''
string	$contextKey	The key for context keys inside logstash "fields", defaults
int	$version	The logstash format version to use, defaults to V0 to ''

Definition at line 47 of file LogstashFormatter.php.

References MediaWiki\Logger\Monolog\LogstashFormatter\$version.

Member Function Documentation

◆ fixKeyConflicts()

MediaWiki\Logger\Monolog\LogstashFormatter::fixKeyConflicts	(	array	$fields,
		array	$context
	)

protected

Rename any context field that would otherwise overwrite a message key.

Parameters

array	$fields	Fields to be sent to logstash
array	$context	Copy of the original $record['context']

Returns: array Updated version of $fields

Definition at line 207 of file LogstashFormatter.php.

◆ format()

MediaWiki\Logger\Monolog\LogstashFormatter::format ( array $record )

Reimplemented in MediaWiki\Logger\Monolog\CeeFormatter.

Definition at line 54 of file LogstashFormatter.php.

References MediaWiki\Logger\Monolog\LogstashFormatter\formatV1().

◆ formatMonologV0()

MediaWiki\Logger\Monolog\LogstashFormatter::formatMonologV0 ( array $record )

protected

Borrowed from monolog/monolog 1.25.3 https://github.com/Seldaek/monolog/blob/1.x/src/Monolog/Formatter/LogstashFormatter.php#L87-L128.

Parameters

array $record

Returns: array

Definition at line 93 of file LogstashFormatter.php.

◆ formatMonologV1()

MediaWiki\Logger\Monolog\LogstashFormatter::formatMonologV1 ( array $record )

protected

Borrowed mostly from monolog/monolog 1.25.3 https://github.com/Seldaek/monolog/blob/1.25.3/src/Monolog/Formatter/LogstashFormatter.php#L130-165.

Parameters

array $record

Returns: array

Definition at line 159 of file LogstashFormatter.php.

◆ formatV0()

MediaWiki\Logger\Monolog\LogstashFormatter::formatV0 ( array $record )

protected

Prevent key conflicts.

Parameters

array $record

Returns: array

Definition at line 72 of file LogstashFormatter.php.

◆ formatV1()

MediaWiki\Logger\Monolog\LogstashFormatter::formatV1 ( array $record )

protected

Prevent key conflicts.

Parameters

array $record

Returns: array

Definition at line 140 of file LogstashFormatter.php.

Referenced by MediaWiki\Logger\Monolog\LogstashFormatter\format().

◆ normalizeException()

MediaWiki\Logger\Monolog\LogstashFormatter::normalizeException	(	\Throwable	$e,
		int	$depth = `0`
	)

protected

Use a more user-friendly trace format than Monolog\Formatter\NormalizerFormatter.

Parameters

\\Throwable	$e
int	$depth

Returns: array

Definition at line 228 of file LogstashFormatter.php.

References MWExceptionHandler\getRedactedTraceAsString().

Member Data Documentation

◆ $reservedKeys

array MediaWiki\Logger\Monolog\LogstashFormatter::$reservedKeys

protected

Initial value:

= [
        
        'message', 'channel', 'level', 'type',
        
        'url', 'ip', 'http_method', 'server', 'referrer',
        
        'host', 'wiki', 'reqId', 'mwversion',
        
        'normalized_message',
    ]

Keys which should not be used in log context.

Definition at line 19 of file LogstashFormatter.php.

◆ $version

int MediaWiki\Logger\Monolog\LogstashFormatter::$version

protected

Logstash format version to use.

Definition at line 33 of file LogstashFormatter.php.

Referenced by MediaWiki\Logger\Monolog\LogstashFormatter\__construct().

◆ V0

const MediaWiki\Logger\Monolog\LogstashFormatter::V0 = 0

Definition at line 15 of file LogstashFormatter.php.

◆ V1

const MediaWiki\Logger\Monolog\LogstashFormatter::V1 = 1

Definition at line 16 of file LogstashFormatter.php.

The documentation for this class was generated from the following file:

includes/debug/logger/monolog/LogstashFormatter.php

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ fixKeyConflicts()

◆ format()

◆ formatMonologV0()

◆ formatMonologV1()

◆ formatV0()

◆ formatV1()

◆ normalizeException()

Member Data Documentation

◆ $reservedKeys

◆ $version

◆ V0

◆ V1