WildFly Full 21 Model Reference

Defines a handler which writes to a file, rotating the log after the size of the file grows beyond a certain point and keeping a fixed number of backups.

Provided capabilities(1)

Name	Dynamic	Other provider points
org.wildfly.logging.handler	true	/subsystem=logging/logging-profile=/periodic-rotating-file-handler= /subsystem=logging/periodic-size-rotating-file-handler=* /subsystem=logging/logging-profile=/custom-handler= /subsystem=logging/file-handler=* /subsystem=logging/custom-handler=* /subsystem=logging/logging-profile=/syslog-handler= /subsystem=logging/logging-profile=/socket-handler= /subsystem=logging/logging-profile=/console-handler= /subsystem=logging/periodic-rotating-file-handler=* /subsystem=logging/socket-handler=* /subsystem=logging/logging-profile=/file-handler= /subsystem=logging/syslog-handler=* /subsystem=logging/console-handler=* /subsystem=logging/logging-profile=/periodic-size-rotating-file-handler= /subsystem=logging/async-handler=* /subsystem=logging/logging-profile=/async-handler= /subsystem=logging/size-rotating-file-handler=*

Attributes (14)

append Specify whether to append to the target file.

Attribute	Value
Default Value	true
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services

autoflush Automatically flush after each write.

Attribute	Value
Default Value	true
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services

enabled If set to true the handler is enabled and functioning as normal, if set to false the handler is ignored when processing log messages.

Attribute	Value
Default Value	true
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services

encoding The character encoding used by this Handler.

Attribute	Value
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services

file The file description consisting of the path and optional relative to path.

Attribute	Value
Type	OBJECT
Nillable	false
Expressions Allowed	false
Storage	configuration
Access Type	read-write
Restart Required	no-services

filter-spec A filter expression value to define a filter. Example for a filter that does not match a pattern: not(match("JBAS.*"))

Attribute	Value
Capability reference	/subsystem=logging/filter=* /subsystem=logging/logging-profile=/filter=
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services

formatter Defines a pattern for the formatter.

Attribute	Value
Default Value	%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%e%n
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services

level The log level specifying which message levels will be logged by this logger. Message levels lower than this value will be discarded.

Attribute	Value
Default Value	ALL
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services
Allowed Values	ALL FINEST FINER TRACE DEBUG FINE CONFIG INFO WARN WARNING ERROR SEVERE FATAL OFF

max-backup-index The maximum number of backups to keep.

Attribute	Value
Default Value	1
Type	INT
Nillable	true
Expressions Allowed	true
Min	1
Max	2,147,483,647
Storage	configuration
Access Type	read-write
Restart Required	no-services

name The name of the handler.

Deprecated Since 1.2.0

The name attribute should not be used as the handler's address contains the name.

Attribute	Value
Type	STRING
Nillable	true
Expressions Allowed	false
Storage	configuration
Access Type	read-only

named-formatter The name of the defined formatter to be used on the handler.

Attribute	Value
Capability reference	/subsystem=logging/logging-profile=/custom-formatter= /subsystem=logging/custom-formatter=* /subsystem=logging/logging-profile=/json-formatter= /subsystem=logging/json-formatter=* /subsystem=logging/logging-profile=/xml-formatter= /subsystem=logging/xml-formatter=* /subsystem=logging/logging-profile=/pattern-formatter= /subsystem=logging/pattern-formatter=*
Type	STRING
Nillable	true
Expressions Allowed	false
Storage	configuration
Access Type	read-write
Restart Required	no-services

rotate-on-boot Indicates the file should be rotated each time the file attribute is changed. This always happens when at initialization time.

Attribute	Value
Default Value	false
Type	BOOLEAN
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services

rotate-size The size at which to rotate the log file.

Attribute	Value
Default Value	2m
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services

suffix Set the suffix string. The string is in a format which can be understood by java.text.SimpleDateFormat. The suffix does not determine when the file should be rotated.

Attribute	Value
Type	STRING
Nillable	true
Expressions Allowed	true
Storage	configuration
Access Type	read-write
Restart Required	no-services

Operations (8)

add Add a new size rotating file handler.

