Overriding the behaviour of separated runtime logs for process applications

You can configure process application logging to redirect runtime log messages to separate files for easier troubleshooting and debugging in IBM® Business Automation Workflow.

About this task

Note: The REST ops/std/bpm/containers/<container>/logging_override is meant to override a logging setting that was defined on a project by following the steps in Enabling custom logging. Using this on a project that does not have the project setup for REST has no impact on the application logging since there was nothing to override. The REST does not enable logging for projects that is not set up for REST.

Process application logging enables you to override the default logging configuration and redirect runtime log messages for specific process applications to separate log files. This separation makes it easier to isolate and analyze logging output for individual process applications without searching through the entire system log.

When you configure logging for a process application, you can specify a custom file location, file name, and log level. You can also enable or disable logging for each process application independently.

To configure process application logging:

Procedure

  1. Log in to the Process Admin Console.
  2. In the Server Admin area, click Admin Tools > Process Application Logging.
  3. In the Overridden process applications section, select the process application for which you want to configure logging.
    If the process application is not listed, you need to add it to the overridden process applications list first.
  4. In the Logging details section, configure the logging settings:
    1. In the Process app field, verify the selected process application name and acronym.
    2. From the Log level list, select the logging level.
      The log level determines the amount of detail captured in the log file. Available log levels include:
      • INFO - Captures informational messages, warnings, and errors
      • WARNING - Captures warning messages and errors
      • ERROR - Captures only error messages
      • DEBUG - Captures detailed debugging information
    3. Select the Enable logging checkbox to activate logging for this process application.
      When enabled, runtime log messages for the process application are redirected to the specified log file. When disabled, the process application will log to the global file (if specified) otherwise uses the default system logging configuration
  5. Click Update to save your changes.

Results

Process application logging is configured. Runtime log messages for the selected process application are now redirected to the specified log file at the configured logging level.

The Logging Configuration Source indicator displays Overridden log configuration to confirm that custom logging is active for this process application.

What to do next

To remove a process application from the overridden list and return it to the default logging configuration, select the process application in the Overridden process applications section and click Remove.