Configuring flowchart logging

Administrators can configure logging for all flowcharts in a partition and optionally allow users to override the settings for individual flowcharts.

About this task

To perform this procedure, you must have Administer configuration page permission in Unica Platform.

Task	Instructions
Set the global configuration properties to determine how logging occurs for all flowcharts in a partition.	Choose Settings > Configuration. Set the properties under Campaign\|partitions\|partition[n]\|server\|logging. For example, you can enable or disable logging, set the logging level, specify which events are logged, and allow users to change the log file path.
Set the administrative privileges to allow users to adjust logging options for individual flowcharts.	Choose Settings > User roles and permissions. Select a partition under the Campaign node. Click Add roles and assign permissions. On the Properties for Administrative Roles page, click Save and edit permissions. For Logging, check Override flowchart log options.
(Optional) For troubleshooting purposes only, enable trace logging	Trace logging is useful when working with Support. When you enable trace logging, trace events are written to both the listener log unica_aclsnr.log and the flowchart log <flowchart>.log. Trace events are identified by [T] in the log file. To enable trace logging: Add the following entry to the setenv.sh or setenv.bat file: UNICA_ACTRACE=Trace Restart the listener. Note: Trace logging can degrade performance so be sure to disable it (comment out the line and restart the listener) after you are done.

Task

Instructions

Set the global configuration properties to determine how logging occurs for all flowcharts in a partition.

Choose Settings > Configuration.
Set the properties under Campaign|partitions|partition[n]|server|logging.

For example, you can enable or disable logging, set the logging level, specify which events are logged, and allow users to change the log file path.

Set the administrative privileges to allow users to adjust logging options for individual flowcharts.

Choose Settings > User roles and permissions.
Select a partition under the Campaign node.
Click Add roles and assign permissions.
On the Properties for Administrative Roles page, click Save and edit permissions.
For Logging, check Override flowchart log options.

(Optional) For troubleshooting purposes only, enable trace logging

Trace logging is useful when working with Support. When you enable trace logging, trace events are written to both the listener log unica_aclsnr.log and the flowchart log <flowchart>.log.

Trace events are identified by [T] in the log file.

To enable trace logging:

Add the following entry to the setenv.sh or setenv.bat file: UNICA_ACTRACE=Trace
Restart the listener.

Note: Trace logging can degrade performance so be sure to disable it (comment out the line and restart the listener) after you are done.

Results

All flowcharts in the partition now use the configured properties for logging.

However, users who are allowed to Override flowchart log options can change the logging options when editing a flowchart. They can open a flowchart for editing and use the Log options menu to adjust the logging options, including the Severity level and Events that are logged. The selected options apply only to the flowchart that is being edited. The selected options do not persist beyond the current session. The next time a user edits the flowchart, the logging options revert to the default settings.

If AllowCustomLogPath is enabled in the global configuration and users have the appropriate permissions, users can change the log file location when editing a flowchart by choosing Log options > Change log path.

If enableLogging is enabled in the global configuration and users have the appropriate permissions, users can turn logging on or off for individual flowcharts by checking or clearing Enable logging on the Log options menu.