You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: src/site/antora/modules/ROOT/pages/manual/_properties.adoc
+28-8
Original file line number
Diff line number
Diff line change
@@ -14,8 +14,8 @@
14
14
See the License for the specific language governing permissions and
15
15
limitations under the License.
16
16
////
17
-
[#SystemProperties]
18
-
= Global configuration properties
17
+
[id=system-properties]
18
+
= Configuration properties
19
19
20
20
Log4j contains a simple configuration properties sub-system that aggregates data from multiple property sources, such as Java https://docs.oracle.com/javase/tutorial/essential/environment/sysprop.html[System Properties] and https://docs.oracle.com/javase/tutorial/essential/environment/env.html[Environment Variables].
21
21
See <<property-sources>> for a complete list of supported sources
@@ -58,16 +58,19 @@ In case of problems with the properties sub-system, make sure that your applicat
58
58
and that all the properties names that start with `log4j` use the normalized form provided by the tables below.
59
59
====
60
60
61
+
[id=properties-meta]
61
62
== Meta configuration properties
62
63
63
64
In order to rapidly optimize Log4j Core for a particular usage, you can use the following properties:
While the only required configuration of the `log4j-core` library is provided by the xref:manual/configuration.adoc[configuration file], the library offers many configuration properties that can be used to finely tune the way it works.
123
130
131
+
[id=properties-async]
124
132
=== Async components
125
133
126
134
The behavior of all three async components (`AsyncLogger`, `AsyncLoggerConfig` and `AsyncAppender`) can be tuned using these properties:
The link:../javadoc/log4j-core/org/apache/logging/log4j/core/selector/ContextSelector[ContextSelector] component specifies the strategy used by Log4j to create new logger contexts.
@@ -152,6 +163,7 @@ See xref:manual/async.adoc[Async Logging] as an example of this usage.
If the https://fusesource.github.io/jansi/[JANSI] library is on the runtime classpath of the application, the following property can be used to control its usage:
Due to the inherent security problems of https://docs.oracle.com/javase/tutorial/jndi/overview/[JNDI], its usage in Log4j is restricted to the `java:` protocol.
@@ -187,13 +203,13 @@ Moreover, each JNDI usage must be **explicitly** enabled by the user through the
Log4j Core supports the same properties as Simple Logger for the configuration of the thread context.
194
-
See <<simple-logger-thread-context>> for more details.
210
+
See <<properties-simple-logger-thread-context>> for more details.
195
211
196
-
[#transport-security]
212
+
[id=properties-transport-security]
197
213
=== Transport security
198
214
199
215
Since configuration files can be used to load arbitrary classes into a Log4j Core `Configuration`, users need to ensure that all the configuration elements come from trusted sources (cf. link:/security#threat-common-config-sources[Thread model] for more information).
@@ -202,25 +218,29 @@ In order to protect the user Log4j disables the `http` URI scheme by default and
The Log4j configuration properties sub-system merges the content of multiple property sources that implement the Java interface link:../javadoc/log4j-api/org/apache/logging/log4j/util/PropertySource[PropertySource].
0 commit comments