pandorafms/pandora_doc/en/pandora_chapter5.xml

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

<chapter>
	<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 newer events are placed at the top of the table.</para>

	<graphic 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 bellow:</para>
	<para><graphic fileref="../../images/dot_green.gif"/> The event has been validated</para>
	<para><graphic fileref="../../images/dot_red.gif"/> 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><graphic fileref="../../images/ok.gif"/> This icon will validate the event, disappearing the icon</para>
	<para><graphic fileref="../../images/cancel.gif"/> 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>
		<title>Statistics</title>

		<para>Three different kinds 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 raising the event belongs to
		<graphic fileref="images/image048.png" valign="bottom" align="center"/>
		</para>
		    </listitem>
		</itemizedlist>
	</sect1>
</chapter>