10.4. Checking session logs

You can check the session logs in the audit log, which is a log of all events that were logged from the session. Audit log is an XML-based log file which contains a log of all the events that occurred while executing a specific ksession.

Procedure 10.2. Creating a logger

  1. To create a logger, use KieServices as depicted below: 
    KieRuntimeLogger logger = KieServices.Factory.get().getLoggers()
  .newThreadedFileLogger(ksession, "mylogfile", 1000);
// do something with the ksession here
logger.close();
  2. Attach the new logger to a ksession.
  3. Be sure to close the logger after usage.

Procedure 10.3. Using Audit View

  1. To use Audit View, open Window > Show View > Other ...
  2. Under the Drools category, select Audit.
  3. To open a log file in Audit View, select the log file using the Open Log action in the top right corner, or simply drag and drop the log file from the Package Explorer or Navigator into the Audit View.
  4. A tree-based view is generated based on the data inside the audit log. Depicted below is an example tree-based view:
    An example tree-based view for Audit log.

    Figure 10.2. Tree-Based View

  5. An event is shown as a subnode of another event if the child event is caused by a direct consequence of the parent event.

Note

Note that the file-based logger will only save the events on close (or when a certain threshhold is reached). If you want to make sure the events are saved on a regular interval (for example during debugging), make sure to use a threaded file logger, so the audit view can be updated to show the latest state. When creating a threaded file logger, you can specify the interval after which events should be saved to the file (in milliseconds).