From 0fa68b616c9c4a05068d1a565baef60fe0ede5f3 Mon Sep 17 00:00:00 2001 From: Matthias Langer Date: Sat, 7 Mar 2026 08:31:32 +0100 Subject: [PATCH] Add documentation for third-party appenders and async HTTP appender specifically --- .../modules/ROOT/pages/manual/appenders.adoc | 14 ++++++++++++++ .../ROOT/pages/manual/appenders/network.adoc | 7 +++++++ 2 files changed, 21 insertions(+) diff --git a/src/site/antora/modules/ROOT/pages/manual/appenders.adoc b/src/site/antora/modules/ROOT/pages/manual/appenders.adoc index a43675fb547..3dd5526c62a 100644 --- a/src/site/antora/modules/ROOT/pages/manual/appenders.adoc +++ b/src/site/antora/modules/ROOT/pages/manual/appenders.adoc @@ -605,6 +605,20 @@ Dynamically choose a different appender for each log event See xref:manual/appenders/delegating.adoc[] for details. +[#third-party] +== Third-party appenders + +[WARNING] +==== +These appenders are provided by **third-party** vendors and are not maintained by the link:{logging-services-url}[Apache Logging Services] project. +==== + +[#more-log4j2-AsyncHttpAppender] +=== Async HTTP appender (`more-log4j2`) + +`AsyncHttpAppender` by https://github.com/mlangc/more-log4j2[more-log4j2] batches and optionally compresses log events, +before sending them to backends. This way it is able to deliver high log volumes with little overhead. + [#extending] == Extending diff --git a/src/site/antora/modules/ROOT/pages/manual/appenders/network.adoc b/src/site/antora/modules/ROOT/pages/manual/appenders/network.adoc index 425f87704e4..dbc3a37b5f1 100644 --- a/src/site/antora/modules/ROOT/pages/manual/appenders/network.adoc +++ b/src/site/antora/modules/ROOT/pages/manual/appenders/network.adoc @@ -283,6 +283,13 @@ Additional headers can be configured using the nested If the appender receives a response with status code different from `2xx`, an exception is thrown. See also <> configuration attribute. +[WARNING] +==== +Sending logs synchronously, one by one to an HTTP backend is rarely a good idea. Even if the expected log +volumes are extremely low, you should at least consider using xref:manual/async.adoc[asynchronous loggers] if +you use this appender. Otherwise, please have a look at xref:manual/appenders.adoc#third-party[third-party appenders]. +==== + [NOTE] ==== The implementation uses