This section describes how to enable custom logging for a process.
To enable custom logging for a process
- In the Development Studio, with the process displayed, right-click on the process canvas, choose Process Properties.
The process properties window appears. It includes two logging-related items as shown in the following image. Enable Logging is disabled by default.
- Select Enable Logging.
The Log File Name field is automatically populated with a default log file name using the values in the Process Name and Process ID fields. You can edit this field to change the log file name.
The custom log setting is activated only if the process is a root job. If this process is invoked as a call-process, the custom log setting will be ignored.
When you create a new process, the Process ID is not populated by default. To enable logging with a new process, save the process, access the process properties, and choose Enable Logging. The Log File Name field is automatically populated with a default log file name as described in the last step.
Process custom log files
The following list provides general information about process custom log files.
- Custom logs are created in the same directory where grid.log and processes.log files are created.
- A custom log file's format, size, and number of back-up files are the same as the those specified for processes.log in the logging configuration file, log4j.xml.
- Log entries are included in the processes.log file and the custom log file. The difference between custom log entries and processes.log entries is that the custom log only includes entries from one root process and processes.log includes entries from all root processes.
- Log entries related to multiple jobs for one root process will be appended to an existing custom log.