JBoss EAP 8.0.0.Beta Model Reference

Defines a custom logging handler. The custom handler must extend java.util.logging.Handler.

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/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/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=*

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.

Deprecated Since 1.2.0

Use filter-spec.

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

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

Deprecated Since 1.2.0

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

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

properties Defines the properties used for the logging handler. All properties must be accessible via a setter method.

add Adds a new custom handler. The handler must extend org.jboss.logmanager.ExtHandler, java.util.logging.Handler or be a log4j appender.

Request Parameter	Type	Required	Expressions Allowed	Default value	Description
class	STRING	true	false		The logging handler class to be used.
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.
filter	OBJECT	false	false		Defines a simple filter type.
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.
module	STRING	true	false		The module that the logging handler depends on.
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.
properties	OBJECT	false	true		Defines the properties used for the logging handler. All properties must be accessible via a setter method.

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 custom handler.

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

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.*"))
class	STRING	true	false		The logging handler class to be used.
module	STRING	true	false		The module that the logging handler depends on.
named-formatter	STRING	false	false		The name of the defined formatter to be used on the handler.
properties	OBJECT	false	true		Defines the properties used for the logging handler. All properties must be accessible via a setter method.
filter	OBJECT	false	false		Defines a simple filter type.