From 5fedcd4fc68c3ce643773598ce610e1e5804eb17 Mon Sep 17 00:00:00 2001 From: Christiane Heiligers Date: Fri, 19 Feb 2021 09:54:01 -0700 Subject: [PATCH] Changes links and the note section back to .md compatible format --- src/core/server/logging/README.mdx | 33 +++++++++++++++--------------- 1 file changed, 16 insertions(+), 17 deletions(-) diff --git a/src/core/server/logging/README.mdx b/src/core/server/logging/README.mdx index 0e8e0f6e9790d9..35a4549c247962 100644 --- a/src/core/server/logging/README.mdx +++ b/src/core/server/logging/README.mdx @@ -9,20 +9,20 @@ tags: ['kibana','dev', 'contributor', 'api docs'] --- # Logging -- -- -- -- - - - - -- - - - - - - -- -- -- -- +- [Loggers, Appenders and Layouts](#loggers-appenders-and-layouts) +- [Logger hierarchy](#logger-hierarchy) +- [Log level](#log-level) +- [Layouts](#layouts) + - [Pattern layout](#pattern-layout) + - [JSON layout](#json-layout) +- [Appenders](#appenders) + - [Rolling File Appender](#rolling-file-appender) + - [Triggering Policies](#triggering-policies) + - [Rolling strategies](#rolling-strategies) +- [Configuration](#configuration) +- [Usage](#usage) +- [Logging config migration](#logging-config-migration) +- [Log record format changes](#log-record-format-changes) The way logging works in Kibana is inspired by `log4j 2` logging framework used by [Elasticsearch](https://www.elastic.co/guide/en/elasticsearch/reference/current/settings.html#logging). The main idea is to have consistent logging behaviour (configuration, log format etc.) across the entire Elastic Stack @@ -52,12 +52,11 @@ fully configured. Developer can configure _log level_ and _appenders_ that should be used within particular context name. If logger configuration specifies only _log level_ then _appenders_ configuration will be inherited from the ancestor logger. - +__Note:__ In the current implementation log messages are only forwarded to appenders configured for a particular logger context name or to appenders of the closest ancestor if current logger doesn't have any appenders configured. That means that we __don't support__ so called _appender additivity_ when log messages are forwarded to _every_ distinct appender within ancestor chain including `root`. - ## Log level @@ -75,7 +74,7 @@ log record or disable logging entirely for the specific context name. Every appender should know exactly how to format log messages before they are written to the console or file on the disk. This behaviour is controlled by the layouts and configured through `appender.layout` configuration property for every -custom appender (see examples in ). Currently we don't define any default layout for the +custom appender (see examples in [Configuration](#configuration)). Currently we don't define any default layout for the custom appenders, so one should always make the choice explicitly. There are two types of layout supported at the moment: `pattern` and `json`.