<?xml version="1.0" encoding="UTF-8"?>
<!--
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 - JASMINe Probe
 - Copyright (C) 2011-2012 Bull S.A.S.
 - Contact: jasmine@ow2.org
 -
 - This library is free software; you can redistribute it and/or
 - modify it under the terms of the GNU Lesser General Public
 - License as published by the Free Software Foundation; either
 - version 2.1 of the License, or any later version.
 -
 - This library is distributed in the hope that it will be useful,
 - but WITHOUT ANY WARRANTY; without even the implied warranty of
 - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 - Lesser General Public License for more details.
 -
 - You should have received a copy of the GNU Lesser General Public
 - License along with this library; if not, write to the Free Software
 - Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
 - USA
 -
 -
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 - $Id$
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<chapter version="5.0" xml:lang="en" xml:id="jasmineprobe.intro" xmlns="http://docbook.org/ns/docbook"
      xmlns:xlink="http://www.w3.org/1999/xlink"
      xmlns:xi="http://www.w3.org/2001/XInclude"
      xmlns:svg="http://www.w3.org/2000/svg"
      xmlns:mml="http://www.w3.org/1998/Math/MathML"
      xmlns:html="http://www.w3.org/1999/xhtml"
      xmlns:db="http://docbook.org/ns/docbook">
 <title>Introduction</title>

 <para>
     JASMINe Probe is a Java application developed within the <ulink url="http://wiki.jasmine.ow2.org/xwiki/bin/view/Main/WebHome">OW2 JASMINe project</ulink>.
     It's aimed to monitor Java Middleware <emphasis>targets</emphasis> by running <emphasis>probes</emphasis>.<sbr/>
     The different kind of targets are Java EE Servers, ESB, Java EE Applications, the Java Virtual Machines, and even the OS.
 </para>

 <para>
     The role of a probe is to periodically collect monitoring data, represented by <emphasis>indicator</emphasis> values, in order to make real time, or delayed, target supervision.
     Indicator values are published by <emphasis>outputs</emphasis> towards different type of consumers, like for example the
     <ulink url="http://wiki.jasmine.ow2.org/xwiki/bin/view/Main/Monitoring">JASMINe Monitoring</ulink> application.
 </para>

 <para>
     Several techniques are used to collect data. One of them is based on JMX, the Java Management standard,
     which allows to collect monitoring data from the Management Beans (MBeans) exposed by the targets.
     There are plans to support other standards, like SNMP, in the future.
     Besides that, some system monitoring data can be directly obtained by reading system files in an OS dependent implementation.
 </para>

 <para>
     JASMINe Probe is modular and extensible. It is based on OSGi.
     The underlying OSGi framework and the modular architecture of JASMINe Probe allow to easily add extensions that support new <emphasis>targets</emphasis>,
     <emphasis>indicator</emphasis>, or <emphasis>output</emphasis> types.
 </para>

 <para>
     JASMINe Probe can be used alone or in interaction with JASMINe Monitoring.<sbr/>
     In standalone mode, the monitoring data collected by probes can be browsed directly on the console terminal or/and saved into files.<sbr/>
     Used in conjunction with JASMINe Monitoring, the indicator values are published into the JASMINe Monitoring's message bus. This allows to use JASMINe EoS, the
     JASMINe Monitoring Web Console for live or delayed supervision.
     Moreover, it allows to detect abnormal behavior on targets, and possibly to execute repairing actions (see JASMINe Monitoring documentation).
 </para>

 <para>
   <mediaobject>
    <imageobject>
      <imagedata fileref="jp-architecture.png" align="center" width="100%" />
     </imageobject>
   </mediaobject>
 </para>
</chapter>
