Introduction
K2 blackpearl provides a native logging framework and auditing features that enables Administrators to monitor and troubleshoot the K2 blackpearl environment. System Event Logging is initiated automatically (default operation) from product installation and is active through to runtime. System auditing features are initiated manually by the developer per individual process at design time and leveraged during runtime.
The logging and auditing features of K2 blackpearl are built into the platform but operate and are configured in different ways. This whitepaper discusses each feature in detail.
Key areas discussed: - System Extensibility
- Level of integration
- Configuration
- How to leverage and make use of the system event logs and audit capability
Enable Logging
The steps described in this section will enable an administrator to enable logging, but without a full discussion of system requirements and possible implications. Be advised that the steps should only be pursued after reviewing the accompanying document or under the direction of a K2 Consultant.
The steps required to enable server logging are described below.
- Open the following file in notepad:
[SystemDrive]:\Program Files\K2 blackpearl\Host Server\Bin\HostServerLogging.config
- Find the following section
<ApplicationLevelLogSettings>
<ApplicationLevelLogSetting Scope="Default">
<LogLocationSettings>
<LogLocation Name="ConsoleExtension" Active="True" LogLevel="Info" />
<LogLocation Name="FileExtension" Active="False" LogLevel="All" />
<LogLocation Name="EventLogExtension" Active="False" LogLevel="Debug" />
<LogLocation Name="ArchiveExtension" Active="False" LogLevel="Debug" />
<LogLocation Name="MSMQExtension" Active="False" LogLevel="Debug" />
</LogLocationSettings>
</ApplicationLevelLogSetting>
</ApplicationLevelLogSettings>
- Change the following line from:
<LogLocation Name="FileExtension" Active="False" LogLevel="All" />
To:
<LogLocation Name="FileExtension" Active="True" LogLevel="All" />
- Save and close the file
- Restart the K2 service
- The log files will be located in the [SystemDrive]:\Program Files\K2 blackpearl\Host Server\Bin\directory