You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@logging.apache.org by gi...@apache.org on 2024/05/30 11:02:32 UTC
(logging-log4j2) branch 2.x-site-stg-out updated: Add website content generated from `c28bd4a75f60a4c7611db667d1bd3803f96ded06`
This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch 2.x-site-stg-out
in repository https://gitbox.apache.org/repos/asf/logging-log4j2.git
The following commit(s) were added to refs/heads/2.x-site-stg-out by this push:
new d4c9a9380d Add website content generated from `c28bd4a75f60a4c7611db667d1bd3803f96ded06`
d4c9a9380d is described below
commit d4c9a9380d9f2c95339da8e71914b8dd0918e742
Author: ASF Logging Services RM <pr...@logging.apache.org>
AuthorDate: Thu May 30 11:02:25 2024 +0000
Add website content generated from `c28bd4a75f60a4c7611db667d1bd3803f96ded06`
---
development.html | 46 +-
download.html | 46 +-
faq.html | 46 +-
index.html | 48 +-
javadoc.html | 46 +-
log4j-1.2-api.html | 46 +-
log4j-appserver.html | 46 +-
log4j-cassandra.html | 46 +-
log4j-couchdb.html | 46 +-
log4j-docker.html | 46 +-
log4j-flume-ng.html | 46 +-
log4j-iostreams.html | 46 +-
log4j-jakarta-web.html | 46 +-
log4j-spring-boot.html | 46 +-
log4j-spring-cloud-config-client.html | 46 +-
log4j-spring-cloud-config.html | 46 +-
log4j-taglib.html | 46 +-
log4j-web.html | 46 +-
manual/api.html | 111 +++-
manual/appenders.html | 46 +-
manual/architecture.html | 46 +-
manual/async.html | 46 +-
manual/cloud.html | 46 +-
manual/compatibility.html | 46 +-
manual/configuration.html | 46 +-
manual/customconfig.html | 46 +-
manual/customloglevels.html | 46 +-
manual/eventlogging.html | 46 +-
manual/extending.html | 46 +-
manual/filters.html | 46 +-
manual/flowtracing.html | 46 +-
manual/garbagefree.html | 46 +-
.../getting-started.html | 693 ++++++++++++---------
manual/index.html | 57 +-
manual/installation.html | 75 +--
manual/jmx.html | 46 +-
manual/json-template-layout.html | 46 +-
manual/layouts.html | 46 +-
manual/logbuilder.html | 46 +-
manual/logsep.html | 46 +-
manual/lookups.html | 46 +-
manual/markers.html | 46 +-
manual/messages.html | 46 +-
manual/migration.html | 46 +-
manual/performance.html | 46 +-
manual/plugins.html | 46 +-
manual/resource-logger.html | 46 +-
manual/scoped-context.html | 46 +-
manual/scripts.html | 46 +-
manual/simple-logger.html | 46 +-
manual/status-logger.html | 46 +-
manual/systemproperties.html | 46 +-
manual/thread-context.html | 46 +-
manual/webapp.html | 46 +-
...config-client.html => migrate-from-logback.html | 316 +++++-----
development.html => migrate-from-slf4j.html | 269 ++++----
plugin-reference.html | 46 +-
release-notes.html | 48 +-
sitemap.xml | 126 ++--
59 files changed, 2286 insertions(+), 1757 deletions(-)
diff --git a/development.html b/development.html
index 7d4b9fe3fd..53c3e82b9f 100644
--- a/development.html
+++ b/development.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
- </li>
- <li class="nav-item is-current-page" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/download.html b/download.html
index 5311c88931..55c9e89960 100644
--- a/download.html
+++ b/download.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/faq.html b/faq.html
index fb600b2bd8..b4d734abd7 100644
--- a/faq.html
+++ b/faq.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
- <li class="nav-item is-current-page" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item is-current-page" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/index.html b/index.html
index ea2298db60..b3ceb0296a 100644
--- a/index.html
+++ b/index.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
@@ -318,7 +324,7 @@ The project is actively maintained by a <a href="https://logging.apache.org/team
<div class="ulist">
<ul>
<li>
-<p><a href="getting-started.html" class="xref page">Getting started</a></p>
+<p><a href="manual/getting-started.html" class="xref page">Getting started</a></p>
</li>
<li>
<p><a href="manual/installation.html" class="xref page">How can I install Log4j? Which dependencies are needed?</a></p>
diff --git a/javadoc.html b/javadoc.html
index 378ad45ee8..a6fd77c27d 100644
--- a/javadoc.html
+++ b/javadoc.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item is-current-page" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-1.2-api.html b/log4j-1.2-api.html
index 0d10764853..a324ebc1b7 100644
--- a/log4j-1.2-api.html
+++ b/log4j-1.2-api.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-appserver.html b/log4j-appserver.html
index cc917b37b8..cf402d4514 100644
--- a/log4j-appserver.html
+++ b/log4j-appserver.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-cassandra.html b/log4j-cassandra.html
index 59dd3d9d81..446573f906 100644
--- a/log4j-cassandra.html
+++ b/log4j-cassandra.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-couchdb.html b/log4j-couchdb.html
index 3205e42aa3..41b39733d6 100644
--- a/log4j-couchdb.html
+++ b/log4j-couchdb.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-docker.html b/log4j-docker.html
index 15b1afbae9..8e63230032 100644
--- a/log4j-docker.html
+++ b/log4j-docker.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-flume-ng.html b/log4j-flume-ng.html
index aa6d1bd0b4..f20ae42636 100644
--- a/log4j-flume-ng.html
+++ b/log4j-flume-ng.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-iostreams.html b/log4j-iostreams.html
index 0722a1b56b..c549441314 100644
--- a/log4j-iostreams.html
+++ b/log4j-iostreams.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-jakarta-web.html b/log4j-jakarta-web.html
index e825651112..97e7d03c54 100644
--- a/log4j-jakarta-web.html
+++ b/log4j-jakarta-web.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-spring-boot.html b/log4j-spring-boot.html
index 0181daf9ef..3a26c966a7 100644
--- a/log4j-spring-boot.html
+++ b/log4j-spring-boot.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-spring-cloud-config-client.html b/log4j-spring-cloud-config-client.html
index f9b29c8d83..7d72884a47 100644
--- a/log4j-spring-cloud-config-client.html
+++ b/log4j-spring-cloud-config-client.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-spring-cloud-config.html b/log4j-spring-cloud-config.html
index 35f9276bfe..aa20ebb779 100644
--- a/log4j-spring-cloud-config.html
+++ b/log4j-spring-cloud-config.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-taglib.html b/log4j-taglib.html
index 3fcfba7dee..c7521e43e1 100644
--- a/log4j-taglib.html
+++ b/log4j-taglib.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-web.html b/log4j-web.html
index fde6e40998..b7c089b93e 100644
--- a/log4j-web.html
+++ b/log4j-web.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/api.html b/manual/api.html
index 790a18d9bc..ae80e073f9 100644
--- a/manual/api.html
+++ b/manual/api.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
@@ -313,14 +319,19 @@
<details>
<summary class="title">What is a logging API and a logging implementation?</summary>
<div class="content">
-<div class="dlist">
+<div id="logging-api" class="dlist">
<dl>
-<dt class="hdlist1">Logging APIs</dt>
+<dt class="hdlist1">Logging API</dt>
<dd>
<p>A logging API is an interface your code or your dependencies directly logs against.
-It is implementation agnostic.
+It is required at compile-time.
+It is implementation agnostic to ensure that your application can write logs, but is not tied to a specific logging implementation.
Log4j API, <a href="https://www.slf4j.org/">SLF4J</a>, <a href="https://docs.oracle.com/en/java/javase/8/core/java-logging-overview.html">JUL (Java Logging)</a>, <a href="https://commons.apache.org/proper/commons-logging/">JCL (Apache Commons Logging)</a>, <a href="https://openjdk.org/jeps/264">JPL (Java Platform Logging)</a> and <a href="https://github.com/jboss-logging/jboss-logging">JBoss Logging</a> are major logging APIs.</p>
</dd>
+</dl>
+</div>
+<div id="logging-impl" class="dlist">
+<dl>
<dt class="hdlist1">Logging implementation</dt>
<dd>
<p>A logging implementation is only required at runtime and can be changed without the need to recompile your software.
@@ -339,7 +350,7 @@ Log4j Core, <a href="https://docs.oracle.com/en/java/javase/8/core/java-logging-
<td class="content">
<div class="paragraph">
<p>Are you looking for a crash course on how to use Log4j in your application or library?
-See <a href="../getting-started.html" class="xref page">Getting started</a>.
+See <a href="getting-started.html" class="xref page">Getting started</a>.
You can also check out <a href="installation.html" class="xref page">Installation</a> for the complete installation instructions.</p>
</div>
</td>
@@ -386,8 +397,56 @@ Check out <a href="https://logging.apache.org/log4j/kotlin">Log4j Kotlin</a> and
<h2 id="_introduction"><a class="anchor" href="#_introduction"></a>Introduction</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>To write logs, you need a <a href="../javadoc/log4j-api/org/apache/logging/log4j/Logger.html"><code>Logger</code></a> instance which you will retrieve from the <a href="../javadoc/log4j-api/org/apache/logging/log4j/LogManager.html"><code>LogManager</code></a>.
-You can use the <code>Logger</code> instance to write logs by using methods like <code>info()</code>, <code>warn()</code>, <code>error()</code>, etc.
+<p>To log, you need a <a href="../javadoc/log4j-api/org/apache/logging/log4j/Logger.html"><code>Logger</code></a> instance which you will retrieve from the <a href="../javadoc/log4j-api/org/apache/logging/log4j/LogManager.html"><code>LogManager</code></a>.
+These are all part of the <code>log4j-api</code> module, which you can install as follows:</p>
+</div>
+<div id="_tabs_1" class="openblock tabs is-loading">
+<div class="content">
+<div class="ulist tablist">
+<ul>
+<li id="_tabs_1_maven" class="tab">
+<p>Maven</p>
+</li>
+<li id="_tabs_1_gradle" class="tab">
+<p>Gradle</p>
+</li>
+</ul>
+</div>
+<div id="_tabs_1_maven--panel" class="tabpanel" aria-labelledby="_tabs_1_maven">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><project>
+
+ <!-- Assuming `log4j-bom` is added -->
+
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.logging.log4j</groupId>
+ <artifactId>log4j-api</artifactId>
+ </dependency>
+ </dependencies>
+
+</project></code></pre>
+</div>
+</div>
+</div>
+<div id="_tabs_1_gradle--panel" class="tabpanel" aria-labelledby="_tabs_1_gradle">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies {
+
+ // Assuming `log4j-bom` is added
+
+ implementation 'org.apache.logging.log4j:log4j-api'
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can use the <code>Logger</code> instance to log by using methods like <code>info()</code>, <code>warn()</code>, <code>error()</code>, etc.
These methods are named after the <em>log levels</em> they represent, a way to categorize log events by severity.
The log message can also contain placeholders written as <code>{}</code> that will be replaced by the arguments passed to the method.</p>
</div>
diff --git a/manual/appenders.html b/manual/appenders.html
index 70ac159a27..cb2dc66315 100644
--- a/manual/appenders.html
+++ b/manual/appenders.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/architecture.html b/manual/architecture.html
index 360844413d..70e34cb464 100644
--- a/manual/architecture.html
+++ b/manual/architecture.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/async.html b/manual/async.html
index f534e44bc0..539b9e39a9 100644
--- a/manual/async.html
+++ b/manual/async.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/cloud.html b/manual/cloud.html
index dd6d21e43e..97241638ea 100644
--- a/manual/cloud.html
+++ b/manual/cloud.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item is-current-page" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/compatibility.html b/manual/compatibility.html
index eef90d7bee..a298acaacd 100644
--- a/manual/compatibility.html
+++ b/manual/compatibility.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/configuration.html b/manual/configuration.html
index 5f87dd31df..8be597f797 100644
--- a/manual/configuration.html
+++ b/manual/configuration.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/customconfig.html b/manual/customconfig.html
index d27987d145..e95daf336c 100644
--- a/manual/customconfig.html
+++ b/manual/customconfig.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/customloglevels.html b/manual/customloglevels.html
index 1cb51924d5..c46d07c70d 100644
--- a/manual/customloglevels.html
+++ b/manual/customloglevels.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/eventlogging.html b/manual/eventlogging.html
index 3aeb316c11..6b4337cc60 100644
--- a/manual/eventlogging.html
+++ b/manual/eventlogging.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/extending.html b/manual/extending.html
index 0ebe562c4b..1277a7f22d 100644
--- a/manual/extending.html
+++ b/manual/extending.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/filters.html b/manual/filters.html
index 0adef1a8ed..f45d8114b9 100644
--- a/manual/filters.html
+++ b/manual/filters.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/flowtracing.html b/manual/flowtracing.html
index e81fef32de..9f67d0dd03 100644
--- a/manual/flowtracing.html
+++ b/manual/flowtracing.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/garbagefree.html b/manual/garbagefree.html
index 17436c4e03..29d072dd93 100644
--- a/manual/garbagefree.html
+++ b/manual/garbagefree.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/getting-started.html b/manual/getting-started.html
similarity index 63%
rename from getting-started.html
rename to manual/getting-started.html
index c6c2d344ce..c8a6755688 100644
--- a/getting-started.html
+++ b/manual/getting-started.html
@@ -4,12 +4,12 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Getting started :: Apache Log4j</title>
- <link rel="canonical" href="https://logging.apache.org/log4j/2.x/getting-started.html">
+ <link rel="canonical" href="https://logging.apache.org/log4j/2.x/manual/getting-started.html">
<meta name="generator" content="Antora 3.2.0-alpha.4">
-<link rel="stylesheet" href="./_/css/site.css">
-<link rel="icon" href="./_/../_images/favicon.ico" type="image/x-icon">
+<link rel="stylesheet" href="../_/css/site.css">
+<link rel="icon" href="../_/../_images/favicon.ico" type="image/x-icon">
<!-- `@asciidoctor/tabs` extension styles -->
-<link rel="stylesheet" href="./_/css/vendor/tabs.css">
+<link rel="stylesheet" href="../_/css/vendor/tabs.css">
<style>
/* Default `h4` and `h5` are smaller than the normal text, fix header font sizing: */
.doc h1 { font-size: 1.9rem; }
@@ -41,7 +41,7 @@
<nav class="navbar">
<div class="navbar-brand">
<div class="navbar-item">
- <img src="./_/../_images/logo-small-white.png" alt="Apache Log4j"/>
+ <img src="../_/../_images/logo-small-white.png" alt="Apache Log4j"/>
</div>
</div>
<div id="topbar-nav" class="navbar-menu">
@@ -58,16 +58,16 @@
<div class="nav-panel-menu is-active" data-panel="menu">
<nav class="nav-menu">
<button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
- <h3 class="title"><a href="index.html">Home</a></h3>
+ <h3 class="title"><a href="../index.html">Home</a></h3>
<ul class="nav-list">
<li class="nav-item" data-depth="0">
<ul class="nav-list">
<li class="nav-item" data-depth="1">
<button class="nav-item-toggle"></button>
- <a class="nav-link" href="download.html">Download</a>
+ <a class="nav-link" href="../download.html">Download</a>
<ul class="nav-list">
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="release-notes.html">Release Notes</a>
+ <a class="nav-link" href="../release-notes.html">Release Notes</a>
</li>
</ul>
</li>
@@ -84,83 +84,65 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
<li class="nav-item is-current-page" data-depth="1">
<a class="nav-link" href="getting-started.html">Getting started</a>
</li>
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ <a class="nav-link" href="installation.html">Installation</a>
</li>
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="architecture.html">Architecture</a>
</li>
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/installation.html">Installation</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/architecture.html">Architecture</a>
- </li>
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/api.html">API</a>
+ <a class="nav-link" href="api.html">API</a>
<ul class="nav-list">
<li class="nav-item" data-depth="2">
<button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/api.html#loggers">Loggers</a>
+ <a class="nav-link" href="api.html#loggers">Loggers</a>
<ul class="nav-list">
<li class="nav-item" data-depth="3">
- <a class="nav-link" href="manual/eventlogging.html">Event Logger</a>
+ <a class="nav-link" href="eventlogging.html">Event Logger</a>
</li>
<li class="nav-item" data-depth="3">
- <a class="nav-link" href="manual/resource-logger.html">Resource Logger</a>
+ <a class="nav-link" href="resource-logger.html">Resource Logger</a>
</li>
<li class="nav-item" data-depth="3">
- <a class="nav-link" href="manual/simple-logger.html">Simple Logger</a>
+ <a class="nav-link" href="simple-logger.html">Simple Logger</a>
</li>
<li class="nav-item" data-depth="3">
- <a class="nav-link" href="manual/status-logger.html">Status Logger</a>
+ <a class="nav-link" href="status-logger.html">Status Logger</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/logbuilder.html">Fluent API</a>
+ <a class="nav-link" href="logbuilder.html">Fluent API</a>
</li>
<li class="nav-item" data-depth="2">
<button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/api.html#fish-tagging">Fish tagging</a>
+ <a class="nav-link" href="api.html#fish-tagging">Fish tagging</a>
<ul class="nav-list">
<li class="nav-item" data-depth="3">
- <a class="nav-link" href="manual/customloglevels.html">Levels</a>
+ <a class="nav-link" href="customloglevels.html">Levels</a>
</li>
<li class="nav-item" data-depth="3">
- <a class="nav-link" href="manual/markers.html">Markers</a>
+ <a class="nav-link" href="markers.html">Markers</a>
</li>
<li class="nav-item" data-depth="3">
- <a class="nav-link" href="manual/scoped-context.html">Scoped Context</a>
+ <a class="nav-link" href="scoped-context.html">Scoped Context</a>
</li>
<li class="nav-item" data-depth="3">
- <a class="nav-link" href="manual/thread-context.html">Thread Context</a>
+ <a class="nav-link" href="thread-context.html">Thread Context</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/messages.html">Messages</a>
+ <a class="nav-link" href="messages.html">Messages</a>
</li>
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/flowtracing.html">Flow Tracing</a>
+ <a class="nav-link" href="flowtracing.html">Flow Tracing</a>
</li>
</ul>
</li>
@@ -169,58 +151,58 @@
<span class="nav-text">Configuration</span>
<ul class="nav-list">
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/configuration.html">Configuration file</a>
+ <a class="nav-link" href="configuration.html">Configuration file</a>
</li>
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/systemproperties.html">Configuration properties</a>
+ <a class="nav-link" href="systemproperties.html">Configuration properties</a>
</li>
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/customconfig.html">Programmatic Configuration</a>
+ <a class="nav-link" href="customconfig.html">Programmatic Configuration</a>
</li>
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/appenders.html">Appenders</a>
+ <a class="nav-link" href="appenders.html">Appenders</a>
</li>
<li class="nav-item" data-depth="2">
<button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/layouts.html">Layouts</a>
+ <a class="nav-link" href="layouts.html">Layouts</a>
<ul class="nav-list">
<li class="nav-item" data-depth="3">
- <a class="nav-link" href="manual/json-template-layout.html">JSON Template Layout</a>
+ <a class="nav-link" href="json-template-layout.html">JSON Template Layout</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/lookups.html">Lookups</a>
+ <a class="nav-link" href="lookups.html">Lookups</a>
</li>
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/filters.html">Filters</a>
+ <a class="nav-link" href="filters.html">Filters</a>
</li>
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/scripts.html">Scripts</a>
+ <a class="nav-link" href="scripts.html">Scripts</a>
</li>
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/jmx.html">JMX</a>
+ <a class="nav-link" href="jmx.html">JMX</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="1">
<button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/extending.html">Extending</a>
+ <a class="nav-link" href="extending.html">Extending</a>
<ul class="nav-list">
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/plugins.html">Plugins</a>
+ <a class="nav-link" href="plugins.html">Plugins</a>
</li>
</ul>
</li>
<li class="nav-item" data-depth="1">
<button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/performance.html">Performance</a>
+ <a class="nav-link" href="performance.html">Performance</a>
<ul class="nav-list">
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/async.html">Asynchronous loggers</a>
+ <a class="nav-link" href="async.html">Asynchronous loggers</a>
</li>
<li class="nav-item" data-depth="2">
- <a class="nav-link" href="manual/garbagefree.html">Garbage-free logging</a>
+ <a class="nav-link" href="garbagefree.html">Garbage-free logging</a>
</li>
</ul>
</li>
@@ -231,10 +213,34 @@
<span class="nav-text">References</span>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="plugin-reference.html">Plugin reference</a>
+ <a class="nav-link" href="../plugin-reference.html">Plugin reference</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../javadoc.html">Java API reference</a>
+ </li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
</li>
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="javadoc.html">Java API reference</a>
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
</li>
</ul>
</li>
@@ -243,16 +249,16 @@
<span class="nav-text">Components</span>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="log4j-flume-ng.html">Flume Appender</a>
+ <a class="nav-link" href="../log4j-flume-ng.html">Flume Appender</a>
</li>
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="log4j-iostreams.html">Log4j IOStreams</a>
+ <a class="nav-link" href="../log4j-iostreams.html">Log4j IOStreams</a>
</li>
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="log4j-docker.html">Log4j Docker Support</a>
+ <a class="nav-link" href="../log4j-docker.html">Log4j Docker Support</a>
</li>
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="log4j-spring-cloud-config-client.html">Log4j Spring Cloud Configuration</a>
+ <a class="nav-link" href="../log4j-spring-cloud-config-client.html">Log4j Spring Cloud Configuration</a>
</li>
</ul>
</li>
@@ -289,15 +295,15 @@
<main class="article">
<div class="toolbar" role="navigation">
<button class="nav-toggle"></button>
- <a href="index.html" class="home-link"></a>
+ <a href="../index.html" class="home-link"></a>
<nav class="breadcrumbs" aria-label="breadcrumbs">
<ul>
- <li><a href="index.html">Home</a></li>
- <li>Resources</li>
+ <li><a href="../index.html">Home</a></li>
+ <li><a href="index.html">Manual</a></li>
<li><a href="getting-started.html">Getting started</a></li>
</ul>
</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/logging-log4j2/edit/2.x/src/site/antora/modules/ROOT/pages/getting-started.adoc">Edit this Page</a></div>
+<div class="edit-this-page"><a href="https://github.com/apache/logging-log4j2/edit/2.x/src/site/antora/modules/ROOT/pages/manual/getting-started.adoc">Edit this Page</a></div>
</div>
<div class="content">
<aside class="toc sidebar" data-title="Contents" data-levels="4">
@@ -317,7 +323,7 @@ It is not a comprehensive guide, but it should give you a good starting point.</
<h2 id="what"><a class="anchor" href="#what"></a>What is logging?</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>Logging is the action of publishing diagnostics information at certain points of a program execution.
+<p>Logging is the act of publishing diagnostics information at certain points of a program execution.
It means you can write messages to a log file or console to help you understand what your application is doing.</p>
</div>
<div class="paragraph">
@@ -326,7 +332,7 @@ It means you can write messages to a log file or console to help you understand
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">private void truncateTable(String tableName) {
- System.out.println("Truncating table"); <i class="conum" data-value="1"></i><b>(1)</b>
+ System.out.println("truncating table"); <i class="conum" data-value="1"></i><b>(1)</b>
db.truncate(tableName);
}</code></pre>
</div>
@@ -341,18 +347,16 @@ It means you can write messages to a log file or console to help you understand
</div>
<div class="paragraph">
<p>This is already useful, but the reader of this message does not know what table is being truncated.
-Usually, we would like to include the table name in the message, which quickly leads
-developers to use the <code>System.out.format</code> (or similar) methods.
+Usually, we would like to include the table name in the message, which quickly leads developers to use <code>System.out.format()</code> or similar methods.
Log4j helps with formatting strings as we will see later, but for now, let’s see how to work without it.</p>
</div>
<div class="paragraph">
-<p>The following code shows how this method could be used to provide more context information.
-<code>%s</code> will be replaced with the value of <code>tableName</code>, and <code>%n</code> will be replaced with a new line.</p>
+<p>The following code shows how this method can be improved to provide more context about its action.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-java hljs" data-lang="java">private void truncateTable(String tableName) {
- System.out.format("[WARN] Truncating table `%s`%n", tableName); <i class="conum" data-value="1"></i><b>(1)</b>
+ System.out.format("[WARN] truncating table `%s`%n", tableName); <i class="conum" data-value="1"></i><b>(1)</b>
db.truncate(tableName);
}</code></pre>
</div>
@@ -361,20 +365,20 @@ Log4j helps with formatting strings as we will see later, but for now, let’
<table>
<tr>
<td><i class="conum" data-value="1"></i><b>1</b></td>
-<td><code>format</code> writes the message to the console, replacing <code>%s</code> with the value of <code>tableName</code>.</td>
+<td><code>format()</code> writes the message to the console, replacing <code>%s</code> with the value of <code>tableName</code>, and <code>%n</code> with a new line.</td>
</tr>
</table>
</div>
<div class="paragraph">
-<p>If the developer decides the truncate the table "fruits", the output of this code will look like this:</p>
+<p>If the developer decides the truncate the table <code>fruits</code>, the output of this code will look like this:</p>
</div>
<div class="listingblock">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-none hljs">[WARN] Truncating table `fruits`</code></pre>
+<pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">[WARN] Truncating table `fruits`</code></pre>
</div>
</div>
<div class="paragraph">
-<p>This provides observability into an application’s runtime and we can follow the execution flow.</p>
+<p>This provides observability into an application’s runtime, and we can follow the execution flow.</p>
</div>
<div class="paragraph">
<p>However, there are several drawbacks with the above approach and this is where Log4j comes in.
@@ -390,32 +394,73 @@ Log4j will help you to write logs in a more structured way, with more informatio
It can help us with common logging tasks and lets us focus on the application logic.</p>
</div>
<div class="paragraph">
-<p>It will:</p>
+<p>It helps with:</p>
</div>
<div class="ulist">
<ul>
<li>
-<p>Enhance the message with additional information (timestamp, class & method name, line number, host, severity, etc.)</p>
+<p>Enhancing the message with additional information (timestamp, file, class, and method name, line number, host, severity, etc.)</p>
</li>
<li>
-<p>Write the message differently, using a different <strong>layout</strong> (CSV, JSON, etc.)</p>
+<p>Formatting the message according to a given <strong>layout</strong> (CSV, JSON, etc.)</p>
</li>
<li>
-<p>Write the message to a different medium, using a different <strong>appender</strong> (file, socket, database, queue, etc.)</p>
+<p>Writing the message to various targets using an <strong>appender</strong> (console, file, socket, database, queue, etc.)</p>
</li>
<li>
-<p>Write only some of the messages, using a <strong>filter</strong> (e.g. filter by severity, content, etc.)</p>
+<p><strong>Filter</strong>ing messages to be written (e.g. filter by severity, content, etc.)</p>
</li>
</ul>
</div>
</div>
</div>
<div class="sect1">
-<h2 id="install"><a class="anchor" href="#install"></a>Prerequisites</h2>
+<h2 id="architecture"><a class="anchor" href="#architecture"></a>What is Log4j composed of?</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Log4j is essentially composed of a logging API called <strong>Log4j API</strong>, and its reference implementation called <strong>Log4j Core</strong>.
+Log4j also bundles several logging bridges to enable Log4j Core consume from foreign logging APIs.
+Let’s briefly explain these concepts:</p>
+</div>
+<div id="logging-api" class="dlist">
+<dl>
+<dt class="hdlist1">Logging API</dt>
+<dd>
+<p>A logging API is an interface your code or your dependencies directly logs against.
+It is required at compile-time.
+It is implementation agnostic to ensure that your application can write logs, but is not tied to a specific logging implementation.
+Log4j API, <a href="https://www.slf4j.org/">SLF4J</a>, <a href="https://docs.oracle.com/en/java/javase/8/core/java-logging-overview.html">JUL (Java Logging)</a>, <a href="https://commons.apache.org/proper/commons-logging/">JCL (Apache Commons Logging)</a>, <a href="https://openjdk.org/jeps/264">JPL (Java Platform Logging)</a> and <a href="https://github.com/jboss-logging/jboss-logging">JBoss Logging</a> are major logging APIs.</p>
+</dd>
+</dl>
+</div>
+<div id="logging-impl" class="dlist">
+<dl>
+<dt class="hdlist1">Logging implementation</dt>
+<dd>
+<p>A logging implementation is only required at runtime and can be changed without the need to recompile your software.
+Log4j Core, <a href="https://docs.oracle.com/en/java/javase/8/core/java-logging-overview.html">JUL (Java Logging)</a>, <a href="https://logback.qos.ch/">Logback</a> are the most well-known logging implementations.</p>
+</dd>
+</dl>
+</div>
+<div id="logging-bridge" class="dlist">
+<dl>
+<dt class="hdlist1">Logging bridge</dt>
+<dd>
+<p>Logging implementations accept input from a single logging API of their preference; Log4j Core from Log4j API, Logback from SLF4J, etc.
+A logging bridge is a simple logging implementation of a logging API that forwards all messages to a foreign logging API.
+Logging bridges allow a logging implementation to accept input from other logging APIs that are not their primary logging API.
+For instance, <code>log4j-slf4j2-impl</code> <em>bridges</em> SLF4J calls to Log4 API and effectively enables Log4j Core to accept input from SLF4J.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="prerequisites"><a class="anchor" href="#prerequisites"></a>What are the installation prerequisites?</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>We will need a <strong>BOM</strong> (Bill of Materials) to manage the versions of the dependencies.
-In addition, we will need the <code>log4j-api</code> dependency itself.</p>
+<p>We will need a BOM (Bill of Materials) to manage the versions of the dependencies.
+This way we won’t need to provide the version for each Log4j module explicitly.</p>
</div>
<div id="_tabs_1" class="openblock tabs is-loading">
<div class="content">
@@ -446,13 +491,6 @@ In addition, we will need the <code>log4j-api</code> dependency itself.</p>
</dependencies>
</dependencyManagement>
- <dependency>
- <dependency>
- <groupId>org.apache.logging.log4j</groupId>
- <artifactId>log4j-api</artifactId>
- </dependency>
- </dependency>
-
</project></code></pre>
</div>
</div>
@@ -462,7 +500,6 @@ In addition, we will need the <code>log4j-api</code> dependency itself.</p>
<div class="content">
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies {
implementation platform('org.apache.logging.log4j:log4j-bom:2.23.1')
- implementation 'org.apache.logging.log4j:log4j-api'
}</code></pre>
</div>
</div>
@@ -472,11 +509,59 @@ In addition, we will need the <code>log4j-api</code> dependency itself.</p>
</div>
</div>
<div class="sect1">
-<h2 id="logging"><a class="anchor" href="#logging"></a>How do I write logs using Log4j?</h2>
+<h2 id="using-api"><a class="anchor" href="#using-api"></a>How do I log using Log4j API?</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>To write logs, you need a <a href="../javadoc/log4j-api/org/apache/logging/log4j/Logger.html"><code>Logger</code></a> instance which you will retrieve from the <a href="../javadoc/log4j-api/org/apache/logging/log4j/LogManager.html"><code>LogManager</code></a>.
-You can use the <code>Logger</code> instance to write logs by using methods like <code>info()</code>, <code>warn()</code>, <code>error()</code>, etc.
+<p>To log, you need a <a href="../javadoc/log4j-api/org/apache/logging/log4j/Logger.html"><code>Logger</code></a> instance which you will retrieve from the <a href="../javadoc/log4j-api/org/apache/logging/log4j/LogManager.html"><code>LogManager</code></a>.
+These are all part of the <code>log4j-api</code> module, which you can install as follows:</p>
+</div>
+<div id="_tabs_2" class="openblock tabs is-loading">
+<div class="content">
+<div class="ulist tablist">
+<ul>
+<li id="_tabs_2_maven" class="tab">
+<p>Maven</p>
+</li>
+<li id="_tabs_2_gradle" class="tab">
+<p>Gradle</p>
+</li>
+</ul>
+</div>
+<div id="_tabs_2_maven--panel" class="tabpanel" aria-labelledby="_tabs_2_maven">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><project>
+
+ <!-- Assuming `log4j-bom` is added -->
+
+ <dependencies>
+ <dependency>
+ <groupId>org.apache.logging.log4j</groupId>
+ <artifactId>log4j-api</artifactId>
+ </dependency>
+ </dependencies>
+
+</project></code></pre>
+</div>
+</div>
+</div>
+<div id="_tabs_2_gradle--panel" class="tabpanel" aria-labelledby="_tabs_2_gradle">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies {
+
+ // Assuming `log4j-bom` is added
+
+ implementation 'org.apache.logging.log4j:log4j-api'
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="paragraph">
+<p>You can use the <code>Logger</code> instance to log by using methods like <code>info()</code>, <code>warn()</code>, <code>error()</code>, etc.
These methods are named after the <em>log levels</em> they represent, a way to categorize log events by severity.
The log message can also contain placeholders written as <code>{}</code> that will be replaced by the arguments passed to the method.</p>
</div>
@@ -558,7 +643,7 @@ Log4j will attach the last extra argument of type <code>Throwable</code> in a se
<div class="paragraph">
<p>There are several widespread bad practices while using Log4j API.
Below we will walk through the most common ones and see how to fix them.
-For a complete list, refer to <a href="manual/api.html#best-practice" class="xref page">the Log4j API best practices page</a>.</p>
+For a complete list, refer to <a href="api.html#best-practice" class="xref page">the Log4j API best practices page</a>.</p>
</div>
<div class="sect3">
<h4 id="best-practice-toString"><a class="anchor" href="#best-practice-toString"></a>Don’t use <code>toString()</code></h4>
@@ -661,50 +746,10 @@ Imagine <code>userId</code> being provided by the user with the following conten
</div>
</div>
<div class="sect1">
-<h2 id="architecture"><a class="anchor" href="#architecture"></a>Architecture</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>In a nutshell, Log4j operates with two main parts: the API and the Core.
-With this structure, Log4j allows you to log events using the API and route them through the Core.</p>
-</div>
-<div class="paragraph">
-<p>Optionally you can also route the log events through other logging frameworks
-like SLF4J or JUL (Java Util Logging) by adding a bridge.</p>
-</div>
-<div id="log4j-api" class="dlist">
-<dl>
-<dt class="hdlist1">Log4j API</dt>
-<dd>
-<p>This is the interface that you use in your application to log events.
-It needs to be available at compile-time and no configuration is needed.
-By using it, you ensure that your application can write logs but is not tied to a specific logging implementation.</p>
-</dd>
-</dl>
-</div>
-<div id="log4j-core" class="dlist">
-<dl>
-<dt class="hdlist1">Log4j Core</dt>
-<dd>
-<p>The Log4j Core is a logging implementation that processes log events.
-It is responsible for filtering, routing, encoding, and appending log events.
-This needs to be available at runtime and requires configuration by the user.
-When you deploy your application, you must also deploy the Log4j Core or any
-other logging implementation along with its configuration to consume all generated log events</p>
-</dd>
-</dl>
-</div>
-<div class="paragraph">
-<p>The following sections show you examples of how you can get started quickly with Log4j.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="config-app"><a class="anchor" href="#config-app"></a>How do I configure Log4j to run my <strong>application</strong>?</h2>
+<h2 id="install-app"><a class="anchor" href="#install-app"></a>How do I install Log4j Core to run my <strong>application</strong>?</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>The following section describes, how an application can be configured to use Log4j.
-It will add a configuration and some other artifacts to your application.
-The configuration shown here enhances the security and usability of your application.</p>
+<p>This section explains how to install Log4j Core to run an application.</p>
</div>
<div class="admonitionblock important">
<table>
@@ -715,35 +760,35 @@ The configuration shown here enhances the security and usability of your applica
<td class="content">
<div class="paragraph">
<p>Are you implementing not an <strong>application</strong>, but a <strong>library</strong>?
-Please skip to the <a href="#config-lib">How do I configure Log4j for my <strong>library</strong>?</a> instead.</p>
+Please refer to the <a href="#install-lib">How do I install Log4j Core for my <strong>library</strong>?</a> instead.</p>
</div>
</td>
</tr>
</table>
</div>
<div class="paragraph">
-<p>As mentioned, Log4j is using a logging API.
-First of all, add the <code>log4j-core</code> <strong>runtime</strong> dependency to our application.
+<p>First, add the <code>log4j-core</code> <strong>runtime</strong> dependency to your application.
Second, it is highly recommended to add the <code>log4j-layout-template-json</code> <strong>runtime</strong> dependency to encode log events in JSON.
-This is the most secure way to format log events and should preferred over the default <code>PatternLayout</code>, at least for production deployments.</p>
+This is the most secure way to format log events and should be preferred over the default <code>PatternLayout</code>, at least for production deployments.</p>
</div>
-<div id="_tabs_2" class="openblock tabs is-loading">
+<div id="_tabs_3" class="openblock tabs is-loading">
<div class="content">
<div class="ulist tablist">
<ul>
-<li id="_tabs_2_maven" class="tab">
+<li id="_tabs_3_maven" class="tab">
<p>Maven</p>
</li>
-<li id="_tabs_2_gradle" class="tab">
+<li id="_tabs_3_gradle" class="tab">
<p>Gradle</p>
</li>
</ul>
</div>
-<div id="_tabs_2_maven--panel" class="tabpanel" aria-labelledby="_tabs_2_maven">
+<div id="_tabs_3_maven--panel" class="tabpanel" aria-labelledby="_tabs_3_maven">
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><project>
- <!-- Assuming `log4j-bom` is already added -->
+
+ <!-- Assuming `log4j-bom` is added -->
<dependency>
@@ -760,18 +805,19 @@ This is the most secure way to format log events and should preferred over the d
<artifactId>log4j-layout-template-json</artifactId>
<scope>runtime</scope><i class="conum" data-value="1"></i><b>(1)</b>
</dependency>
+
</dependency>
</project></code></pre>
</div>
</div>
</div>
-<div id="_tabs_2_gradle--panel" class="tabpanel" aria-labelledby="_tabs_2_gradle">
+<div id="_tabs_3_gradle--panel" class="tabpanel" aria-labelledby="_tabs_3_gradle">
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies {
- // Assuming `log4j-bom` is already added
+ // Assuming `log4j-bom` is added
// The logging implementation (i.e., Log4j Core)
runtimeOnly 'org.apache.logging.log4j:log4j-core' <i class="conum" data-value="1"></i><b>(1)</b>
@@ -788,26 +834,100 @@ This is the most secure way to format log events and should preferred over the d
<table>
<tr>
<td><i class="conum" data-value="1"></i><b>1</b></td>
-<td>Note that the logging implementation and bridges are only needed at runtime.</td>
+<td>For applications, the logging implementation need to be runtime dependencies.</td>
</tr>
</table>
</div>
<div class="paragraph">
-<p>Now it is time to configure Log4j and instruct how the log events should be routed.</p>
+<p>If your application has (direct or transitive!) dependencies that use another logging API, you need to <a href="#logging-bridge">bridge</a> that to Log4j.
+This way the foreign logging API calls will effectively be consumed by Log4j too.
+<a href="https://www.slf4j.org/">SLF4J</a> is another logging API used pretty common in the wild.
+(<a href="installation.html" class="xref page">Installation</a> covers all supported foreign APIs.)
+Let’s see how you can use the <code>log4j-slf4j2-impl</code> bridge to support SLF4J:</p>
+</div>
+<div id="_tabs_4" class="openblock tabs is-loading">
+<div class="content">
+<div class="ulist tablist">
+<ul>
+<li id="_tabs_4_maven" class="tab">
+<p>Maven</p>
+</li>
+<li id="_tabs_4_gradle" class="tab">
+<p>Gradle</p>
+</li>
+</ul>
+</div>
+<div id="_tabs_4_maven--panel" class="tabpanel" aria-labelledby="_tabs_4_maven">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><project>
+
+ <!-- Assuming `log4j-bom` is added -->
+
+ <dependency>
+
+ <!-- Assuming `log4j-core` and `log4j-layout-template-json` is added -->
+
+ <!-- SLF4J-to-Log4j bridge --><i class="conum" data-value="2"></i><b>(2)</b>
+ <dependency>
+ <groupId>org.apache.logging.log4j</groupId>
+ <artifactId>log4j-slf4j2-impl</artifactId>
+ <scope>runtime</scope><i class="conum" data-value="1"></i><b>(1)</b>
+ </dependency>
+
+ </dependency>
+
+</project></code></pre>
+</div>
+</div>
+</div>
+<div id="_tabs_4_gradle--panel" class="tabpanel" aria-labelledby="_tabs_4_gradle">
+<div class="listingblock">
+<div class="content">
+<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies {
+
+ // Assuming `log4j-bom`, `log4j-core`, and `log4j-layout-template-json` is added
+
+ // SLF4J-to-Log4j bridge <i class="conum" data-value="2"></i><b>(2)</b>
+ runtimeOnly 'org.apache.logging.log4j:log4j-slf4j2-impl' <i class="conum" data-value="1"></i><b>(1)</b>
+
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+</div>
+<div class="colist arabic">
+<table>
+<tr>
+<td><i class="conum" data-value="1"></i><b>1</b></td>
+<td>For applications, bridges need to be runtime dependencies.</td>
+</tr>
+<tr>
+<td><i class="conum" data-value="2"></i><b>2</b></td>
+<td>Log4j module bridging SLF4J to Log4j</td>
+</tr>
+</table>
</div>
<div class="paragraph">
-<p>The <a href="manual/json-template-layout.html" class="xref page">JSON Template Layout</a> is used to encode log events in JSON.
-Once encoded <a href="manual/appenders.html" class="xref page">Appenders</a> are responsible for writing log events to the console, file, socket, database, etc.</p>
+<p>To complete the installation, Log4j needs to be configured.
+Please continue with <a href="#config-app">How do I configure Log4j Core to run my application?</a></p>
+</div>
+</div>
</div>
+<div class="sect1">
+<h2 id="config-app"><a class="anchor" href="#config-app"></a>How do I configure Log4j Core to run my application?</h2>
+<div class="sectionbody">
<div class="paragraph">
-<p>The <code><logger></code> defines, that log events generated by classes in the <code>com.mycompany</code> package (incl. its sub-packages) and that are of level <code>INFO</code> and higher (i.e., <code>WARN</code>, <code>ERROR</code>, <code>FATAL</code>) will be consumed.
-Finally, the <code><root></code> logger defines that log events of level <code>WARN</code> and higher will be consumed unless specified otherwise. It serves as a default configuration.</p>
+<p>This section explains configuring Log4j on how log events should be processed.</p>
</div>
<div class="paragraph">
-<p>Save the following XML document to <code>src/<strong>main</strong>/resources/log4j2.xml</code>.</p>
+<p><a href="configuration.html" class="xref page">Log4j supports several configuration inputs and file formats.</a>
+Let’s start with a basic and robust configuration where the logs are encoded in JSON and written to the console.
+Save the following XML-formatted Log4j <strong>configuration file</strong> to <code>src/<strong>main</strong>/resources/<strong>log4j2.xml</strong></code> in your application.</p>
</div>
<div class="listingblock">
-<div class="title">An example <code>src/<strong>main</strong>/resources/log4j2.xml</code></div>
+<div class="title">An example <code>src/<strong>main</strong>/resources/<strong>log4j2.xml</strong></code></div>
<div class="content">
<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<Configuration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -816,18 +936,18 @@ Finally, the <code><root></code> logger defines that log events of level <
https://logging.apache.org/xml/ns
https://logging.apache.org/xml/ns/log4j-config-2.xsd">
- <appenders><i class="conum" data-value="1"></i><b>(1)</b>
+ <Appenders><i class="conum" data-value="1"></i><b>(1)</b>
<Console name="CONSOLE"><i class="conum" data-value="2"></i><b>(2)</b>
<JsonTemplateLayout/><i class="conum" data-value="3"></i><b>(3)</b>
</Console>
- </appenders>
+ </Appenders>
- <loggers>
- <logger name="com.mycompany" level="INFO"/><i class="conum" data-value="4"></i><b>(4)</b>
- <root level="WARN"><i class="conum" data-value="5"></i><b>(5)</b>
+ <Loggers>
+ <Logger name="com.mycompany" level="INFO"/><i class="conum" data-value="4"></i><b>(4)</b>
+ <Root level="WARN"><i class="conum" data-value="5"></i><b>(5)</b>
<AppenderRef ref="CONSOLE"/><i class="conum" data-value="6"></i><b>(6)</b>
- </root>
- </loggers>
+ </Root>
+ </Loggers>
</Configuration></code></pre>
</div>
@@ -836,71 +956,94 @@ Finally, the <code><root></code> logger defines that log events of level <
<table>
<tr>
<td><i class="conum" data-value="1"></i><b>1</b></td>
-<td><a href="manual/appenders.html" class="xref page">Appenders</a> are responsible for writing log events to their target</td>
+<td><a href="appenders.html" class="xref page">Appenders</a> are responsible for writing log events to a particular target; console, file, socket, database, queue, etc.</td>
</tr>
<tr>
<td><i class="conum" data-value="2"></i><b>2</b></td>
-<td><a href="manual/appenders.html#ConsoleAppender" class="xref page">Console Appender</a> writes logs to the console.</td>
+<td><a href="appenders.html#ConsoleAppender" class="xref page">Console Appender</a> writes logs to the console.</td>
</tr>
<tr>
<td><i class="conum" data-value="3"></i><b>3</b></td>
-<td><a href="manual/json-template-layout.html" class="xref page">JSON Template Layout</a> encodes log events in JSON.</td>
+<td><a href="layouts.html" class="xref page">Layouts</a> are responsible for encoding log events before appenders writing them.
+<a href="json-template-layout.html" class="xref page">JSON Template Layout</a> encodes log events in JSON.</td>
</tr>
<tr>
<td><i class="conum" data-value="4"></i><b>4</b></td>
-<td>Log events from <code>com.mycompany</code> and its sub-packages, at <code>INFO</code> level or higher, are consumed.</td>
+<td>Log events generated by classes in the <code>com.mycompany</code> package (incl. its sub-packages) and that are of level <code>INFO</code> or higher (i.e., <code>WARN</code>, <code>ERROR</code>, <code>FATAL</code>) will be accepted.</td>
</tr>
<tr>
<td><i class="conum" data-value="5"></i><b>5</b></td>
-<td>Unless specified otherwise, log events of level <code>WARN</code> and higher will be consumed.</td>
+<td>Unless specified otherwise, log events of level <code>WARN</code> and higher will be accepted.
+It serves as the default <code><logger></code> configuration.</td>
</tr>
<tr>
<td><i class="conum" data-value="6"></i><b>6</b></td>
-<td>Unless specified otherwise, log events will be forwarded to the <code>console</code> appender defined earlier.</td>
+<td>Unless specified otherwise, accepted log events will be forwarded to the <code>console</code> appender defined earlier.</td>
</tr>
</table>
</div>
<div class="paragraph">
-<p>If you want to configure Log4j for tests, you are strongly advised to use a different Log4j configuration.
-Continue to <a href="#config-test">How do I configure Log4j for tests?</a></p>
+<p>Next, you need to you need to configure Log4j for the tests of your application.
+Please proceed to <a href="#config-test">How do I configure Log4j Core for tests?</a></p>
</div>
</div>
</div>
<div class="sect1">
-<h2 id="integrating-log4j"><a class="anchor" href="#integrating-log4j"></a>Integrating Log4j with SLF4J</h2>
+<h2 id="install-lib"><a class="anchor" href="#install-lib"></a>How do I install Log4j Core for my <strong>library</strong>?</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>In many cases, you might have a library that logs through SLF4J.
-Due to the separation of Log4js API and Core, you can add a bridge to forward SLF4J calls to the Log4j API.
-This way, SLF4J calls will be processed by Log4j Core too.</p>
+<p>This section explains how to install Log4j Core for libraries.</p>
</div>
+<div class="admonitionblock important">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-important" title="Important"></i>
+</td>
+<td class="content">
<div class="paragraph">
-<p>It is similarly easy: just add the new dependency `log4j-slf4j2-impl to your application.</p>
+<p>Are you implementing not a <strong>library</strong>, but an <strong>application</strong>?
+Please refer to <a href="#install-app">How do I install Log4j Core to run my <strong>application</strong>?</a> instead.</p>
</div>
-<div id="_tabs_3" class="openblock tabs is-loading">
+</td>
+</tr>
+</table>
+</div>
+<div class="paragraph">
+<p>Unlike applications, libraries should be logging implementation agnostic.
+That is, <strong>libraries should log through a logging API, but leave the decision of the logging implementation to the application</strong>.
+That said, libraries need a logging implementation while running their tests.</p>
+</div>
+<div class="paragraph">
+<p>Let’s see how you can install Log4j Core for your tests.
+Start with adding the <code>log4j-core</code> dependency in <strong>test</strong> scope to your library:</p>
+</div>
+<div id="_tabs_5" class="openblock tabs is-loading">
<div class="content">
<div class="ulist tablist">
<ul>
-<li id="_tabs_3_maven" class="tab">
+<li id="_tabs_5_maven" class="tab">
<p>Maven</p>
</li>
-<li id="_tabs_3_gradle" class="tab">
+<li id="_tabs_5_gradle" class="tab">
<p>Gradle</p>
</li>
</ul>
</div>
-<div id="_tabs_3_maven--panel" class="tabpanel" aria-labelledby="_tabs_3_maven">
+<div id="_tabs_5_maven--panel" class="tabpanel" aria-labelledby="_tabs_5_maven">
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><project>
- <!-- Other dependencies -->
+
+ <!-- Assuming `log4j-bom` is added -->
<dependency>
- <!-- SLF4J-to-Log4j bridge --><i class="conum" data-value="2"></i><b>(2)</b>
+
+ <!-- Logging implementation (Log4j Core) -->
<dependency>
- <groupId>org.apache.logging.log4j</groupId>
- <artifactId>log4j-slf4j2-impl</artifactId>
- <scope>runtime</scope><i class="conum" data-value="1"></i><b>(1)</b>
+ <groupId>org.apache.logging.log4j</groupId>
+ <artifactId>log4j-core</artifactId>
+ <scope>test</scope><i class="conum" data-value="1"></i><b>(1)</b>
</dependency>
</dependency>
@@ -909,14 +1052,15 @@ This way, SLF4J calls will be processed by Log4j Core too.</p>
</div>
</div>
</div>
-<div id="_tabs_3_gradle--panel" class="tabpanel" aria-labelledby="_tabs_3_gradle">
+<div id="_tabs_5_gradle--panel" class="tabpanel" aria-labelledby="_tabs_5_gradle">
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies {
- // Other dependencies
- // SLF4J-to-Log4j bridge <i class="conum" data-value="2"></i><b>(2)</b>
- runtimeOnly 'org.apache.logging.log4j:log4j-slf4j2-impl' <i class="conum" data-value="1"></i><b>(1)</b>
+ // Assuming `log4j-bom` is already added
+
+ // The logging implementation (i.e., Log4j Core)
+ testRuntimeOnly 'org.apache.logging.log4j:log4j-core' <i class="conum" data-value="1"></i><b>(1)</b>
}</code></pre>
</div>
@@ -928,73 +1072,39 @@ This way, SLF4J calls will be processed by Log4j Core too.</p>
<table>
<tr>
<td><i class="conum" data-value="1"></i><b>1</b></td>
-<td>Again, we only need a runtime dependency.</td>
-</tr>
-<tr>
-<td><i class="conum" data-value="2"></i><b>2</b></td>
-<td>This dependency will forward SLF4J calls to the Log4j API.</td>
-</tr>
-</table>
-</div>
-<div class="paragraph">
-<p><code>log4j-slf4j2-impl</code> forwards SLF4J calls to Log4j API, which effectively gets processed by Log4j Core too.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="config-lib"><a class="anchor" href="#config-lib"></a>How do I configure Log4j for my <strong>library</strong>?</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Unlike applications, libraries should be logging implementation agnostic.
-That is, <strong>libraries should log through a logging API, but leave the decision of the logging implementation to the application</strong>.
-That said, libraries need a logging implementation while running their tests.</p>
-</div>
-<div class="admonitionblock important">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-important" title="Important"></i>
-</td>
-<td class="content">
-<div class="paragraph">
-<p>Are you implementing not a <strong>library</strong>, but an <strong>application</strong>?
-Please skip to the <a href="#config-app">How do I configure Log4j to run my <strong>application</strong>?</a> instead.</p>
-</div>
-</td>
+<td>For tests of libraries, the logging implementation is only needed in test scope.</td>
</tr>
</table>
</div>
<div class="paragraph">
-<p>Add the <code>log4j-core</code> dependency in <strong>test</strong> scope to your library.
-Very similar to the previous section, in most cases it is useful to also add the <code>log4j-slf4j2-impl</code> dependency.
-SLF4J is a widely used logging API and this way, SLF4J calls will be processed by Log4j Core too.</p>
+<p>If your library has (direct or transitive!) dependencies that use another logging API, you need to <a href="#logging-bridge">bridge</a> that to Log4j.
+This way the foreign logging API calls will effectively be consumed by Log4j too.
+<a href="https://www.slf4j.org/">SLF4J</a> is another logging API used pretty common in the wild.
+(<a href="installation.html" class="xref page">Installation</a> covers all supported foreign APIs.)
+Let’s see how you can use the <code>log4j-slf4j2-impl</code> bridge to support SLF4J:</p>
</div>
-<div id="_tabs_4" class="openblock tabs is-loading">
+<div id="_tabs_6" class="openblock tabs is-loading">
<div class="content">
<div class="ulist tablist">
<ul>
-<li id="_tabs_4_maven" class="tab">
+<li id="_tabs_6_maven" class="tab">
<p>Maven</p>
</li>
-<li id="_tabs_4_gradle" class="tab">
+<li id="_tabs_6_gradle" class="tab">
<p>Gradle</p>
</li>
</ul>
</div>
-<div id="_tabs_4_maven--panel" class="tabpanel" aria-labelledby="_tabs_4_maven">
+<div id="_tabs_6_maven--panel" class="tabpanel" aria-labelledby="_tabs_6_maven">
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><project>
- <!-- Assuming `log4j-bom` is already added -->
+
+ <!-- Assuming `log4j-bom` is added -->
<dependency>
- <!-- The logging implementation (i.e., Log4j Core) -->
- <dependency>
- <groupId>org.apache.logging.log4j</groupId>
- <artifactId>log4j-core</artifactId>
- <scope>test</scope><i class="conum" data-value="1"></i><b>(1)</b>
- </dependency>
+ <!-- Assuming `log4j-core` and `log4j-layout-template-json` is added -->
<!-- SLF4J-to-Log4j bridge --><i class="conum" data-value="2"></i><b>(2)</b>
<dependency>
@@ -1009,18 +1119,15 @@ SLF4J is a widely used logging API and this way, SLF4J calls will be processed b
</div>
</div>
</div>
-<div id="_tabs_4_gradle--panel" class="tabpanel" aria-labelledby="_tabs_4_gradle">
+<div id="_tabs_6_gradle--panel" class="tabpanel" aria-labelledby="_tabs_6_gradle">
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-groovy hljs" data-lang="groovy">dependencies {
- // Assuming `log4j-bom` is already added
-
- // The logging implementation (i.e., Log4j Core)
- testRuntimeOnly 'org.apache.logging.log4j:log4j-core' <i class="conum" data-value="1"></i><b>(1)</b>
+ // Assuming `log4j-bom`, `log4j-core`, and `log4j-layout-template-json` is added
// SLF4J-to-Log4j bridge <i class="conum" data-value="2"></i><b>(2)</b>
- testRuntimeOnly 'org.apache.logging.log4j:log4j-slf4j2-impl' <i class="conum" data-value="1"></i><b>(1)</b>
+ runtimeOnly 'org.apache.logging.log4j:log4j-slf4j2-impl' <i class="conum" data-value="1"></i><b>(1)</b>
}</code></pre>
</div>
@@ -1032,39 +1139,53 @@ SLF4J is a widely used logging API and this way, SLF4J calls will be processed b
<table>
<tr>
<td><i class="conum" data-value="1"></i><b>1</b></td>
-<td>Note that the logging implementation and bridges are only needed for tests.</td>
+<td>For tests of libraries, logging bridges are only needed in test scope.</td>
</tr>
<tr>
<td><i class="conum" data-value="2"></i><b>2</b></td>
-<td><code>log4j-slf4j2-impl</code> forwards SLF4J calls to the Log4j API.</td>
+<td>Log4j module bridging SLF4J to Log4j</td>
</tr>
</table>
</div>
<div class="paragraph">
-<p>Next, you need a <code>src/<strong>test</strong>/resources/log4j2-test.xml</code>.
-See <a href="#config-test">How do I configure Log4j for tests?</a></p>
+<p>Next, you need to you need to configure Log4j.
+Please proceed to <a href="#config-test">How do I configure Log4j Core for tests?</a></p>
</div>
</div>
</div>
<div class="sect1">
-<h2 id="config-test"><a class="anchor" href="#config-test"></a>How do I configure Log4j for tests?</h2>
+<h2 id="config-test"><a class="anchor" href="#config-test"></a>How do I configure Log4j Core for tests?</h2>
<div class="sectionbody">
<div class="paragraph">
-<p>For tests, prefer a human-readable layout with increased verbosity.
-While it is not recommended to use the <code>PatternLayout</code> in production for security reasons, it is a good choice for tests.</p>
+<p>This section explains configuring Log4j on how log events should be processed for tests.</p>
+</div>
+<div class="paragraph">
+<p><a href="configuration.html" class="xref page">Log4j supports several configuration inputs and file formats.</a>
+Let’s start with a basic and developer-friendly configuration where the logs are pretty-printed in a human-readable way and written to the console.</p>
+</div>
+<div class="paragraph">
+<p>Contrast to <a href="#config-app">an application’s more conservative Log4j setup</a>, for tests, we will go with a more developer-friendly Log4j configuration where</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>the logs are pretty-printed to the console, and</p>
+</li>
+<li>
+<p>logging verbosity is increased.</p>
+</li>
+</ol>
</div>
<div class="paragraph">
-<p>The <a href="manual/layouts.html#pattern-layout" class="xref page">Pattern Layout</a> is used for formatting strings in a specific way.
-In the below case, it will include the timestamp, thread name, log level, class name, and the message and
-print it to the Console.
-Very similar to the earlier configuration, the <code><logger></code> defines what should be logged on
-which level and the <code><root></code> logger serves as a default configuration.</p>
+<p>While it is not recommended to use <a href="layouts.html#pattern-layout" class="xref page">Pattern Layout</a> in production for security reasons, it is a good choice for tests to encode log events.
+We will use it to pretty-print the log event to the console with extra fields: timestamp, thread name, log level, class name, etc.
+The rest of the configuration should look familiar from earlier sections.</p>
</div>
<div class="paragraph">
-<p>Save the following XML document to <code>src/<strong>test</strong>/resources/log4j2-test.xml</code>.</p>
+<p>Save the following XML-formatted Log4j configuration file to <code>src/<strong>test</strong>/resources/<strong>log4j2-test.xml</strong></code>.</p>
</div>
<div class="listingblock">
-<div class="title">An example <code>src/<strong>test</strong>/resources/log4j2-test.xml</code></div>
+<div class="title">An example <code>src/<strong>test</strong>/resources/<strong>log4j2-test.xml</strong></code></div>
<div class="content">
<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><?xml version="1.0" encoding="UTF-8"?>
<Configuration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -1073,18 +1194,18 @@ which level and the <code><root></code> logger serves as a default configu
https://logging.apache.org/xml/ns
https://logging.apache.org/xml/ns/log4j-config-2.xsd">
- <appenders>
+ <Appenders>
<Console name="CONSOLE">
<PatternLayout pattern="%d [%t] %5p %c{1.} - %m%n"/><i class="conum" data-value="1"></i><b>(1)</b>
</Console>
- </appenders>
+ </Appenders>
- <loggers>
- <logger name="com.mycompany" level="DEBUG"/><i class="conum" data-value="2"></i><b>(2)</b>
- <root level="WARN">
+ <Loggers>
+ <Logger name="com.mycompany" level="DEBUG"/><i class="conum" data-value="2"></i><b>(2)</b>
+ <Root level="WARN">
<AppenderRef ref="CONSOLE"/>
- </root>
- </loggers>
+ </Root>
+ </Loggers>
</Configuration></code></pre>
</div>
@@ -1093,7 +1214,7 @@ which level and the <code><root></code> logger serves as a default configu
<table>
<tr>
<td><i class="conum" data-value="1"></i><b>1</b></td>
-<td><a href="manual/layouts.html#pattern-layout" class="xref page">Pattern Layout</a> is used for a human-readable layout.</td>
+<td><a href="layouts.html#pattern-layout" class="xref page">Pattern Layout</a> is used for encoding the log event in a human-readable way.</td>
</tr>
<tr>
<td><i class="conum" data-value="2"></i><b>2</b></td>
@@ -1106,38 +1227,50 @@ which level and the <code><root></code> logger serves as a default configu
<div class="sect1">
<h2 id="next"><a class="anchor" href="#next"></a>What is next?</h2>
<div class="sectionbody">
+<div class="paragraph">
+<p>At this stage, you know</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>How to install Log4j API and log using it</p>
+</li>
+<li>
+<p>How to install and configure Log4j Core in your application/library</p>
+</li>
+</ol>
+</div>
+<div class="paragraph">
+<p>You can use following pointers to further customize your Log4j setup.</p>
+</div>
<div class="dlist">
<dl>
-<dt class="hdlist1">More details</dt>
-<dd>
-<p>If you are looking for a more detailed read, please see <a href="https://logging.apache.org/what-is-logging.html">What is logging?</a>.</p>
-</dd>
<dt class="hdlist1">Installation</dt>
<dd>
<p>While shared dependency management snippets should get you going, your case might necessitate a more intricate setup.
Are you dealing with a Spring Boot application?
Is it running in a Java EE container?
Do you need to take into account other logging APIs such as JUL, JPL, JCL, etc.?
-See <a href="manual/installation.html" class="xref page">Installation</a> for the complete installation guide.</p>
+See <a href="installation.html" class="xref page">Installation</a> for the complete installation guide.</p>
</dd>
<dt class="hdlist1">Configuration</dt>
<dd>
<p>Log4j can be configured in several ways in various file formats (XML, JSON, Properties, and YAML).
-See the <a href="manual/configuration.html" class="xref page">Configuration</a> page for details.</p>
+See the <a href="configuration.html" class="xref page">Configuration</a> page for details.</p>
</dd>
<dt class="hdlist1">Appenders & Layouts</dt>
<dd>
-<p>Log4j contains several <a href="manual/appenders.html" class="xref page">appenders</a> and <a href="manual/layouts.html" class="xref page">layouts</a> to compose a configuration that best suit your needs.</p>
+<p>Log4j contains several <a href="appenders.html" class="xref page">appenders</a> and <a href="layouts.html" class="xref page">layouts</a> to compose a configuration that best suit your needs.</p>
</dd>
<dt class="hdlist1">Performance</dt>
<dd>
<p>Do you want to get the best performance out of your logging system?
-Make sure to check out the <a href="manual/performance.html" class="xref page">Performance</a> page.</p>
+Make sure to check out the <a href="performance.html" class="xref page">Performance</a> page.</p>
</dd>
<dt class="hdlist1">Architecture</dt>
<dd>
<p>Want to learn more about loggers, contexts, and how these are all wired together?
-See the <a href="manual/architecture.html" class="xref page">Architecture</a> page.</p>
+See the <a href="architecture.html" class="xref page">Architecture</a> page.</p>
</dd>
<dt class="hdlist1">Support</dt>
<dd>
@@ -1165,9 +1298,9 @@ See the <a href="https://logging.apache.org/support.html">Support</a> page.</p>
Other names may be trademarks of their respective owners.
</p>
</footer>
-<script id="site-script" src="./_/js/site.js" data-ui-root-path="./_"></script>
-<script async src="./_/js/vendor/highlight.js"></script>
+<script id="site-script" src="../_/js/site.js" data-ui-root-path="../_"></script>
+<script async src="../_/js/vendor/highlight.js"></script>
<!-- `@asciidoctor/tabs` extension scripts -->
-<script async src="./_/js/vendor/tabs.js"></script>
+<script async src="../_/js/vendor/tabs.js"></script>
</body>
</html>
diff --git a/manual/index.html b/manual/index.html
index 9a29388285..f59282fda7 100644
--- a/manual/index.html
+++ b/manual/index.html
@@ -80,33 +80,15 @@
</li>
</ul>
</li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
-<ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
</ul>
</li>
<li class="nav-item is-current-page" data-depth="0">
<button class="nav-item-toggle"></button>
<a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="getting-started.html">Getting started</a>
+ </li>
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
@@ -304,8 +310,7 @@
</aside>
<article class="doc">
<h1 class="page">Manual</h1>
-<div class="sect1">
-<h2 id="_welcome_to_apache_log4j"><a class="anchor" href="#_welcome_to_apache_log4j"></a>Welcome to Apache Log4j!</h2>
+<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
<p>Apache Log4j is a versatile, industrial-grade Java logging framework composed of an API, its implementation, and components to assist the deployment for various use cases.
@@ -334,7 +339,8 @@ In 2003, the project was donated to the Apache Software Foundation, which became
<p>Log4j is an excellent choice for any Java application that needs logging capabilities.
It is user-friendly, fast, and flexible. You can use it to log messages at
different levels of severity, from debug to fatal, and you can configure it to
-log messages to various destinations, such as files, databases, or the console.</p>
+log messages to various destinations, such as files, databases, or the console.
+See <a href="getting-started.html" class="xref page">Getting started</a> for an introduction.</p>
</div>
</div>
</div>
@@ -420,6 +426,9 @@ While Log4j Core implements it at its fullest, you can easily switch to other im
<div class="ulist">
<ul>
<li>
+<p><a href="getting-started.html" class="xref page">How can I get started with Log4j?</a></p>
+</li>
+<li>
<p><a href="installation.html" class="xref page">How can I install Log4j?</a></p>
</li>
<li>
diff --git a/manual/installation.html b/manual/installation.html
index 320334a775..f4da7b318b 100644
--- a/manual/installation.html
+++ b/manual/installation.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item is-current-page" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
@@ -313,7 +319,7 @@
</div>
</div>
<div class="sect1">
-<h2 id="impatient"><a class="anchor" href="#impatient"></a>For the impatient</h2>
+<h2 id="shortcuts"><a class="anchor" href="#shortcuts"></a>Shortcuts</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Below we share some shortcuts for the impatient.</p>
@@ -363,7 +369,8 @@ See <a href="#impl-core">Installing Log4j Core</a>.</p>
<dt class="hdlist1">Logging API</dt>
<dd>
<p>A logging API is an interface your code or your dependencies directly logs against.
-It is implementation agnostic.
+It is required at compile-time.
+It is implementation agnostic to ensure that your application can write logs, but is not tied to a specific logging implementation.
Log4j API, <a href="https://www.slf4j.org/">SLF4J</a>, <a href="https://docs.oracle.com/en/java/javase/8/core/java-logging-overview.html">JUL (Java Logging)</a>, <a href="https://commons.apache.org/proper/commons-logging/">JCL (Apache Commons Logging)</a>, <a href="https://openjdk.org/jeps/264">JPL (Java Platform Logging)</a> and <a href="https://github.com/jboss-logging/jboss-logging">JBoss Logging</a> are major logging APIs.</p>
</dd>
</dl>
@@ -374,21 +381,6 @@ Log4j API, <a href="https://www.slf4j.org/">SLF4J</a>, <a href="https://docs.ora
<dd>
<p>A logging implementation is only required at runtime and can be changed without the need to recompile your software.
Log4j Core, <a href="https://docs.oracle.com/en/java/javase/8/core/java-logging-overview.html">JUL (Java Logging)</a>, <a href="https://logback.qos.ch/">Logback</a> are the most well-known logging implementations.</p>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-<div class="paragraph">
-<p>Note that JUL and Log4j provide both an API and its implementation.
-In the case of Log4j, the API is called <em>Log4j API</em>, and its reference implementation is called <em>Log4j Core</em>.</p>
-</div>
-</td>
-</tr>
-</table>
-</div>
</dd>
</dl>
</div>
@@ -416,9 +408,8 @@ If a logging implementation is required by tests of the library, it should be in
<dt class="hdlist1">Applications</dt>
<dd>
<p>They need a logging implementation, but also bridges of each of the major logging APIs to support log statements from the libraries they use.
-For instance, your application might be logging against Log4j API and one of its dependencies against SLF4J.
-In this case, you need to install <code>log4j-core</code> and <code>log4j-slf4j2-impl</code>.
-(This is an example, we will elaborate on this case more in <a href="#impl-core">Installing Log4j Core</a>.)</p>
+For example, your application might be logging against Log4j API and one of its dependencies against SLF4J.
+In this case, you need to install <code>log4j-core</code> and <code>log4j-slf4j2-impl</code>.</p>
</dd>
</dl>
</div>
@@ -952,8 +943,8 @@ build tool:</p>
<div class="sect4">
<h5 id="impl-core-bridge-jboss-logging"><a class="anchor" href="#impl-core-bridge-jboss-logging"></a>Installing JBoss Logging-to-Log4j bridge</h5>
<div class="paragraph">
-<p>The JBoss Logging API is shipped with an integrated bridge to Log4j API and requires no steps on your part. See
-<a href="https://github.com/jboss-logging/jboss-logging?tab=readme-ov-file#supported-log-managers">Supported Log Managers</a> for more information.</p>
+<p>The JBoss Logging API is shipped with an integrated bridge to Log4j API and requires no steps on your part.
+See <a href="https://github.com/jboss-logging/jboss-logging?tab=readme-ov-file#supported-log-managers">Supported Log Managers</a> for more information.</p>
</div>
</div>
</div>
diff --git a/manual/jmx.html b/manual/jmx.html
index b71f6c2607..2d059ae823 100644
--- a/manual/jmx.html
+++ b/manual/jmx.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/json-template-layout.html b/manual/json-template-layout.html
index f8a3f2dbdd..82024cd9cb 100644
--- a/manual/json-template-layout.html
+++ b/manual/json-template-layout.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/layouts.html b/manual/layouts.html
index 19cea3c923..f0bb8d6622 100644
--- a/manual/layouts.html
+++ b/manual/layouts.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/logbuilder.html b/manual/logbuilder.html
index 8e56b41a4b..d879cef0a2 100644
--- a/manual/logbuilder.html
+++ b/manual/logbuilder.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/logsep.html b/manual/logsep.html
index 1a30760285..059db55ba9 100644
--- a/manual/logsep.html
+++ b/manual/logsep.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/lookups.html b/manual/lookups.html
index 7b5cd45a35..917ab3b8d9 100644
--- a/manual/lookups.html
+++ b/manual/lookups.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/markers.html b/manual/markers.html
index 109e706cd0..aa705d3841 100644
--- a/manual/markers.html
+++ b/manual/markers.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/messages.html b/manual/messages.html
index da2b25f728..23136aea8f 100644
--- a/manual/messages.html
+++ b/manual/messages.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/migration.html b/manual/migration.html
index ce1afa5356..06125088ee 100644
--- a/manual/migration.html
+++ b/manual/migration.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item is-current-page" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/performance.html b/manual/performance.html
index 357fbf76da..9124d8bb54 100644
--- a/manual/performance.html
+++ b/manual/performance.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/plugins.html b/manual/plugins.html
index 3c2cf32f9f..3babb70f02 100644
--- a/manual/plugins.html
+++ b/manual/plugins.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/resource-logger.html b/manual/resource-logger.html
index 5329c4536e..5a836dc935 100644
--- a/manual/resource-logger.html
+++ b/manual/resource-logger.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/scoped-context.html b/manual/scoped-context.html
index 3b71c76bea..7ca467a870 100644
--- a/manual/scoped-context.html
+++ b/manual/scoped-context.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/scripts.html b/manual/scripts.html
index 0185060591..1fd09e609e 100644
--- a/manual/scripts.html
+++ b/manual/scripts.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/simple-logger.html b/manual/simple-logger.html
index dd97c0a273..182e453087 100644
--- a/manual/simple-logger.html
+++ b/manual/simple-logger.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/status-logger.html b/manual/status-logger.html
index 1499bc33f6..2a6f5b9a2e 100644
--- a/manual/status-logger.html
+++ b/manual/status-logger.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/systemproperties.html b/manual/systemproperties.html
index 4136d93d9c..20016805e4 100644
--- a/manual/systemproperties.html
+++ b/manual/systemproperties.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/thread-context.html b/manual/thread-context.html
index ddb104720d..0a98b5660e 100644
--- a/manual/thread-context.html
+++ b/manual/thread-context.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/manual/webapp.html b/manual/webapp.html
index 9e6e99e922..b6f84fdf49 100644
--- a/manual/webapp.html
+++ b/manual/webapp.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="../faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="../javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="../development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/log4j-spring-cloud-config-client.html b/migrate-from-logback.html
similarity index 62%
copy from log4j-spring-cloud-config-client.html
copy to migrate-from-logback.html
index f9b29c8d83..65d7f754cb 100644
--- a/log4j-spring-cloud-config-client.html
+++ b/migrate-from-logback.html
@@ -3,8 +3,8 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Log4j Spring Cloud Configuration :: Apache Log4j</title>
- <link rel="canonical" href="https://logging.apache.org/log4j/2.x/log4j-spring-cloud-config-client.html">
+ <title>Migrating from Logback :: Apache Log4j</title>
+ <link rel="canonical" href="https://logging.apache.org/log4j/2.x/migrate-from-logback.html">
<meta name="generator" content="Antora 3.2.0-alpha.4">
<link rel="stylesheet" href="./_/css/site.css">
<link rel="icon" href="./_/../_images/favicon.ico" type="image/x-icon">
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
@@ -251,7 +257,7 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="log4j-docker.html">Log4j Docker Support</a>
</li>
- <li class="nav-item is-current-page" data-depth="1">
+ <li class="nav-item" data-depth="1">
<a class="nav-link" href="log4j-spring-cloud-config-client.html">Log4j Spring Cloud Configuration</a>
</li>
</ul>
@@ -293,182 +299,214 @@
<nav class="breadcrumbs" aria-label="breadcrumbs">
<ul>
<li><a href="index.html">Home</a></li>
- <li>Components</li>
- <li><a href="log4j-spring-cloud-config-client.html">Log4j Spring Cloud Configuration</a></li>
+ <li>Resources</li>
+ <li><a href="migrate-from-logback.html">Migrating from Logback</a></li>
</ul>
</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/logging-log4j2/edit/2.x/src/site/antora/modules/ROOT/pages/log4j-spring-cloud-config-client.adoc">Edit this Page</a></div>
+<div class="edit-this-page"><a href="https://github.com/apache/logging-log4j2/edit/2.x/src/site/antora/modules/ROOT/pages/migrate-from-logback.adoc">Edit this Page</a></div>
</div>
<div class="content">
<aside class="toc sidebar" data-title="Contents" data-levels="4">
<div class="toc-menu"></div>
</aside>
<article class="doc">
-<h1 class="page">Log4j Spring Cloud Configuration</h1>
+<h1 class="page">Migrating from Logback</h1>
<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
-<p>This module allows logging configuration files to be dynamically updated when new versions are available in Spring Cloud Configuration.</p>
-</div>
-</div>
+<p><a href="https://logback.qos.ch/">Logback</a> is a logging implementation for the <a href="https://www.slf4j.org/">SLF4J</a> logging API, just like Log4j Core is a logging implementation for the <a href="manual/api.html" class="xref page">Log4j API</a>.
+In this page we will guide you through migrating from Logback to Log4j Core as your logging implementation.</p>
</div>
-<div class="sect1">
-<h2 id="_overview"><a class="anchor" href="#_overview"></a>Overview</h2>
-<div class="sectionbody">
+<div class="admonitionblock tip">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-tip" title="Tip"></i>
+</td>
+<td class="content">
<div class="paragraph">
-<p>Spring Boot applications initialize logging 3 times.</p>
-</div>
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>SpringApplication declares a Logger.
-This Logger will be initialized using Log4j’s "normal" mechanisms.
-Thus, the
-<a href="manual/systemproperties.html#log4j2.configurationFile" class="xref page"><code>log4j2.configurationFile</code></a>
-system property will be checked to see if a specific configuration file has been provided, otherwise it will search for a configuration file on the classpath.
-The property may also be declare in log4j2.component.properties.</p>
-</li>
-</ol>
-</div>
+<p>Instead of migrating your logging implementation, Logback, are you looking for migrating your logging API, SLF4J?
+Please refer to <a href="migrate-from-slf4j.html" class="xref page">Migrating from SLF4J</a>.</p>
</div>
+</td>
+</tr>
+</table>
</div>
-<div class="sect1">
-<h2 id="_usage"><a class="anchor" href="#_usage"></a>Usage</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Log4j configuration files that specify a monitor interval of greater than zero will use polling to determine whether the configuration has been updated.
-If the monitor interval is zero then Log4j will listen for notifications from Spring Cloud Config and will check for configuration changes each time an event is generated.
-If the monitor interval is less than zero Log4j will not check for changes to the logging configuration.</p>
+<details>
+<summary class="title">Struggling with the logging API, implementation, and bridge concepts? Click for an introduction.</summary>
+<div class="content">
+<div id="logging-api" class="dlist">
+<dl>
+<dt class="hdlist1">Logging API</dt>
+<dd>
+<p>A logging API is an interface your code or your dependencies directly logs against.
+It is required at compile-time.
+It is implementation agnostic to ensure that your application can write logs, but is not tied to a specific logging implementation.
+Log4j API, <a href="https://www.slf4j.org/">SLF4J</a>, <a href="https://docs.oracle.com/en/java/javase/8/core/java-logging-overview.html">JUL (Java Logging)</a>, <a href="https://commons.apache.org/proper/commons-logging/">JCL (Apache Commons Logging)</a>, <a href="https://openjdk.org/jeps/264">JPL (Java Platform Logging)</a> and <a href="https://github.com/jboss-logging/jboss-logging">JBoss Logging</a> are major logging APIs.</p>
+</dd>
+</dl>
+</div>
+<div id="logging-impl" class="dlist">
+<dl>
+<dt class="hdlist1">Logging implementation</dt>
+<dd>
+<p>A logging implementation is only required at runtime and can be changed without the need to recompile your software.
+Log4j Core, <a href="https://docs.oracle.com/en/java/javase/8/core/java-logging-overview.html">JUL (Java Logging)</a>, <a href="https://logback.qos.ch/">Logback</a> are the most well-known logging implementations.</p>
+</dd>
+</dl>
+</div>
+<div id="logging-bridge" class="dlist">
+<dl>
+<dt class="hdlist1">Logging bridge</dt>
+<dd>
+<p>Logging implementations accept input from a single logging API of their preference; Log4j Core from Log4j API, Logback from SLF4J, etc.
+A logging bridge is a simple logging implementation of a logging API that forwards all messages to a foreign logging API.
+Logging bridges allow a logging implementation to accept input from other logging APIs that are not their primary logging API.
+For instance, <code>log4j-slf4j2-impl</code> <em>bridges</em> SLF4J calls to Log4 API and effectively enables Log4j Core to accept input from SLF4J.</p>
+</dd>
+</dl>
</div>
<div class="paragraph">
-<p>When referencing a configuration located in Spring Cloud Config the configuration should be referenced similar to</p>
+<p>To make things a little bit more tangible, consider the following visualization of a typical Log4j Core installation with bridges for an application:</p>
</div>
-<div class="listingblock">
+<div class="imageblock kroki">
<div class="content">
-<pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties">log4j.configurationFile=http://host.docker.internal:8888/ConfigService/sampleapp/default/master/log4j2.xml</code></pre>
+<img src="_images/diag-1fd758c2554d79996565796f77cf0f8dc6b3bca2.svg" alt="Visualization of a typical Log4j Core installation with SLF4J, JUL, and JPL bridges.">
+</div>
+<div class="title">Figure 1. Visualization of a typical Log4j Core installation with SLF4J, JUL, and JPL bridges.</div>
+</div>
+</div>
+</details>
</div>
</div>
+<div class="sect1">
+<h2 id="migrating"><a class="anchor" href="#migrating"></a>Migrating</h2>
+<div class="sectionbody">
<div class="paragraph">
-<p>Log4j also supports Composite Configurations.
-The standard way to do that is to concatentate the paths to the files in a comma separated string.
-Unfortunately, Spring validates the URL being provided and commas are not allowed.
-Therefore, additional configurations must be supplied as "override" query parametes.</p>
+<p>You either have an application using Logback at runtime, or have a library using Logback for tests.
+In either case, you can replace Logback with Log4j Core as follows:</p>
</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties">log4j.configurationFile=http://host.docker.internal:8888/ConfigService/sampleapp/default/master/log4j2.xml?override=http://host.docker.internal:8888/ConfigService/sampleapp/default/master/log4j2-sampleapp.xml</code></pre>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>Remove <code>ch.qos.logback:logback-classic</code> dependency</p>
+</li>
+<li>
+<p>Remove <code>logback.xml</code> and <code>logback-test.xml</code> files</p>
+</li>
+<li>
+<p>Follow the instructions shared in the <em>"Getting started"</em> page</p>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="manual/getting-started.html#install-app" class="xref page">for applications</a></p>
+</li>
+<li>
+<p><a href="manual/getting-started.html#install-lib" class="xref page">for libraries</a></p>
+</li>
+</ul>
</div>
+</li>
+</ol>
</div>
<div class="paragraph">
-<p>Note that the location within the directory structure and how configuration files are located is completely dependent on the searchPaths setting in the Spring Cloud Config server.</p>
+<p>Next you need to re-organize your logging API bridges such that all foreign APIs are bridged to Log4j API, the logging API implemented by Log4j Core.
+This is explained in the next section.</p>
</div>
+<div class="sect2">
+<h3 id="bridges"><a class="anchor" href="#bridges"></a>Bridges</h3>
<div class="paragraph">
-<p>When running in a docker container host.docker.internal may be used as the domain name to access an application running on the same hose outside of the docker container.
-Note that in accordance with Spring Cloud Config practices but the application, profile, and label should be specified in the url.</p>
+<p>It is highly likely that you were bridging all logging APIs (including Log4j API!) to SLF4J, the logging API implemented by Logback.
+There are two particular approaches you can take here to ensure all logging APIs are instead bridged to Log4j API, the logging API implemented by Log4j Core:</p>
</div>
+<div class="sect3">
+<h4 id="bridge-to-log4j"><a class="anchor" href="#bridge-to-log4j"></a>Bridge all logging APIs to Log4j API</h4>
<div class="paragraph">
-<p>The Spring Cloud Config support also allows connections using TLS and/or basic authentication.
-When using basic authentication the userid and password may be specified as system properties, log4j2.component.properties or Spring Boot’s bootstrap.yml.
-The table below shows the alternate names that may be used to specify the properties.
-Any of the alternatives may be used in any configuration location.</p>
+<p>We strongly advise you to bridge all foreign logging APIs <strong>directly</strong> to Log4j API.
+You can use the cheat sheet shared below to implement that.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
+<caption class="title">Table 1. Dependency migration cheat sheet</caption>
<colgroup>
-<col style="width: 25%;">
-<col style="width: 25%;">
-<col style="width: 25%;">
-<col style="width: 25%;">
+<col style="width: 50%;">
+<col style="width: 50%;">
</colgroup>
<thead>
<tr>
-<th class="tableblock halign-left valign-top">Property</th>
-<th class="tableblock halign-left valign-top">Alias</th>
-<th class="tableblock halign-left valign-top">Spring-like alias</th>
-<th class="tableblock halign-left valign-top">Purpose</th>
+<th class="tableblock halign-left valign-top">If dependency present</th>
+<th class="tableblock halign-left valign-top">replace with</th>
</tr>
</thead>
<tbody>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">log4j2.configurationUserName</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">log4j2.config.username</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">logging.auth.username</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">User name for basic authentication</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.apache.logging.log4j:log4j-to-slf4j</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.apache.logging.log4j:log4j-slf4j2-impl</code></p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">log4j2.configurationPassword</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">log4j2.config.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">logging.auth.password</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Password for basic authentication</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.slf4j:jcl-over-slf4j</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>commons-logging:commons-logging</code> version <code>>=1.3.0</code></p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">log4j2.configurationAuthorizationEncoding</p></td>
-<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">logging.auth.encoding</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Encoding for basic authentication (defaults to UTF-8)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.slf4j:jul-to-slf4j</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.apache.logging.log4j:log4j-jul</code></p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">log4j2.configurationAuthorizationProvider</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">log4j2.config.authorizationProvider</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">logging.auth.authorizationProvider</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Class used to create HTTP Authorization header</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.slf4j:log4j-over-slf4j</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.apache.logging.log4j:log4j-1.2-api</code></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.springframework:spring-boot-starter-logging</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>org.springframework:spring-boot-starter-log4j2</code></p></td>
</tr>
</tbody>
</table>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties">log4j2.configurationUserName=guest
-log4j2.configurationPassword=guest</code></pre>
-</div>
</div>
+<div class="sect3">
+<h4 id="bridge-to-sfl4j"><a class="anchor" href="#bridge-to-sfl4j"></a>Bridge all logging APIs to SLF4J, and bridge SLF4J to Log4j API</h4>
<div class="paragraph">
-<p>As noted above, Log4j supports accessing logging configuration from bootstrap.yml.
-As an example, to configure reading from a Spring Cloud Configuration service using basic authoriztion you can do:</p>
+<p>You can implement this by replacing <code>org.apache.logging.log4j:log4j-to-slf4j</code> dependency with <code>org.apache.logging.log4j:log4j-slf4j2-impl</code>.</p>
</div>
-<div class="listingblock">
-<div class="content">
-<pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">spring:
- application:
- name: myApp
- cloud:
- config:
- uri: https://spring-configuration-server.mycorp.com
- username: appuser
- password: changeme
-
-logging:
- config: classpath:log4j2.xml
- label: ${spring.cloud.config.label}
-
----
-spring:
- profiles: dev
-
-logging:
- config: https://spring-configuration-server.mycorp.com/myApp/default/${logging.label}/log4j2-dev.xml
- auth:
- username: appuser
- password: changeme</code></pre>
+<div class="admonitionblock warning">
+<table>
+<tr>
+<td class="icon">
+<i class="fa icon-warning" title="Warning"></i>
+</td>
+<td class="content">
+<div class="paragraph">
+<p><strong>This approach is not recommended!</strong>
+It incurs certain drawbacks since some logging API calls will need to cross multiple bridges.
+For instance, a call to JUL will first be bridged to SLF4J, and then from there to Log4j API.</p>
</div>
+</td>
+</tr>
+</table>
</div>
-<div class="paragraph">
-<p>Note that Log4j currently does not directly support encrypting the password.
-However, Log4j does use Spring’s standard APIs to access properties in the Spring configuration so any customizations made to Spring’s property handling would apply to the properties Log4j uses as well.</p>
</div>
-<div class="paragraph">
-<p>If more extensive authentication is required an <code>AuthorizationProvider</code> can be implemented and its fully qualified class name should be specified in the
-<a href="manual/systemproperties.html#log4j2.configurationAuthorizationProvider" class="xref page">log4j2.configurationAuthorizationProvider</a>
-system property, in log4j2.component.properties or in Spring’s <code>bootstrap.yml</code> using either the <code>log4j2.authorizationProvider</code> or <code>logging.auth.authorizationProvider</code> key.</p>
</div>
+<div class="sect2">
+<h3 id="config"><a class="anchor" href="#config"></a>Configuration</h3>
<div class="paragraph">
-<p>For the properties required by TLS configuration see <a href="manual/systemproperties.html#properties-transport-security" class="xref page">the Transport Security configuration</a>.</p>
-</div>
+<p>It might not always be trivial to match the contents of the newly created <code>log4j2.xml</code> and <code>log4j2-test.xml</code> files with your old <code>logback.xml</code> and <code>logback-test.xml</code> files.
+While all Logback components have corresponding equivalents in Log4j Core, they might not be sharing the same name or configuration.
+To assist with migrating Logback configuration components to Log4j Core, see the following pages:</p>
</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="manual/appenders.html" class="xref page">Appenders</a></p>
+</li>
+<li>
+<p><a href="manual/layouts.html" class="xref page">Layouts</a></p>
+</li>
+<li>
+<p><a href="manual/filters.html" class="xref page">Filters</a></p>
+</li>
+</ul>
</div>
-<div class="sect1">
-<h2 id="_requirements"><a class="anchor" href="#_requirements"></a>Requirements</h2>
-<div class="sectionbody">
<div class="paragraph">
-<p>The Log4j 2 Spring Cloud Configuration integration has a dependency on Log4j 2 API, Log4j 2 Core, and Spring Cloud Configuration versions 2.0.3.RELEASE or 2.1.1.RELEASE or later versions it either release series.</p>
+<p>For the complete list of all Log4j configuration knobs, see <a href="manual/configuration.html" class="xref page">the Configuration page</a>.</p>
+</div>
</div>
</div>
</div>
diff --git a/development.html b/migrate-from-slf4j.html
similarity index 64%
copy from development.html
copy to migrate-from-slf4j.html
index 7d4b9fe3fd..0ff4ebc78b 100644
--- a/development.html
+++ b/migrate-from-slf4j.html
@@ -3,8 +3,8 @@
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
- <title>Development :: Apache Log4j</title>
- <link rel="canonical" href="https://logging.apache.org/log4j/2.x/development.html">
+ <title>Migrating from SLF4J :: Apache Log4j</title>
+ <link rel="canonical" href="https://logging.apache.org/log4j/2.x/migrate-from-slf4j.html">
<meta name="generator" content="Antora 3.2.0-alpha.4">
<link rel="stylesheet" href="./_/css/site.css">
<link rel="icon" href="./_/../_images/favicon.ico" type="image/x-icon">
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
- </li>
- <li class="nav-item is-current-page" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item is-current-page" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
@@ -294,22 +300,22 @@
<ul>
<li><a href="index.html">Home</a></li>
<li>Resources</li>
- <li><a href="development.html">Development</a></li>
+ <li><a href="migrate-from-slf4j.html">Migrating from SLF4J</a></li>
</ul>
</nav>
-<div class="edit-this-page"><a href="https://github.com/apache/logging-log4j2/edit/2.x/src/site/antora/modules/ROOT/pages/development.adoc">Edit this Page</a></div>
+<div class="edit-this-page"><a href="https://github.com/apache/logging-log4j2/edit/2.x/src/site/antora/modules/ROOT/pages/migrate-from-slf4j.adoc">Edit this Page</a></div>
</div>
<div class="content">
<aside class="toc sidebar" data-title="Contents" data-levels="4">
<div class="toc-menu"></div>
</aside>
<article class="doc">
-<h1 class="page">Development</h1>
+<h1 class="page">Migrating from SLF4J</h1>
<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
-<p>This page shares information related to the development of Log4j.
-Content is aimed for users who want to contribute source code patches and maintainers.</p>
+<p><a href="https://www.slf4j.org/">SLF4J</a> is a logging API whose reference implementation is <a href="https://logback.qos.ch/">Logback</a>, just like <a href="manual/api.html" class="xref page">Log4j API</a> is a logging API whose reference implementation is Log4j Core.
+In this page we will guide you through migrating from SLF4J to Log4j API as your logging API.</p>
</div>
<div class="admonitionblock tip">
<table>
@@ -319,173 +325,146 @@ Content is aimed for users who want to contribute source code patches and mainta
</td>
<td class="content">
<div class="paragraph">
-<p>Do you need help for setting up or configuring Log4j?
-Please refer to <a href="https://logging.apache.org/support.html">the Support page</a> instead.</p>
+<p>Instead of migrating your logging API, SLF4J, are you looking for migrating your logging implementation, Logback?
+Please refer to <a href="migrate-from-logback.html" class="xref page">Migrating from Logback</a>.</p>
</div>
</td>
</tr>
</table>
</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="github"><a class="anchor" href="#github"></a>GitHub setup</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>Log4j uses GitHub extensively:</p>
-</div>
-<div class="dlist">
+<details>
+<summary class="title">Struggling with the logging API, implementation, and bridge concepts? Click for an introduction.</summary>
+<div class="content">
+<div id="logging-api" class="dlist">
<dl>
-<dt class="hdlist1">Source code repository</dt>
+<dt class="hdlist1">Logging API</dt>
<dd>
-<p><a href="https://github.com/apache/logging-log4j2" class="bare">https://github.com/apache/logging-log4j2</a></p>
-</dd>
-<dt class="hdlist1">Issue tracker</dt>
-<dd>
-<p><a href="https://github.com/apache/logging-log4j2/issues" class="bare">https://github.com/apache/logging-log4j2/issues</a></p>
-</dd>
-<dt class="hdlist1">Discussions</dt>
-<dd>
-<p><a href="https://github.com/apache/logging-log4j2/discussions" class="bare">https://github.com/apache/logging-log4j2/discussions</a></p>
-<div class="admonitionblock tip">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
-</td>
-<td class="content">
-<div class="paragraph">
-<p>Maintainer discussions mostly take place in mailing lists.
-Please refer to <a href="https://logging.apache.org/support.html">the Support page</a> for the complete list of communication channels.</p>
-</div>
-</td>
-</tr>
-</table>
-</div>
+<p>A logging API is an interface your code or your dependencies directly logs against.
+It is required at compile-time.
+It is implementation agnostic to ensure that your application can write logs, but is not tied to a specific logging implementation.
+Log4j API, <a href="https://www.slf4j.org/">SLF4J</a>, <a href="https://docs.oracle.com/en/java/javase/8/core/java-logging-overview.html">JUL (Java Logging)</a>, <a href="https://commons.apache.org/proper/commons-logging/">JCL (Apache Commons Logging)</a>, <a href="https://openjdk.org/jeps/264">JPL (Java Platform Logging)</a> and <a href="https://github.com/jboss-logging/jboss-logging">JBoss Logging</a> are major logging APIs.</p>
</dd>
</dl>
</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="branching"><a class="anchor" href="#branching"></a>Branching scheme</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>The following branching scheme is followed:</p>
-</div>
-<div class="dlist">
+<div id="logging-impl" class="dlist">
<dl>
-<dt class="hdlist1"><code>2.x</code></dt>
-<dd>
-<p>The most recent Log4j 2 code</p>
-</dd>
-<dt class="hdlist1"><code>main</code></dt>
-<dd>
-<p>The most recent Log4j 3 code</p>
-</dd>
-<dt class="hdlist1"><code><sourceBranch>-site-<environment></code></dt>
-<dt class="hdlist1"><code><sourceBranch>-site-<environment>-out</code></dt>
+<dt class="hdlist1">Logging implementation</dt>
<dd>
-<p>Branches used to serve the staging and production websites.
-<code>out</code>-suffixed ones are automatically populated by CI, you are not supposed to touch them.
-See <a href="https://logging.apache.org/logging-parent/usage.html#website">the Logging Parent website</a> for details.</p>
+<p>A logging implementation is only required at runtime and can be changed without the need to recompile your software.
+Log4j Core, <a href="https://docs.oracle.com/en/java/javase/8/core/java-logging-overview.html">JUL (Java Logging)</a>, <a href="https://logback.qos.ch/">Logback</a> are the most well-known logging implementations.</p>
</dd>
-<dt class="hdlist1"><code>release/<version></code></dt>
+</dl>
+</div>
+<div id="logging-bridge" class="dlist">
+<dl>
+<dt class="hdlist1">Logging bridge</dt>
<dd>
-<p>Branch triggering the CI logic to start <a href="https://logging.apache.org/logging-parent/release-instructions-project.html">the release process</a></p>
+<p>Logging implementations accept input from a single logging API of their preference; Log4j Core from Log4j API, Logback from SLF4J, etc.
+A logging bridge is a simple logging implementation of a logging API that forwards all messages to a foreign logging API.
+Logging bridges allow a logging implementation to accept input from other logging APIs that are not their primary logging API.
+For instance, <code>log4j-slf4j2-impl</code> <em>bridges</em> SLF4J calls to Log4 API and effectively enables Log4j Core to accept input from SLF4J.</p>
</dd>
</dl>
</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="building"><a class="anchor" href="#building"></a>How can I build Log4j from sources?</h2>
-<div class="sectionbody">
<div class="paragraph">
-<p>See <a href="https://github.com/apache/logging-log4j2/tree/2.x/BUILDING.adoc">the build instructions</a>.</p>
+<p>To make things a little bit more tangible, consider the following visualization of a typical Log4j Core installation with bridges for an application:</p>
</div>
+<div class="imageblock kroki">
+<div class="content">
+<img src="_images/diag-1fd758c2554d79996565796f77cf0f8dc6b3bca2.svg" alt="Visualization of a typical Log4j Core installation with SLF4J, JUL, and JPL bridges.">
</div>
+<div class="title">Figure 1. Visualization of a typical Log4j Core installation with SLF4J, JUL, and JPL bridges.</div>
</div>
-<div class="sect1">
-<h2 id="contributor"><a class="anchor" href="#contributor"></a>I am <strong>not</strong> a committer. How shall I submit a patch?</h2>
-<div class="sectionbody">
-<div class="olist arabic">
-<ol class="arabic">
-<li>
-<p>Is this a <em>trivial fix</em> such as code or documentation typo?
-Simply submit a pull request.
-Changelog entry is not needed and make sure <code>./mvnw verify site</code> succeeds.</p>
-</li>
-<li>
-<p>Is this a <em>non-trivial fix</em> or a <em>new feature</em>?
-Pitch it in a <a href="https://logging.apache.org/support.html#discussions-maintainer">maintainer discussion channel</a> and ask for assistance.</p>
-</li>
-</ol>
</div>
+</details>
</div>
</div>
<div class="sect1">
-<h2 id="committer"><a class="anchor" href="#committer"></a>I am a committer. How shall I push my changes?</h2>
+<h2 id="migrating"><a class="anchor" href="#migrating"></a>Migrating</h2>
<div class="sectionbody">
+<div class="paragraph">
+<p>If your application or library logs using SLF4J, you can migrate it to Log4j API as follows:</p>
+</div>
<div class="olist arabic">
<ol class="arabic">
<li>
-<p>Is it something trivial?
-Go ahead and push it.</p>
+<p>Remove <code>org.slf4j:slf4j-api</code> dependency</p>
</li>
<li>
-<p>Otherwise, submit a pull request.
-Make sure a changelog entry is attached and <code>./mvnw verify site</code> succeeds.</p>
-<div class="admonitionblock tip">
+<p>Follow the instructions shared in the <em>"Getting started"</em> page for <a href="manual/getting-started.html#using-api" class="xref page">installing <code>log4j-api</code> and using it</a></p>
+</li>
+<li>
+<p>Search for <code>org.slf4j</code> usages in your project and replace them with Log4j API equivalents</p>
+<div class="admonitionblock important">
<table>
<tr>
<td class="icon">
-<i class="fa icon-tip" title="Tip"></i>
+<i class="fa icon-important" title="Important"></i>
</td>
<td class="content">
<div class="paragraph">
-<p>You are strongly advised to spar with another maintainer first (see <a href="https://logging.apache.org/support.html#discussions-maintainer">maintainer discussion channels</a>) before starting to code.</p>
+<p>For an exhaustive list of code changes that need to be carried out, refer to <a href="https://docs.openrewrite.org/recipes/java/logging/log4j/slf4jtolog4j">the SLF4J to Log4j API migration OpenRewrite recipe</a>.
+This you can use to</p>
+</div>
+<div class="olist arabic">
+<ol class="arabic">
+<li>
+<p>either manually follow the described migrations,</p>
+</li>
+<li>
+<p>or run OpenRewrite to automatically migrate the code.</p>
+</li>
+</ol>
</div>
</td>
</tr>
</table>
</div>
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><a href="https://www.slf4j.org/api/org/slf4j/LoggerFactory.html"><code>org.slf4j.LoggerFactory</code></a></dt>
+<dd>
+<p>Replace its usages with <a href="javadoc/log4j-api/org/apache/logging/log4j/LogManager.html"><code>org.apache.logging.log4j.LogManager</code></a>.
+Note that <code>LogManager.getLogger(Foo.class)</code> can be simplified as <code>LogManager.getLogger()</code>, if <code>Foo</code> is the enclosing class of the field.</p>
+</dd>
+<dt class="hdlist1"><a href="https://www.slf4j.org/api/org/slf4j/Logger.html"><code>org.slf4j.Logger</code></a></dt>
+<dd>
+<p>Replace its usages with <a href="javadoc/log4j-api/org/apache/logging/log4j/Logger.html"><code>org.apache.logging.log4j.Logger</code></a>.
+Since SLF4J’s <code>Logger</code> is almost a parent of Log4j’s <code>Logger</code>, most methods should work without any changes.</p>
+</dd>
+<dt class="hdlist1"><a href="https://www.slf4j.org/api/org/slf4j/MDC.html"><code>org.slf4j.MDC</code></a></dt>
+<dd>
+<p>Replace its usages with <a href="javadoc/log4j-api/org/apache/logging/log4j/ThreadContext.html"><code>org.apache.logging.log4j.ThreadContext</code></a>.</p>
+</dd>
+</dl>
+</div>
+</li>
+<li>
+<p>If you use <a href="https://projectlombok.org/features/log"><code>@Slf4j</code> from Lombok</a>, you need to replace them with <code>@Log4j2</code> instead.</p>
</li>
</ol>
</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="release-project"><a class="anchor" href="#release-project"></a>I am a PMC member. How do I make a new release?</h2>
-<div class="sectionbody">
-<div class="paragraph">
-<p>All Maven-based Logging Services projects are parented by <a href="https://logging.apache.org/logging-parent">Logging Parent</a>, which streamlines several project-wide processes, including making a new release.
-See <a href="https://logging.apache.org/logging-parent/release-instructions-project.html">its release instructions for projects</a>.</p>
-</div>
-</div>
-</div>
-<div class="sect1">
-<h2 id="release-xml-schema"><a class="anchor" href="#release-xml-schema"></a>I am a PMC member. How do I publish a new XML schema?</h2>
-<div class="sectionbody">
<div class="paragraph">
-<p>All Maven-based Logging Services projects are parented by <a href="https://logging.apache.org/logging-parent">Logging Parent</a>, which streamlines several project-wide processes, including publishing XML schemas.
-See <a href="https://logging.apache.org/logging-parent/release-instructions-xml-schema.html">its release instructions for XML schemas</a>.</p>
+<p>At this stage, you should have your application or library logging using Log4j API.</p>
</div>
-<div class="admonitionblock warning">
-<table>
-<tr>
-<td class="icon">
-<i class="fa icon-warning" title="Warning"></i>
-</td>
-<td class="content">
+<div class="dlist">
+<dl>
+<dt class="hdlist1">If it is a library that you migrated,</dt>
+<dd>
+<p>then you don’t need to take any extra steps.
+Unlike applications, libraries should be logging implementation agnostic.
+That is, libraries should log through a logging API, but leave the decision of the logging implementation to the application.</p>
+</dd>
+<dt class="hdlist1">If it is an application that you migrated, and you are not using Log4j Core as your logging implementation,</dt>
+<dd>
+<p>then you can consider doing so.
+Certain <a href="manual/api.html" class="xref page">Log4j API features</a> (e.g., <a href="manual/garbagefree.html" class="xref page">garbage-free logging</a>) require an end-to-end setup which is mostly possible using Log4j API in combination with Log4j Core.</p>
<div class="paragraph">
-<p><strong>Projects and XML schemas have different lifecycles!</strong>
-A new release of a project does not necessarily mean a new release of its XML schemas.
-XML schemas might have been untouched, or they might contain minor changes while the project itself contains breaking changes, etc.</p>
+<p>See <a href="manual/installation.html" class="xref page">Installation</a> for installing Log4j Core.<br>
+If you are using Logback, refer to <a href="migrate-from-logback.html" class="xref page">Migrating from Logback</a>.</p>
</div>
-</td>
-</tr>
-</table>
+</dd>
+</dl>
</div>
</div>
</div>
diff --git a/plugin-reference.html b/plugin-reference.html
index cc78d0ed01..452ae602f5 100644
--- a/plugin-reference.html
+++ b/plugin-reference.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
diff --git a/release-notes.html b/release-notes.html
index 048938d463..4b6bb0d4e4 100644
--- a/release-notes.html
+++ b/release-notes.html
@@ -84,29 +84,11 @@
</li>
<li class="nav-item" data-depth="0">
<button class="nav-item-toggle"></button>
- <span class="nav-text">Resources</span>
+ <a class="nav-link" href="manual/index.html">Manual</a>
<ul class="nav-list">
<li class="nav-item" data-depth="1">
- <a class="nav-link" href="faq.html">F.A.Q.</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="getting-started.html">Getting started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ <a class="nav-link" href="manual/getting-started.html">Getting started</a>
</li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="development.html">Development</a>
- </li>
-</ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="manual/index.html">Manual</a>
-<ul class="nav-list">
<li class="nav-item" data-depth="1">
<a class="nav-link" href="manual/installation.html">Installation</a>
</li>
@@ -236,6 +218,30 @@
<li class="nav-item" data-depth="1">
<a class="nav-link" href="javadoc.html">Java API reference</a>
</li>
+</ul>
+ </li>
+ <li class="nav-item" data-depth="0">
+ <button class="nav-item-toggle"></button>
+ <span class="nav-text">Resources</span>
+<ul class="nav-list">
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="faq.html">F.A.Q.</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/migration.html">Migrating from Log4j 1</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-logback.html">Migrating from Logback</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="migrate-from-slf4j.html">Migrating from SLF4J</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="manual/cloud.html">Using Log4j in Cloud Enabled Applications</a>
+ </li>
+ <li class="nav-item" data-depth="1">
+ <a class="nav-link" href="development.html">Development</a>
+ </li>
</ul>
</li>
<li class="nav-item" data-depth="0">
@@ -475,7 +481,7 @@
<p>Update <code>org.eclipse.persistence:org.eclipse.persistence.jpa</code> to version `` (<a href="https://github.com/apache/logging-log4j2/pull/2602">2602</a>)</p>
</li>
<li>
-<p>Update <code>org.hdrhistogram:HdrHistogram</code> to version <code>2.2.1</code> (<a href="https://github.com/apache/logging-log4j2/pull/2569">2569</a>)</p>
+<p>Update <code>org.hdrhistogram:HdrHistogram</code> to version <code>2.2.2</code> (<a href="https://github.com/apache/logging-log4j2/pull/2627">2627</a>)</p>
</li>
<li>
<p>Update log4j-mongodb3 <code>org.mongodb:*</code> to version <code>3.12.14</code> (<a href="https://github.com/apache/logging-log4j2/pull/2409">2409</a>)</p>
diff --git a/sitemap.xml b/sitemap.xml
index 7a5e5834d3..a96a7ff5fa 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2,226 +2,234 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://logging.apache.org/log4j/2.x/development.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/download.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/faq.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
-</url>
-<url>
-<loc>https://logging.apache.org/log4j/2.x/getting-started.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/index.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/javadoc.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-1.2-api.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-appserver.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-cassandra.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-couchdb.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-docker.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-flume-ng.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-iostreams.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-jakarta-web.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-spring-boot.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-spring-cloud-config-client.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-spring-cloud-config.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-taglib.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/log4j-web.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/api.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/appenders.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/architecture.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/async.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/cloud.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/compatibility.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/configuration.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/customconfig.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/customloglevels.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/eventlogging.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/extending.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/filters.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/flowtracing.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/garbagefree.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
+</url>
+<url>
+<loc>https://logging.apache.org/log4j/2.x/manual/getting-started.html</loc>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/index.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/installation.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/jmx.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/json-template-layout.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/layouts.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/logbuilder.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/logsep.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/lookups.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/markers.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/messages.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/migration.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/performance.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/plugins.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/resource-logger.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/scoped-context.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/scripts.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/simple-logger.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/status-logger.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/systemproperties.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/thread-context.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/manual/webapp.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
+</url>
+<url>
+<loc>https://logging.apache.org/log4j/2.x/migrate-from-logback.html</loc>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
+</url>
+<url>
+<loc>https://logging.apache.org/log4j/2.x/migrate-from-slf4j.html</loc>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/plugin-reference.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
<url>
<loc>https://logging.apache.org/log4j/2.x/release-notes.html</loc>
-<lastmod>2024-05-30T10:42:08.577Z</lastmod>
+<lastmod>2024-05-30T11:02:03.700Z</lastmod>
</url>
</urlset>