WildFly 14.0 Model Reference

Defines a handler which writes to a file, rotating the log after a time period derived from the given suffix string or after the size of the file grows beyond a certain point and keeping a fixed number of backups. The suffix should be in a format understood by the java.text.SimpleDateFormat. Any backups rotated by the suffix will not be purged during a size rotation.

Provided capabilities(1)

Name	Dynamic	Other provider points
org.wildfly.logging.handler	true	/subsystem=logging/logging-profile=/periodic-rotating-file-handler= /subsystem=logging/logging-profile=/custom-handler= /subsystem=logging/custom-handler=* /subsystem=logging/file-handler=* /subsystem=logging/logging-profile=/syslog-handler= /subsystem=logging/logging-profile=/socket-handler= /subsystem=logging/logging-profile=/console-handler= /subsystem=logging/logging-profile=/size-rotating-file-handler= /subsystem=logging/periodic-rotating-file-handler=* /subsystem=logging/logging-profile=/file-handler= /subsystem=logging/socket-handler=* /subsystem=logging/syslog-handler=* /subsystem=logging/logging-profile=/periodic-size-rotating-file-handler= /subsystem=logging/console-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.*"))

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/logging-profile=/xml-formatter= /subsystem=logging/json-formatter=* /subsystem=logging/logging-profile=/pattern-formatter= /subsystem=logging/xml-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 period of the rotation is automatically calculated based on the suffix.

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

Operations (4)

add Adds a new periodic 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	true	true		Set the suffix string. The string is in a format which can be understood by java.text.SimpleDateFormat. The period of the rotation is automatically calculated based on the suffix.

path-info Obtain the informations for a filesystem path.

Request Parameter	Type	Required	Expressions Allowed	Default value	Description
unit	STRING	false	false	BYTES	Disk space unit to display disk usage.

Reply properties

Filesystem path for which to obtain disk usage.

type

OBJECT

Value Type

{
    "used-space" => {
        "type" => DOUBLE,
        "description" => "The total size of the contents of a filesystem path.",
        "expressions-allowed" => false,
        "required" => true,
        "nillable" => false,
        "unit" => "BYTES"
    },
    "creation-time" => {
        "type" => STRING,
        "description" => "The creation time of a filesystem path.",
        "expressions-allowed" => false,
        "required" => true,
        "nillable" => false,
        "min-length" => 1L,
        "max-length" => 2147483647L
    },
    "last-modified" => {
        "type" => STRING,
        "description" => "The last modified time of a filesystem path.",
        "expressions-allowed" => false,
        "required" => true,
        "nillable" => false,
        "min-length" => 1L,
        "max-length" => 2147483647L
    },
    "resolved-path" => {
        "type" => STRING,
        "description" => "The resolved filesystem path.",
        "expressions-allowed" => false,
        "required" => true,
        "nillable" => false,
        "min-length" => 1L,
        "max-length" => 2147483647L
    },
    "available-space" => {
        "type" => DOUBLE,
        "description" => "The total size of available space for the partition containing a filesystem path.",
        "expressions-allowed" => false,
        "required" => true,
        "nillable" => false,
        "unit" => "BYTES"
    }
}

remove Removes the periodic size rotating file handler.

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