Software AG Products 10.7 | Administering CentraSite | Managing Logs | Configuring Logs | Creating Log Setting Configuration File
 
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.