Using logging

Last Updated: 11/21/2018 Introduced in Version: 2.0

Summary

The Decisions server logs are stored in a csv file on the server at   C:\Program Files\Decisions\Decisions Services Manager\Decisions.CONTROLINSTANCE.log.csv. Utilizing these logs can be extremely important to debugging code that you’ve written. But before you can use these log effectively to debug your code, you need to know how your code can interact with these logs. The following describes how the different levels at which you can write logs and how to control with levels are written.
 
For a more in depth logging overview see documentation here: https://documentation.decisions.com/logging-overview/  

Logging Levels

Messages can be written to these logs at numerous levels which include the following:
  • Info
  • Debug
  • Warn
  • Error
  • Fatal

Logging at the Information and Debug levels will dramatically increase the size of log files over time, and negatively impact performance. These levels should only be turned on when necessary for troubleshooting, or for demonstrations.

The levels that are actually written to the log file can be control via the  Settings.xml  file which is located at  C:\Program Files\Decisions\Decisions Services Manager\Settings.xml. In this file, the settings for enabling/disables these log levels are located in the following tags.

Writing to the Logs

To write to the Decisions logs from your code, you first need to instantiate a  DecisionsFramework.Log. With this, you will be able to write to the logs at the different levels describes above.
 
Many of these level have the same input data. Here is a list of the pieces of input data used by these levels and how that data is used in the logs.
  • object sourceObject: The logger will attempt to do a .ToString() on the object and write that string in your log entry.
  • string message: This is the main part of your log message. You can write custom text here to signal where in your code you are. You can only merge in error message that have been caught.
  • params object[] arguments: This allows you input parameter into your log message. For example, you could write a log entry like this:  LogDebug(this,"{0} {1} {2} is today", "Thursday", "Jan 10th", "2013");
 
Below is comments sample code that explains the different levels. The attached project contains this code and can be compiled and deployed as a steps to allow you to test different combinations with the logging levels.
 

 

Accessing Logs

The Decisions logs can be accessed in two ways.
 
You can open the CSV file directly. This file is stored at  C:\Program Files\Decisions\Decisions Services Manager\Logs\\Decisions.CONTROLINSTANCE.log.csv.
 
Alternatively, you can view the logs from the Decisions portal by navigating to System > Administration > System Tools > Logging.
 
 
Fatal and error-level errors are also logged as Windows events for monitoring by external tools.
 
 

Logging Types

Assembly Types Parser AppDomain.log This is the log for Assembly Types that are Parsed in the App Domain. This is generally not enabled, but seems like that the Configuration was set to Log to its own file.
DecisionsServiceHost.exe.*.log This file contains the Log for the Main Service (i.e. the Windows Service that is Installed)
DecisionsServiceHost.exe.Usage.*.csv This File contains the Usage Log, Memory details, counts etc. for Host Service
DecisionsServiceHost.exe.UsageDetails.*.log This File contains the Usage Log, Memory details, counts etc. for Host Service (Individual Calls and Additional Details)
DecTail.exe Custom tailing application.
Primary.*.log Log messages from the Decisions Service Host Manager. – Primary Instance
Primary.Usage.*.csv Minute-by-minute logs of Flow executions, API calls, job executions, etc. – Primary Instance
Primary.UsageDetails.*.log Minute-by-minute counts of individual API calls, Flows runs, etc. – Primary Instance
View_Usage_CSV.ps1 & View_Usage_Text.ps1 These are powershell scripts to open the usage logs in powershell.
WebSite_HUI.log & WebSite_decisions.log These are more the construction of the website within IIS rather that Decisions thats hosted within. These are depreciated in newer versions.
 

Additional Resources