Skip to content

Commit 2e27ecf

Browse files
committed
Expand UuidPatternConverter section of pattern-layout.adoc
1 parent 72dd782 commit 2e27ecf

File tree

1 file changed

+7
-3
lines changed

1 file changed

+7
-3
lines changed

src/site/antora/modules/ROOT/pages/manual/pattern-layout.adoc

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1339,15 +1339,19 @@ Includes either a random or a time-based UUID
13391339
.link:../javadoc/log4j-core/org/apache/logging/log4j/core/pattern/UuidPatternConverter.html[`UuidPatternConverter`] specifier grammar
13401340
[source,text]
13411341
----
1342-
u{RANDOM|TIME}
1343-
uuid{RANDOM|TIME}
1342+
u[{RANDOM|TIME}]
1343+
uuid[{RANDOM|TIME}]
13441344
----
13451345
1346-
The time-based UUID is a Type 1 UUID generated using the MAC address of each host
1346+
The random UUID is a type 4 UUID. The UUID is generated using a cryptographically strong pseudo-random number generator.
1347+
1348+
The time-based UUID is a Type 1 (date and time based) UUID generated using the MAC address of each host.
13471349
To ensure uniqueness across multiple JVMs and/or class loaders on the same host, a random number between 0 and 16,384 will be associated with each instance of the UUID generator class, and included in each time-based UUID generated.
13481350
See also xref:manual/systemproperties.adoc#log4j2.uuidSequence[`log4j2.uuidSequence`].
13491351
Because time-based UUIDs contain the MAC address and timestamp, they should be used with care.
13501352
1353+
TIME is the default.
1354+
13511355
[#format-modifiers]
13521356
=== Format modifiers
13531357

0 commit comments

Comments
 (0)