Configuring logging
An important aspect of any server application is logging. The Agent
Controller provides logging for debugging and reporting. This is
accomplished through the use of a single log file, servicelog.log, which is by
default, placed in the config directory where the Agent Controller is installed.
You can configure logging by
Changing the default logging directory
In certain situations, it will be necessary to change the default logging
directory. For example, this would be necessary on systems that have the Agent Controller installed
on a read-only file system.
To change the default logging directory, follow these steps:
- Locate the serviceconfig.xml configuration file. See the related task.
- Open it in an editor, and search for the <Logging>
element.
- Specify the new logging directory as the value for the
directory attribute of this element.
Modifying logging filters
You can specify that only messages of a
specified logging level or greater are to be logged to the file by the use of a
simple logging filter. The various
logging levels are specified below:
- SEVERE: Logs only non-recoverable error messages.
- CRITICAL: (default) Includes the above, plus messages that indicate
normal operations were interrupted by an error.
- WARNING: Includes the above, plus messages about unexpected events that
shouldn't interfere with continued operation.
- INFORMATION: Includes the above, plus messages about normal events that
may be of interest to a user.
- DEBUG: Includes the above, plus messages concerning the detailed flow of
internal operations used for troubleshooting.
To modify logging filters, follow these steps:
- In the serviceconfig.xml file, locate the <Logging>
element.
- Change the value of its level attribute to be one of the
above logging levels, according to your requirements.
Changing the format of the logged messages
You can specify the format of the message that are logged to be either
plain text or CBE formatted. The format specifications are:
- CBE:
(default) Messages will be logged using the Common Base Event format.
This includes detailed information about the context and origin of each
message. These messages are most easily read when using a CBE log
reading utility.
- Simple: Message will be logged in simple text.
To modify logging format, follow these steps:
- In the serviceconfig.xml file, locate the <Logging>
element.
- Change the value of its format attribute to be one of the
above logging formats, according to your requirements.
Related tasks
Locating the configuration files
Administering the Agent Controller