Request Parameter	Type	Required	Expressions Allowed	Default value	Description
append	BOOLEAN	false	true	true	Specify whether to append to the target file.
autoflush	BOOLEAN	false	true	true	Automatically flush after each write.
enabled	BOOLEAN	false	true	true	If set to true the handler is enabled and functioning as normal, if set to false the handler is ignored when processing log messages.
encoding	STRING	false	true		The character encoding used by this Handler.
file	OBJECT	true	false		The file description consisting of the path and optional relative to path.
filter-spec	STRING	false	true		A filter expression value to define a filter. Example for a filter that does not match a pattern: not(match("JBAS.*"))
formatter	STRING	false	true	%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%e%n	Defines a pattern for the formatter.
level	STRING	false	true	ALL	The log level specifying which message levels will be logged by this logger. Message levels lower than this value will be discarded.
max-backup-index	INT	false	true	1	The maximum number of backups to keep.
name	STRING	false	false		The name of the handler.
named-formatter	STRING	false	false		The name of the defined formatter to be used on the handler.
rotate-on-boot	BOOLEAN	false	true	false	Indicates the file should be rotated each time the file attribute is changed. This always happens when at initialization time.
rotate-size	STRING	false	true	2m	The size at which to rotate the log file.
suffix	STRING	false	true		Set the suffix string. The string is in a format which can be understood by java.text.SimpleDateFormat. The suffix does not determine when the file should be rotated.

change-file Change the file for a handler.

Deprecated Since 1.2.0
Use the write-attribute operation.

Request Parameter Type Required Expressions Allowed Default value Description

file OBJECT true false Change the file for a handler.
change-log-level Change the logging level for a handler.

Deprecated Since 1.2.0
Use the write-attribute operation.

Request Parameter Type Required Expressions Allowed Default value Description

level STRING false true ALL The new level to set.
disable Disable a logging handler.

Deprecated Since 1.2.0
Use the write-attribute for the enabled attribute.
enable Enable a logging handler.

Deprecated Since 1.2.0
Use the write-attribute for the enabled attribute.
remove Removes the size rotating file handler.

Request Parameter	Type	Required	Expressions Allowed	Default value	Description
file	OBJECT	true	false		Change the file for a handler.

Request Parameter	Type	Required	Expressions Allowed	Default value	Description
level	STRING	false	true	ALL	The new level to set.

resolve-path Resolves a relative path of a previously named paths or one of the standard paths provided by the system.

Request Parameter	Type	Required	Expressions Allowed	Default value	Description
relative-to-only	BOOLEAN	false	false		Indicates whether only the relative-to attribute should be resolved or the full path should be resolved. The default is false meaning the entire path will be resolved.

Reply properties

The resolved path from the relative path attribute.

type: STRING

update-properties Update the properties on the existing handler.

Deprecated Since 1.2.0

Use the write-attribute operation.

Request Parameter	Type	Required	Expressions Allowed	Default value	Description
level	STRING	false	true	ALL	The log level specifying which message levels will be logged by this logger. Message levels lower than this value will be discarded.
enabled	BOOLEAN	false	true	true	If set to true the handler is enabled and functioning as normal, if set to false the handler is ignored when processing log messages.
encoding	STRING	false	true		The character encoding used by this Handler.
formatter	STRING	false	true	%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%e%n	Defines a pattern for the formatter.
filter-spec	STRING	false	true		A filter expression value to define a filter. Example for a filter that does not match a pattern: not(match("JBAS.*"))
autoflush	BOOLEAN	false	true	true	Automatically flush after each write.
append	BOOLEAN	false	true	true	Specify whether to append to the target file.
max-backup-index	INT	false	true	1	The maximum number of backups to keep.
rotate-size	STRING	false	true	2m	The size at which to rotate the log file.
rotate-on-boot	BOOLEAN	false	true	false	Indicates the file should be rotated each time the file attribute is changed. This always happens when at initialization time.
named-formatter	STRING	false	false		The name of the defined formatter to be used on the handler.
file	OBJECT	true	false		The file description consisting of the path and optional relative to path.
suffix	STRING	false	true		Set the suffix string. The string is in a format which can be understood by java.text.SimpleDateFormat. The suffix does not determine when the file should be rotated.