Viewing the Policy Log

The policy log contains information about policy that CentraSite has executed. By default, CentraSite only logs information about policies that fail. However, you can optionally configure CentraSite to log information about policies that resulted in success, info, warning, and failure alerts. For information about configuring the logging facility for policies, see the CentraSite Administrator’s Guide.

Note:

Over time, the policy log can grow quite large, especially if you are logging information about successful policies. To prevent the policy log from growing too large, you should purge it periodically. For information about purging the policy log, see the CentraSite Administrator’s Guide.

Note:

From your inbox on the My CentraSite page, you can view the list of policies that failed during events that you triggered. You do not need special permissions to view this log. For procedures, see Viewing Failed Policies From Your Inbox.

In this field...

Specify...

Object Name

Optional. A pattern string that describes the names of the objects (of Object Type) whose log entries you want to view.

You can provide the exact name or use a pattern string consisting of a character sequence and/or the % wild card character (which represents any string of characters). For example, if you specify the pattern string ‘A%', CentraSite displays entities whose names start with ‘A'.

Leave Entity Name empty to view all names.

Policy Type

The type of policy whose log entries you want to view. To view the log entries for design/change-time policies, select Design/Change Time from the drop-down list (if it is not already selected).

Object Type

The object type whose log entries you want to view.

Event Type

The event type whose log entries you want to view.

Policy Status

The policy execution status that you want to view. A policy's execution status is the result set of each of its action's execution result. CentraSite writes the following policy execution status to the policy log depending on the log configuration.

Icon

Description

Success. Displays policies that have resulted in success alert.

Info. Displays policies that have resulted in informational alert.

Inprogress. Displays policies that have resulted in inprogress alert.

Warning. Displays policies that have resulted in warning alert.

Failure. Displays policies that have resulted in failure alert.

Note:

For information about log configuration, see the CentraSite Administrator’s Guide.

Execution Date

Optional. The time period that you want to examine. Leave the From and To fields empty to view log entries for all dates.

Note:

If a policy included a WS-I action, the log entry for the policy will include a link to the results of the WS-I action.

When an action in a design/change-time policy completes its execution, it returns a completion code and a completion message. If the completion code indicates success, informational or warning, CentraSite performs the next action in the policy (if one exists) or completes the requested work on the object (for example, it commits the given change to the database) and writes the information to the policy log. The policy log displays a success, informational and/or warning alert accordingly if configured to log these alerts.

However, if the completion code indicates failure, CentraSite records the error in the policy log. Then it immediately exits the policy. If the policy contains additional actions, those actions are not executed. If the policy was triggered by one of the pre-commit events (for example, during a PreCreate, PreUpdate or PreStateChange event) the requested operation is not performed. If the initial request had triggered multiple policies, any policy that had not yet been executed will be bypassed.

The policy's execution status will have...	Icon	Policy Action A	Policy Action B	Policy Action C	Policy Action D	Policy Action E
Success		Success	Success	Success	Success	Success
Info		Success	Success	Info	Success	Success
In Progress		Info	In Progress	Success	Success	Success
Warning		Success	In Progress	Info	Warning	Warning
Failure		Success	Warning	Success	Success	Failure

Note:

If you have used a client jar from the version 8.2.2, then CentraSite will show policy's result status as “Success” in the client side; but however on the server side the policy log will continue to store the policy's result status as “Informational” or “Warning”. This is because, a client jar used from versions of CentraSite prior to version 8.2.5 do not support the above policy status.