Skip to content

Commit d12724d

Browse files
ppkarwaszvy
andcommitted
Add references to Copernik.eu Log4j components (#3534)
This change adds references to the Log4j plugins from my personal "Extensions for Log4j and Tomcat" to the documentation. Co-authored-by: Volkan Yazıcı <[email protected]>
1 parent e3f7eb6 commit d12724d

File tree

2 files changed

+39
-1
lines changed

2 files changed

+39
-1
lines changed

src/site/antora/modules/ROOT/pages/manual/lookups.adoc

+24-1
Original file line numberDiff line numberDiff line change
@@ -945,7 +945,12 @@ include::partial$features/servlet-support.adoc[]
945945
[#third-party]
946946
== Third-party lookups
947947
948-
The following additional lookups are available from third-party vendors:
948+
[IMPORTANT]
949+
====
950+
These lookups are provided by **third-party** vendors and are not maintained by the
951+
link:{logging-services-url}[Apache Logging Services]
952+
(Log4j, Log4cxx, Log4net) project.
953+
====
949954
950955
[#KubernetesLookup]
951956
=== Kubernetes Lookup
@@ -972,6 +977,24 @@ Starting with Spring Boot 3 a `$+{spring:...}+` lookup is available out-of-the-b
972977
https://docs.spring.io/spring-boot/reference/features/logging.html#features.logging.log4j2-extensions.environment-properties-lookup[Spring Boot documentation]
973978
for more details.
974979
980+
[#TomcatLookup]
981+
=== Tomcat Lookup
982+
983+
[cols="1h,4"]
984+
|===
985+
| Syntax
986+
|
987+
`tomcat:<key>`
988+
989+
where `key` is one of the
990+
https://oss.copernik.eu/tomcat/3.x/components/log4j-tomcat#TomcatLookup-keys[supported Tomcat Lookup keys]
991+
| Dependency | https://oss.copernik.eu/tomcat/3.x/components/log4j-tomcat#installation[`eu.copernik:log4j-tomcat`]
992+
|===
993+
994+
The Tomcat Lookup allows retrieving the names of the currently active Tomcat engine, host and application context.
995+
See
996+
https://oss.copernik.eu/tomcat/3.x/components/log4j-tomcat#TomcatLookup[Copernik.eu Tomcat Lookup documentation] for more details.
997+
975998
[#extending]
976999
== Extending
9771000

src/site/antora/modules/ROOT/partials/manual/systemproperties/properties-logger-context.adoc

+15
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,21 @@ See
6464
{logging-services-url}/log4j/jakarta/log4j-jakarta-web.html#jndi[Web application]
6565
for details.
6666
67+
There are also third-party context selector implementations:
68+
69+
[IMPORTANT]
70+
====
71+
These context selectors are provided by **third-party** vendors and are not maintained by the
72+
link:{logging-services-url}[Apache Logging Services]
73+
(Log4j, Log4cxx, Log4net) project.
74+
====
75+
76+
https://oss.copernik.eu/tomcat/3.x/components/log4j-tomcat#TomcatContextSelector[`eu.copernik.log4j.tomcat.TomcatContextSelector`]::
77+
Selects the currently active Tomcat web application and creates synchronous loggers.
78+
79+
https://oss.copernik.eu/tomcat/3.x/components/log4j-tomcat#TomcatContextSelector[`eu.copernik.log4j.tomcat.TomcatAsyncContextSelector`]::
80+
Selects the currently active Tomcat web application and creates xref:manual/async.adoc[asynchronous loggers].
81+
6782
[id=log4j.loggerContext.shutdownHookEnabled]
6883
== `log4j.loggerContext.shutdownHookEnabled`
6984

0 commit comments

Comments
 (0)