pandorafms/pandora_doc/en/pandora_chapter5.xml

<?xml version="1.0" encoding="utf-8"?> 

<chapter id="chapter5">
	<title>Events</title>
	<para>
	  An event in Pandora is any unusual change happend in an
	  agent.
	</para>
	<para>
	  An event is registered when an agent is down or starts up,
	  when a monitor fails or changes its status, or when an alarm
	  is sent.
	</para>

	<para>
	  An event is usually preceded by an issue with the system
	  being monitored. A validation and deletion system has been
	  created to avoid leaving unanalised issues, so they can be
	  easily validated or deleted if the problem can be ignored or
	  it's been already solved.
	</para>

	<para>
	  The events appear ordered chronologically as they enter the
	  system, and can be viewed by clicking the "View Events"
	  option in the Operation menu.  The newest events are placed
	  at the top of the table.
	</para>

	<graphic scale='70' fileref="images/image045.png" valign="bottom" 
		 align="center"/>

	<para>
	The event information list shows the data in the following
	columns:</para>

	<para>
	<emphasis>Status:</emphasis> The event status is represented
	by the icon below:</para>
	<para>
	<inlinegraphic fileref="images/dot_green.png"/> The event has
	been validated</para>
	<para>
	<inlinegraphic fileref="images/dot_red.png"/> The event hasn't
	been validated
	</para>
	<para>
	<emphasis>Event name:</emphasis> Name assigned to the event by
	Pandora.
	</para>
	<para>
	<emphasis>Agent name:</emphasis> Agent where the event 
	happend.
	</para>
	<para>
	<emphasis>Group name:</emphasis> Group of the agent where the
	event has happened.
	</para>
	<para>
	<emphasis>User ID: </emphasis>User that validated the
	event.
	</para>
	<para>
	  <emphasis>Timestamp:</emphasis> Date and time when the event
	  was raised or validated - if it has been validated.
	</para>
	<para>
	  <emphasis>Action:</emphasis> Action that can be executed over
	  the event.
	</para>
	<para>
	<inlinegraphic fileref="images/ok.png"/> 
	This icon will validate the event, disappearing the icon
	</para>
	<para>
	<inlinegraphic fileref="images/cancel.png"/> 
	This icon will delete the event
	</para>
	<para>
	  The events can be also validated or deleted in groups by
	  selecting the tick boxes on the last column of the event,
	  and pressing "Validate" or "Delete" at the bottom of the
	  list.
	</para>
	<sect1 id="sec5.1">
	  <title>Statistics</title>
	  
	  <para>
	    Three different sort of graphical statistic
	    representation can be choosen from the "View
	    Events" &gt; "Statistics" option in the Operation menu:
	  </para>
	  
	  <itemizedlist>
	    <listitem>
	      <para>
		Total number of events divided by revised and not
		revised
	      <graphic fileref="images/image046.png" valign="bottom" 
		       align="center"/>
	      </para>
	    </listitem>
	    <listitem>
	      <para>
		Total events divided by the users who validated the
		events
	      <graphic fileref="images/image047.png" valign="bottom" 
		       align="center"/>
	      </para>
	    </listitem>
	    <listitem>
	      <para>
		Total events divided by the group the agent that launched
		the event belongs to
	      <graphic fileref="images/image048.png" valign="bottom" 
		       align="center"/>
	      </para>
	    </listitem>
	  </itemizedlist>
	</sect1>
</chapter>