Global log and trace properties for Teracloud® Streams domains and instances

Global log and trace properties apply to all Teracloud® Streams services. The domainLog.level property also applies to stream applications.

You can modify global properties by using the streamtool command-line interface or the Streams Console.

For more information about properties, use the following commands:
  • streamtool man domainproperties for information about domain properties
  • streamtool man properties for information about instance properties
Table 1. Global log and trace properties for Teracloud® Streams domains and instances

This table contains two columns. The first column contains the property name. The second column contains a description of the property and the default value.

Property name Description
domainLog.level domain property Specifies the default level to use for the administration log. The following options are in the order of severity, highest to lowest:
  • error
  • warn
  • info

The default value is warn.

domainLog.maximumFileCount domain property Specifies the maximum number of log files to save for each component. This property applies when you use a log type of file. When you change this property, the new value is used when the logging service starts.

The default value is 3.

domainLog.maximumFileSize domain property Specifies the maximum size, in kilobytes, of the component log files. This property applies when you use a log type of file. When you change this property, the new value is used when the logging service starts.

The default value is 5000.

domainLog.path domain property Specifies the directory path where the Teracloud® Streams domain log files and service trace files are stored. This property value is the root level directory that contains the log and trace files. The directory must exist before you start the Teracloud® Streams domain. More subdirectories are created as needed.

The default value is /tmp.

domainLog.type domain property Specifies the type of log to use for the administration log. The log messages can be sent to a rolling log file or to the Linux syslog logging interface. Specify the following value to use the rolling log file: file. Specify the following value to use the Linux syslog interface: syslog.

The default value is file.

domainTrace.defaultLevel domain property Specifies the default trace level to use for debugging problems with the Teracloud® Streams domain services. The following options are in the order, highest to lowest level, with a setting of trace generating the largest amount of data:
  • trace
  • debug
  • info
  • warn
  • error
  • off

The default value is error.

domainTrace.maximumFileCount domain property Specifies the maximum number of trace files to save per Teracloud® Streams domain service. When you change this property, the new value is used when a service restarts.

The default value is 3.

domainTrace.maximumFileSize domain property Specifies the maximum size, in kilobytes, of the Teracloud® Streams domain service trace files. When you change this property, the new value is used when a service restarts.

The default value is 5000.

instanceTrace.defaultlevel instance property Specifies the default trace level to use for debugging problems with Teracloud® Streams instance services. The following options are in the order, highest to lowest level, with a setting of trace generating the largest amount of data:
  • trace
  • debug
  • info
  • warn
  • error
  • off

The default value is error.

instanceTrace.maximumFileCount instance property Specifies the maximum number of trace files to save for each Teracloud® Streams instance service. When you update this property value, the change does not occur until the service restarts.

The default value is 3.

instanceTrace.maximumFileSize instance property Specifies the maximum size, in kilobytes, of the Teracloud® Streams instance service trace files. When you update this property value, the change does not occur until the service restarts.

The default value is 5000.