Creating Log Setting Configuration File
You create a log configuration file, config.xml, to define the log settings.
Ensure that the log configuration file contains the XML namespaces for providing uniquely named elements and attributes.
Defining a Log Unit
The unique element LogUnit represents the com.centrasite.config.log.unit property in config.xml. The LogUnit element specifies the log record to be stored in the CentraSite Registry Repository.
In the LogUnit element, add an attribute called name and assign a value to it which is equal to either of the following:
Log Unit | Description |
Policy_Log | Contains information about the design/change-time policies that CentraSite has executed. |
Approval_Log | Contains information about all approval requests that has been triggered by a policy with an approval workflow action. |
Audit_Log | Contains information on the creation or update activities of a particular asset (including changes in an asset's lifecycle state). |
Runtime_Event_Log | Contains information about run-time events that have occurred in a gateway (that is, a policy-enforcement point (PEP) or a run-time monitoring component). |
Runtime_Performance_Log | Contains information about the KPI metrics of all rogue assets. |
This LogUnit element must look similar to this:
<LogUnit name=Policy_Log></LogUnit>
Defining the Log Settings
The com.centrasite.config.log.setting property represents the LogSetting attribute. This attribute defines specific information about the performance of the registry object.
In this section, you create log settings that is used within the log unit definition.
Within the LogUnit element, create LogSetting attributes say, Success and, Failure.
You can configure the LogUnit element with one of the appropriate LogSetting attributes.
Log Unit | Description |
Policy_Log | Log Setting | Logs |
Success | Policies that have resulted in success alert. |
Info | Policies that have resulted in informational alert. |
Warning | Policies that have resulted in warning alert |
Failure | Policies that have resulted in failure alert. |
Approval_Log | Log Setting | Logs |
Log_Approval | Approval policies that have resulted in Approved state. |
Audit_Log | Log Setting | Logs |
Enable_Audit | All activities (such as creation, modified, and so on) performed on a particular asset. |
Runtime_Event_Log | Log Setting | Logs |
Policy_Violation_Events | Monitors and tracks all the policy violation events. |
Transaction_Events | Monitors and tracks all the transaction events. |
Monitoring_Events | Monitors and tracks all the monitoring events. |
Lifecycle_Events | Monitors and tracks all the lifecycle events. |
Runtime_Performance_Log | Log Setting | Logs |
Log_Performance_Events | Monitors and tracks all the performance events |
This LogSetting attribute must look similar to this:
<LogUnit name=Policy_Log>
<LogSetting>Success</LogSetting>
<LogSetting>Failure</LogSetting>
</LogUnit>
The final config.xml must look similar to this:
<LogSettings xmlns="http://namespaces.centrasite.com/configurations/logs">
<LogUnit name=Policy_Log>
<LogSetting>Success</LogSetting>
</LogUnit>
<LogUnit name=Approval_Log>
<LogSetting>Log_Approval</LogSetting>
</LogUnit>
<LogUnit name=Audit_Log>
<LogSetting>Enable_Audit</LogSetting>
</LogUnit>
<LogUnit name=Runtime_Event_Log>
<LogSetting>Transaction_Events</LogSetting>
<LogSetting>Policy_Violation_Events</LogSetting>
<LogSetting>Monitoring_Events</LogSetting>
<LogSetting>Lifecycle_Events</LogSetting>
</LogUnit>
<LogUnit name=Runtime_Performance_Log>
<LogSetting>Log_Performance_Events</LogSetting>
</LogUnit>
</LogSettings>
If you do not specify a log setting value or if you specify an incorrect log unit or log setting value (for example, Log Approval), the command execution fails and a warning message is issued.
(this is correct)
<LogUnit name=Policy_Log>
<LogSetting>Success</LogSetting>
</LogUnit>
(this is incorrect due to missing LogSetting element)
<LogUnit name=Policy_Log>
</LogUnit>
(this is incorrect due to invalid LogSetting value)
<LogUnit name=Policy_Log>
<LogSetting>Success_and_Failure</LogSetting>
</LogUnit>
Note:
Make sure you copy this file somewhere within the file system of the machine where CentraSite is installed.