CATEGORIES_FILTER

The CATEGORIES_FILTER element specifies the type of log messages to be captured. Specify multiple values by listing multiple filter names, separated by spaces.

This element is optional. If the CATEGORIES_FILTER element is omitted, no categorized messages are logged.

Table 1. Category filters
Filter Names Description
DEBUG Log internal information for debugging.
Important: Do not set unless requested by your support center.
WARNING Log warning messages.
ERROR Log error information.
MUTEX Log multithreading information.
SESSION Log session management information.
GAS Log information about the Genero Application Server version, build and package.
LOG Display log parameters.
CONFIGURATION Log configuration management information.
DEPRECATED Log warnings if a deprecated function is used in a template.
PROCESS Log Dynamic Virtual Machine data, error, any process handled by the Genero Application Server.
VM Log communications with the Dynamic Virtual Machine.
FT Log information about file transfer.
ACCESS Log summary information about the requests handled by the server.
HTTP Log http requests (interaction with the User Agent).
SOCKET Log information concerning sockets (creation, connection, communication, and so on).
TASK Extracts the time of all the things done by the GAS (a technical attribute).
TEMPLATE Information about TEMPLATE template processing.
TIMER Information about timers creation, destruction and expiration.
WA Context of the Web applications.
ALL Activate all categories except DEBUG.

Usage example

This example would be valid for the CATEGORIES_FILTER element:

 <CATEGORIES_FILTER>ERROR WARNING</CATEGORIES_FILTER>

Generate a detailed daily log file

If you encounter an issue, you can send a detailed log file to your support center.

To create the detailed daily log file, use the ALL pseudo category as the category filter.

Important: Only use the default categories ( GAS ACCESS PROCESS DEPRECATED ERROR WARNING ) when in production. Categories such as VM or ALL are for debugging and should only be set for a short period of time, as they generate many log entries. Non-standard categories should be used with care. The support center will tell you when you should set ALL for your categories filter.

Example

<LOG>
  <OUTPUT Type="DAILYFILE">/work/tmp/gas</OUTPUT>
  <FORMAT>date time relative-time process-id thread-id contexts
   event-type event-params<FORMAT>
  <CATEGORIES_FILTER>ALL</CATEGORIES_FILTER>
</LOG>

This example generates various log files in the /work/tmp/gas directory, depending on the dispatcher and the application or service run.