CATEGORIES (under LOG for JGAS)

This configuration element specifies the type of log messages to be captured.

Syntax

<CATEGORIES>name [...]</CATEGORIES>
  1. The name can specify multiple category values by listing multiple filter names, separated by spaces. Valid category filter names are shown in Table 1
Table 1. Category filters
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.

Parent elements

This element is a child of the following elements: