Getting Started with Kieker4DQL

Installation

After Cloning the project into your eclipse workspace you should be able to run it as an osgi bundle like all existing DQL plugins. By selecting the targetplatform "kieker4dql" in the provided project "tools.descartes.dql.connector.kieker.releng.platform", all dependencies needed to run the adapter will be downloaded and included automatically. The adapter registers itself as a DQL connector unter the name "kieker" which can now be chosen in the USING clause of DQL queries.

Additionally download a kieker distribution from the following location (the adapter was tested with kieker 1.13):

http://kieker-monitoring.net/download/

Running Examples

The project comes with two examples that can be found under "tools.descartes.dql.connector.kieker.examples". The helloWorld example shows monitoring and analysis with a simple jar application. Just load the project into your new eclipse instance and start one of the *.dql files by chosing "Run as -> DQL Launcher". The JPetStore example shows how Analysis can be done with logfiles that have not been produced by the adapter itself. These logfiles resulted during our evaluations with the JPetstore application and can be found in the "traceFiles" folder of the project.

Adapter Configuration

If you want to change the behaviour of the adapter run you may edit a projects properties file. The following properties can be customized: