CATEGORIES (under LOG for JGAS)
This configuration element specifies the type of log messages to be captured.
Syntax
<CATEGORIES>name [...]
</CATEGORIES>
- The name can specify multiple category values by listing multiple filter names, separated by spaces. Valid category filter names are shown in Table 1
Filter Names | Description |
---|---|
ERROR |
Log error information. |
INFO |
Log information. |
VM |
Log communications with the Dynamic Virtual Machine. |
ALL |
Activate all categories. This is useful for debugging and should only be used in production or set for a short period of time when required, as it generates many log entries. |
Usage
You use this element to specify the categories filtered in a log message. It specifies filters
for messages written to the logs or sent to the standard output. The defaults are defined by the
JGAS resources:
<RESOURCE Id="log.console.categories">ERROR</RESOURCE>
<RESOURCE Id="log.file.categories">ERROR INFO</RESOURCE>
Usage override
The recommended usage is to override the CATEGORIES
resource value at the
command line when running the war file. By default only the
CONSOLE
log is enabled with the ERROR
category. When
troubleshooting, all logs can be specified by setting the CATEGORY
element with the
ALL
setting. This override example applies the ALL
filter category
to the console log resource:
fglgar run -w hello.war -E log.console.categories=ALL
The -E
or --resource-overwrite
option overwrites the default
category of logs. Information and error message for applications deployed in the
warare generated and written to the standard output.