Skip to content

Commit

Permalink
Changes links and the note section back to .md compatible format
Browse files Browse the repository at this point in the history
  • Loading branch information
TinaHeiligers committed Feb 19, 2021
1 parent b66d739 commit 5fedcd4
Showing 1 changed file with 16 additions and 17 deletions.
33 changes: 16 additions & 17 deletions src/core/server/logging/README.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,20 +9,20 @@ tags: ['kibana','dev', 'contributor', 'api docs']
---

# Logging
- <DocLink id="kibCoreLogging" section="loggers-appenders-layouts" text="Loggers, Appenders and Layouts"/>
- <DocLink id="kibCoreLogging" section="logger-heirarchy" text="Logger hierarchy"/>
- <DocLink id="kibCoreLogging" section="log-level" text="Log level"/>
- <DocLink id="kibCoreLogging" section="layouts" text="Layouts"/>
- <DocLink id="kibCoreLogging" section="pattern-layout" text="Pattern layout"/>
- <DocLink id="kibCoreLogging" section="json-layout" text="JSON layout"/>
- <DocLink id="kibCoreLogging" section="appenders" text="Appenders"/>
- <DocLink id="kibCoreLogging" section="rolling-file-appender" text="Rolling File Appender"/>
- <DocLink id="kibCoreLogging" section="triggering-policies" text="Triggering Policies"/>
- <DocLink id="kibCoreLogging" section="rolling-strategies" text="Rolling strategies"/>
- <DocLink id="kibCoreLogging" section="configuration" text="Configuration"/>
- <DocLink id="kibCoreLogging" section="usage" text="Usage"/>
- <DocLink id="kibCoreLogging" section="logging-config-migration" text="Logging config migration"/>
- <DocLink id="kibCoreLogging" section="log-record-format-changes" text="Log record format changes"/>
- [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
Expand Down Expand Up @@ -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.

<DocCallOut color="warning" title="Appender additivity is not supported">
__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`.
</DocCallOut>

## Log level

Expand All @@ -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 <DocLink id="kibCoreLogging" section="configuration" text="Configuration"/>). 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`.
Expand Down

0 comments on commit 5fedcd4

Please sign in to comment.