Logger Properties

Log files capture all executed commands and, depending on the logging level, the corresponding activities.

Refer to Setting and Overriding BusinessWorks Engine Properties for details on steps to set or override properties.

Logging Levels

The global logging level for each type of log is set to ERROR by default. Five levels are supported. Specifying a level includes all higher levels. Levels are listed below in order from lowest (least restrictive) to highest (most restrictive):

  • TRACE: Records fine-grained informational events.
  • DEBUG: Records fine-grained informational events that help in debugging. Useful for diagnostics.
  • INFO: Records informational messages that highlight the progress of the application. Useful for production mode.
  • WARN: Records potentially harmful situations.
  • ERROR: Records error events that are harmful enough to prevent the application from running.
Note: Setting the logging level to DEBUG can adversely affect the performance, especially when logging SOAP messages with attachments or mail with attachments. In such cases, we recommend fine tuning the loggers to log at the ERROR level instead of DEBUG.

Logger Properties

See Setting and Overriding BusinessWorks Engine Properties to set or override properties in TIBCO Cloud Integration.

Refer to the logback.xml file located in the <BW_HOME>\bwcloud\1.0\config\design\logback folder within your TIBCO Business Studio for BusinessWorks installation for the supported logger properties and their default values.

Setting BW Logger and Engine Config Properties through the Web UI

Set BW Logger and Engine Config properties using the Web UI, in the Engine Variables tab.

The following related system properties are exposed on the Web UI:

  • BW_LOGGER_OVERRIDES - Overrides the default values for different logger properties.
  • BW_ENGINE_THREADCOUNT - Overrides the default value for the bw.engine.threadcount property.
  • BW_ENGINE_STEPCOUNT - Overrides the value for the bw.engine.stepcount property.
  • CUSTOM_ENGINE_PROPERTY - Sets different Java properties from the Web UI.
  • BW_INSTRUMENTATION_ENABLED - Overrides the default value for the bw.frwk.event.subscriber.instrumentation.enabled property.
  • BW_APP_CPU_ALERT_THRESHOLD - Sets the threshold of CPU% usage by the application to issue an alert warning log.
  • BW_APP_MEM_ALERT_THRESHOLD - Set the threshold of memory% usage by the application to issue an alert warning log.

For information on how to add a BusinessWorks custom property (java.properties) application, see Configuring App Properties in the Managing Apps section in the Getting Started guide.

Note: If you add engine properties that already exist in the application, the most recently added properties take precedence over existing properties.

For example : If you add the bw.engine.stepcount property through the environment variable feature, the property's value takes precedence over the value set in the BW_ENGINE_STEPCOUNT variable. In the same manner, if you add the custom.engine.property property, its value takes precedence over the value set in the CUSTOM_ENGINE_PROPERTY variable.

Note: To use multiple custom properties simultaneously, enter them in the CUSTOM_ENGINE_PROPERTY property separated by spaces.
Note: The BW_APPLICATION_JOB_FLOWLIMIT property has been removed from the UI. Use the CUSTOM_ENGINE_PROPERTY property instead. Set the property using the format specified in Job Tuning Properties.