Before you start
The Log and Trace Analyzer in the IBM® Autonomic Computing Toolkit monitors, correlates, analyzes, diagnoses, and resolves run-time problems in complex heterogeneous systems. The Log and Trace Analyzer collects and consolidates practical problem-determination data in the Common Base Event format from disparate systems into a single management tool. You can then use the Log and Trace Analyzer for viewing, navigating, sorting, filtering, searching, correlating, and analyzing.
This tutorial shows you how to configure Common Base Event logging in the JavaTM language. This gives you a rich source of activity and control-flow information to accelerate problem determination and increase system serviceability and quality. The Log and Trace Analyzer can then use logged Common Base Events to detect and resolve configuration errors, performance degradation, exception states, resource starvation, security failures, communication delays, deadlocking, and other problems.
The tutorial introduces the concept of problem determination, outlines the Common Base Event model, and details the benefits of logging events and problems in the Common Base Event format. You learn how to configure a Java class for Common Base Event logging using the Java Logging APIs. This teaches you the essential Common Base Event properties and best practices you need for effective serviceability and internationalization. Finally, you learn how to leverage the Common Base Event factory for increased performance, decreased maintenance, and vendor-specific content.
This tutorial is intended for developers who want to use Common Base Event logging in new and existing Java applications. Architects who want to incorporate serviceability into their designs can also benefit from the tutorial. Having a basic knowledge of generic logging concepts and Common Base Events, and having moderate experience with the Java language and Eclipse, will help you complete the tutorial's tasks and understand its examples.
This tutorial requires the Autonomic Computing Toolkit V2.0. The Autonomic Computing Toolkit V2.0 requires Eclipse V3.0.1. Eclipse V3.0.1 requires the Java Runtime Environment (JRE) V1.4 or above.
To run the code in this tutorial, you need the Common Base Event V1.0.1 Java implementation and support in the Log and Trace Analyzer V3.0.0, which is part of the Autonomic Computing Toolkit V2.0. The following plug-in Java Archive (JAR) files located in the <Autonomic Computing Toolkit installation directory>\eclipse\plugins directory are required for this tutorial:
| JAR file | Plug-in | Content |
| hlcbe101.jar | org.eclipse.hyades.logging.core_3.0.1 | Common Base Event V1.0.1 implementation |
| hlcore.jar | org.eclipse.hyades.logging.core_3.0.1 | Common Base Event V1.0.1 implementation's logging core dependency |
| ecore.jar | org.eclipse.emf.ecore_2.0.1\runtime | Common Base Event V1.0.1 implementation's Eclipse Modeling Framework dependency |
| common.jar | org.eclipse.emf.common_2.0.1\runtime | Common Base Event V1.0.1 implementation's Eclipse Modeling Framework dependency |
| hl14.jar | org.eclipse.hyades.logging.java14_3.0.1 | Common Base Event and Logging Agent support for the Java Logging APIs |
| hexr.jar | org.eclipse.hyades.execution.remote_3.0.0 | Logging Agent's execution dependency |
The Common Base Event V1.0.1 Java implementation API Javadoc documentation is located at <Autonomic Computing Toolkit installation directory>\eclipse\plugins\org.eclipse.hyades.logging.core_3.0.1\doc.cbe101\index.html.

