-Add new help

git-svn-id: https://svn.code.sf.net/p/pandora/code/trunk@11 c3f86ba8-e40f-0410-aaad-9ba5e7f4b01f
This commit is contained in:
raulmateos 2006-04-20 17:40:45 +00:00
parent eed0503731
commit bf28867b70
139 changed files with 2591 additions and 0 deletions

View File

@ -0,0 +1,56 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - The Free Monitoring System Help - I. Introduction</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
</head>
<body>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Pandora Help v1.2</h1>
</div>
<div class="toc">
<h1><a href="toc.php">Table of Contents</a> » <a href="chap2.php">2. Users</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora is a GPL Software Project. &copy; Sancho Lerena 2003-2005, David villanueva 2004-2005, Alex Arnal 2005, Ra&uacute;l Mateos 2004-2005.</p>
</div>
<a name="1"><h1>1. Introduction</h1></a>
<h2><a name="11">1.1. Pandora Administration</a></h2>
<p>The web console is the tool used to administrate Pandora. It is written in PHP and doesn't
need any third party software to work neither FLASH, JAVA, nor ActiveX
plug-ins. The Web console can be run over any web browser supporting HTML and
CSS (IE5+ or Mozilla 4+).</p>
<p class="center">
<img src="images/image001.png" alt="image001">
</p>
<p>Pandora administration is divided in the following main elements:</p>
<ul>
<li>Pandora users</li>
<li>Agents</li>
<li>Alerts</li>
<li>Incidents</li>
<li>Server configuration</li>
<li>Database maintenance</li>
</ul>
</body>
</html>

View File

@ -0,0 +1,116 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - The Free Monitoring System Help - II. Users</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
</head>
<body>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Pandora Help v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap1.php">1. Introduction</a> « <a href="toc.php">Table of Contents</a> » <a href="chap3.php">3. Agents</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora is a GPL Software Project. &copy; Sancho Lerena 2003-2005, David villanueva 2004-2005, Alex Arnal 2005, Ra&uacute;l Mateos 2004-2005.</p>
</div>
<a name="2"><h1>2. Users</h1></a>
<p>The definition of a user is based on the user's
daily activity. One or more profiles can be assigned to a single user</p>
<p>A profile is a list of actions a user can or
cannot perform on a given group, e.g. "view incidents", "database management", etc.</p>
<p>Each user is given a number of groups of agents
he has permission to access, as well as the administrative profile he will have
in each group. Each user can belong to one or more groups, with an assigned
profile for each of them.</p>
<p>Agent belongs to a group and only one, sharing
the group with agents of similar characteristics. Groups also contain
incidents.</p>
<h2><a name="21">2.1. Profile manager</a></h2>
<p>Pandora's profile manager is used to assign specific profiles to each user. A hierarchy of users is so created, structured by the user's profile within the company. With this system different security
levels can be implemented: read-only users, agent group coordinators or system administrators.</p>
<p>A profile is created from the Profile Manager tool in the Administration menu. There are five predefined profiles:</p>
<ul>
<li>Operator (Read)</li>
<li>Operator (Write)</li>
<li>Chief Operator</li>
<li>Group coordinator</li>
<li>Pandora Administrator</li>
</ul>
<p>To create a new profile click on "Manage Profiles"&gt;"Create Profile" in the Administration Menu</p>
<p class="center"><img src="images/image002.png"></p>
<p>Any of the following roles can be assigned to a new profile:</p>
<ul>
<li>View incidents</li>
<li>Edit incidents</li>
<li>View agents. To view agents as well as the events generated by them</li>
<li>Edit agents. To modify then agent's modules</li>
<li>Edit alerts. To modify the alerts assigned to an agent</li>
<li>Manage users. To modify users and their roles</li>
<li>Manage DB. To modify the configuration and data of the database (Global)</li>
<li>Manage alerts. To define new alerts (Global)</li>
<li>Manage Pandora. To modify general system settings</li>
</ul>
<h2><a name="22">2.2. Adding a user</a></h2>
<p>A user is added clicking on "Manage Users"&gt;"Create user" in the Administration Menu</p>
<p>To create a new user it is necessary to, at
least, fill in the user ID, the password (twice) and Pandora's global profile.</p>
<p>A global profile for a user maybe Administrator or Standard User.</p>
<p>A user with an "Administrator" profile will have the highest security privileges in Pandora.</p>
<p class="center"><img src="images/image003.png"></p>
<p>Profiles must be assigned for each of the groups a new "standard" profile user can access, once the user is created and his configuration updated.</p>
<p class="center"><img src="images/image004.png"></p>
<p>A user profile is deleted by clicking on the delete icon <img src="../../images/cancel.gif"> on the right hand side of the profile.</p>
<h2><a name="23">2.3. Deleting a user</a></h2>
<p>A user is deleted by clicking on the delete icon <img src="../../images/cancel.gif"> on the right hand side of the user. The list of users is accessed through the "Manage Users" option in the Administration menu.</p>
<p class="center"><img src="images/image005.png"></p>
<h2><a name="24">2.4. Statistics</a></h2>
<p>The user activity statistics show a graph with the activity of the user, being the number of events the audit has generated for each user. The number of events of
a user usually reflects the user's activity.</p>
<p>Click on "View Users"&gt;"Statistics" in the Operation menu to show this graph:</p>
<p class="center"><img src="images/image006.png"></p>
</body>
</html>

View File

@ -0,0 +1,434 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - The Free Monitoring System Help - III. Agents</title>
<link rel="stylesheet" type="text/css" href="../../include/styles/pandora.css">
<style>
.ml15 {margin-left: 15px;}
.ml25 {margin-left: 25px;}
.ml35 {margin-left: 35px;}
.ml75 {margin-left: 75px;}
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
</head>
<body>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Pandora Help v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap2.php">2. Users</a> « <a href="toc.php">Table of Contents</a> » <a href="chap4.php">4. Incident Management</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora is a GPL Software Project. &copy; Sancho Lerena 2003-2005, David villanueva 2004-2005, Alex Arnal 2005, Ra&uacute;l Mateos 2004-2005.</p>
</div>
<a name="3"><h1>3. Agents</h1></a>
<p>The agents collect information. The public key
of the machine to be monitored needs to be copied onto Pandora and the agent
executed. Pandora's server starts now receiving and processing the data
collected by the agent. The data collected from the agents are called "modules".</p>
<p>The value of each module it is the value of one
monitored variable. The agent must be activated in Pandora's server and a group
assigned to the agent. The data starts then been consolidated in the database
and can be accessed.</p>
<p>The user can:</p>
<ul>
<li>View the agent status</li>
<li>Access to the collected information</li>
<li>Access the monitored values and its evolution in time</li>
<li>View graphic reports</li>
<li>Configure Alerts</li>
</ul>
<h2><a name="31">3.1. Group Manager</a></h2>
<p>Groups are added in "Manage Profiles" &gt; "Manage Groups", Administration menu.</p>
<p class="center"><img src="images/image007.png"></p>
<p>There are nine default groups on this screen.</p>
<ul>
<li><b>All</b> (all groups)</li>
<li><b>Applications</b></li>
<li><b>Comms</b></li>
<li><b>Databases</b></li>
<li><b>Firewall</b></li>
<li><b>IDS</b></li>
<li><b>Others</b></li>
<li><b>Servers</b></li>
<li><b>Workstations</b></li>
</ul>
<p>
A group is added by clicking "Create group" and assigning a name to it.</p>
<p>
A group is deleted by clicking the delete icon <img src="../../images/cancel.gif"> in the right hand side of each group. It is not recommended to delete the group "All".</p>
<h2><a name="32">3.2. Adding an agent</a></h2>
<p>Before an agent is added, the public key of the
machine to be monitored needs to be copied. The agent is then executed, and
added through the web console. The data starts now being consolidated in the
Database and can be accessed.</p>
<p>An agent is added in "Manage Agents" &gt; "Create agent" in the Administration menu.</p>
<p class="center"><img src="images/image008.png"></p>
<p>To add a new agent the following parameters must be configured:</p>
<ul>
<li><b>Agent Name:</b> Name of the agent. This and the "agent name" parameter in Pandora's agent.conf file <b>must have the same value</b>. If this variable is commented out in the code, the name used will be the name of the Host (to obtain this, execute the <i>hostname</i> command).</li>
<li><b>IP Address:</b> IP address of an agent. An agent can share its IP address with other agents.</li>
<li><b>Group:</b> Pandora's group the agent belongs.</li>
<li><b>Interval:</b> Execution interval of an agent. It is the time elapsed between two executions.</li>
<li><b>OS:</b> The Operating System to be monitored. The supported Operating Systems are: AIX, BeOS,
BSD, Cisco, HPUX, Linux, MacOS, Other, Solaris, Windows.</li>
<li><b>Description:</b> Brief description of an agent.</li>
<li><b>Module definition:</b> There are two modes for a module:</li>
<p class='ml15'>- <i><b>Learning mode:</b></i> All the modules sent by the agent are accepted. They are automatically defined by the system. It is recommended to activate the agents in this mode and change it once the user is familiar with the system.</p>
<p class='ml15'>- <i><b>Normal mode:</b></i> The modules in this mode must be configured manually. The self definition of the modules is not allowed in this mode.</p>
<li><b>Disabled:</b> This parameter shows if the agent is activated and
ready to send data or deactivated. The deactivated agents don't appear in the
user views.</li>
</ul>
<h3><a name="321">3.2.1. Assigning modules</a></h3>
<p>Pandora's agents use the operating system own commands to monitor a device. Pandora's server will store and process the output generated by those commands. The commandos are called "modules".</p>
<p>If the agent had been added in "normal mode", the modules to be monitored should have been assigned. Those modules must be configured in the agent configuration file.</p>
<p>The modules to be processed by Pandora's server are assigned in the "Manage Agents" option, Administration menu. A list with all the agents in Pandora will be shown here.</p>
<p>You'll get a form with all the agent's settings when the agent name is clicked. In the same screen there is a section to assign modules.</p>
<p class="center"><img src="images/image009.png"></p>
<p>The following fields must be filled to create a module:</p>
<ul>
<li><b>Module type:</b> This is the type of data the module will process. There are five types of data:</li>
<p class='ml15'>
- <b><code>generic_data</code></b>, Integer data type<br>
- <b><code>generic_data_inc</code></b>, Incremental integer data type<br>
- <b><code>generic_data_proc</code></b>, Boolean data type: 0 False, &gt;0 True.<br>
- <b><code>generic_data_string</code></b>, Alphanumeric data type (text string, max. 255 characters).
</p>
<li><b>Module name:</b> The name of the module</li>
<li><b>Maximum:</b> Upper threshold for the value in the module. Any value above this threshold will be taken as invalid and the whole module will be discarded.</li>
<li><b>Maximum:</b> Lower threshold for the value in the module. Any value below this threshold will be taken as invalid and the whole module will be discarded.</li>
<li><b>Comments:</b> Comments added to the module.</li>
</ul>
<p>All the modules to be monitored by an agent can be reviewed by accessing the agent in the "Manage Agents" option, Administration menu.</p>
<p class="center"><img src="images/image010.png"></p>
<p>In this screen the modules can be:</p>
<ul>
<li>Deleted by clicking <img src="../../images/cancel.gif"></li>
<li>Edited by clicking <img src="../../images/config.gif"></li>
</ul>
<p>However, the type of data of the module can't be modified.</p>
<h3><a name="322">3.2.2. Alerts</a></h3>
<p>An alert is Pandora's reaction to an out of range module value. The Alert can
consist in sending and e-mail or SMS to the administrator, sending a SNMP trap,
write the incident into the system syslog or Pandora log file, etc. And
basically anything that can be triggered by a script configured in Pandora's
Operating System.</p>
<h4><a name="3221">3.2.2.1. Adding an Alert</a></h4>
<p>The existing Alerts are accessed by clicking on the "Manage Alerts" option, Administration menu.</p>
<p>There are 6 default types of Alerts:</p>
<ul>
<li><b>eMail</b>. Sends an e-mail from Pandora's Server</li>
<li><b>Internal audit</b>. Writes the incident in Pandora's internal audit system</li>
<li><b>LogFile</b>. Writes the incident in the log file</li>
<li><b>SMS Text</b>. Sends an SMS to a given mobile phone</li>
<li><b>SNMP Trap</b>. Sends a SNMP Trap</li>
<li><b>Syslog</b>. Sends an alert to the Syslog</p>
</ul>
<p class="center"><img src="images/image011.png"></p>
<p>An Alert is deleted by clicking on the delete icon <img src="../../images/cancel.gif"> placed on the right hand side of the Alert. A new customised Alert can be created clicking in "Create Alert".</p>
<p>The values "<code>_field1_</code>", "<code>_field2_</code>" and "<code>_field3_</code>" in the customised Alerts are used to build the command line that the machine where Pandora resides will execute if there were several servers, the one in Master mode.</p>
<p class="center"><img src="images/image012.png"></p>
<p>When a new Alert is created the following field must be filled in:</p>
<ul>
<li><b>Alert name:</b> The name of the Alert</li>
<li><b>Command:</b> Command the Alert will trigger</li>
<li><b>Description:</b> Description of the Alert</li>
</ul>
<h4><a name="3222">3.2.2.2. Assigning Alerts</a></h4>
<p>The next step after an Agent has been added, its modules have been configurated and the alerts have been defined, it is time to assign those Alerts to the agent.</p>
<p>This is done by clicking on the Agent to be configured on the "Manage Agents" option, Administration menu. The Alert Assignation form is placed at the bottom of that page.</p>
<p><img src="images/image013.png"></p>
<p>To assign an Alert the next fields must be filled in:</p>
<ul>
<li><b>Alert type:</b> This can be selected from the list of alerts that have been previously generated.</li>
<li><b>Maximum Value:</b> Defines the maximum value for a module. Any value above that threshold will trigger the Alert.</li>
<li><b>Minimum Value:</b> Defines the minimum value for a module. Any value below that will trigger the Alert.</li>
<li><b>Description:</b> Describes the function of the Alert, and it is useful to identify the Alert amongst the others in the Alert General View.</li>
<li><b>Field #1 (Alias, name):</b> Define the used value for the "_field1_" variable.</li>
<li><b>Field #2 (Single Line):</b> Define the used value for the "_field2_" variable.</li>
<li><b>Field #3 (Full Text):</b> Define the used value for the "_field3_" variable.</li>
<li><b>Time threshold:</b> Minimum duration between the firing of two consecutive alerts, in seconds.</li>
<li><b>Max Alerts Fired:</b> Maximun number of alerts that can be sent consecutively.</li>
<li><b>Assigned module:</b> Module to be motitorized by the alert.</li>
</ul>
<p>All the alerts of an agent can be seen through "Manage Agents" in the Adminitration menu and selecting the agent.</p>
<h3><a name="323">3.2.3. Agent module and agent's alert management</a></h3>
<p>It might happen that the user finds that modules and alerts configured for an agent would be repeated in a new agent.</p>
<p>In order to simplify the administrator's job Pandora offers the option of copying modules and alerts defined in an agent to be assigned to another.</p>
<p>The screen is accessed through "Manage Agents"&gt;"Manage Config.", in the Administration menu:</p>
<p class="center"><img src="images/image014.png"></p>
<p>The Source Agent menu permits the selection of the agent where the needed modules and/or alerts reside. The "Get Info" button shows the modules for that agent in the Modules list box.</p>
<p><b><i>The copy process</i></b> is performed to copy the module and/or alert configuration from the selected source agents to the selected destination agents. Several agents can be selected, pressing CTRL and the mouse right button simultaneously. The two tick boxes at the top of the form will be used to specify if the configuration
to copy is from modules and/or from alerts.</p>
<p><b><i>The delete process</i></b> is performed to delete the configuration of the destination agents, in the multiple selection list box. Several agents can be selected at a time, and the tick boxes at the top of the
form indicate whether it is the modules or the alerts configuration what is to
be deleted. The application will prompt to confirm the deletion, as once
deletion is performed, the data associated to them will also be deleted.</p>
<h2><a name="33">3.3. Agent monitoring </a></h2>
<p>When the agents start the data transmission to the server, and it is added in the Web console, Pandora processes and inserts the data in the Database. The data are consolidated and can be accessed from the Web console, either as row data or as graphs.</p>
<h3><a name="331">3.3.1. Agent view</a></h3>
<p>All the Agents can be accessed from the Operation menu. From here the status of the agents can be quickly reviewed thanks to a simple system of bulbs and coloured circles.</p>
<p class="center"><img src="images/image015.png"></p>
<p>The list of agents shows all the relevant the information in the following columns:</p>
<p><b>Agent:</b> Shows the agent's name.</p>
<p><b>SO:</b> Displays an icon that represents the Operating System.</p>
<p><b>Interval:</b> Shows the time interval (seconds) in which the agent sends data to the server.</p>
<p><b>Group:</b> This is the group the agent belongs to.</p>
<p><b>Modules:</b> Under normal circumstances this field shows the values representing the
number of modules and the number of monitors, both in black. If the status of a
monitor changes to "incorrect", one additional number is shown: the number of
modules, the number of monitors and the number of monitors with "incorrect" status, all in black save the last one.</p>
<p><b>Status:</b> Shows the "general" status of the agent through the following icons:</p>
<div class='ml35'>
<p><img src="../../images/b_green.gif"> All the monitors OK. It's the ideal status.</p>
<p><img src="../../images/b_white.gif"> No defined monitors. Sometimes nothing is monitored
that could be right or wrong, and only numeric or text data is reported.</p>
<p><img src="../../images/b_red.gif"> At least one of the monitors is failing. Usually we
want to avoid this, and keep our systems in a healthy green colour.</p>
<p><img src="../../images/b_blue.gif"> The agent doesn't have <u>any</u> data. New agents with an empty data
package can have this status.</p>
<p><img src="../../images/b_yellow.gif"> Colour shifting from green to red. This icon indicates
that the agent has just changed its status, from 'All OK' to 'we have a problem'.</p>
<img src="../../images/b_down.gif"> When an agent is down or there is no news from it for 2 times the Interval value in seconds. Usually it is due to a communication issue or a crashed remote system.</p>
</div>
<p><b>Alerts:</b> Shows if any alerts have been sent through the following icons:</p>
<div class='ml35'>
<p><img src="../../images/dot_green.gif"> No alerts have been sent.</p>
<p><img src="../../images/dot_red.gif"> When at least one alert has been sent within the time threshold of the alert.</p>
</div>
<p><b>Last contact:</b> Shows the time and date of the last data package sent by the agent.</p>
<p><b><u>Note:</u></b> The icon <img src="../../images/setup.gif" width="15"> is only visible if you're and administrator and it's a link to the "Manage Agents" &gt; "Update Agent" option in the Administration menu.</p>
<h3><a name="332">3.3.2. Accessing the data of an agent</a></h3>
<p>When an agent is accessed, by clicking on its name, all the information related to that agent is displayed.</p>
<h4><a name="3321">3.3.2.1. Agent general info</a></h4>
<p>This shows the data introduced when the agent was created and the total number a data packages the agent has sent.</p>
<p class="center"><img src="images/image016.png"></p>
<h4><a name="3322">3.3.2.2. Last data received</a></h4>
<p>This is the description of all the agent modules been monitored.</p>
<p><img src="images/image017.png"></p>
<p>In this list the module information is shown in the following columns:</p>
<p><b>Module name:</b> Name given to the module in the agent's config file.</p>
<p><b>Module type:</b> Type of module as described in <a href="#321">section 3.2.1</a>.</p>
<p><b>Description:</b> Description given to the module in the agent's config file.</p>
<p><b>Data:</b> Last data sent by the agent.</p>
<p><b>Graph:</b> Monthly(M), Weekly(W), Daily(D) and Hourly(H) graphs are generated with
the data sent by the agent against time.</p>
<p>On the left hand side of the graph the newst data is represent, and on the right had side the oldest.</p>
<p>The generated graphs are:
<p class="ml75"> - <b>Hourly graph</b> (<img src="../../images/grafica_h.gif">) covers a 60 minute interval</p>
<p class="center"><img src="images/image018.png"></p>
<p class="ml75"> - <b>Daily graph</b> (<img src="../../images/grafica_d.gif">) covers a 24 hour interval</p>
<p class="center"><img src="images/image019.png"></p>
<p class="ml75"> - <b>Weekly graph</b> (<img src="../../images/grafica_w.gif">) covers a 7 day interval</p>
<p class="center"><img src="images/image020.png"></p>
<p class="ml75"> - <b>Mothly graph</b> (<img src="../../images/grafica_m.gif">) covers a 30 day interval</p>
<p class="center"><img src="images/image021.png"></p>
<p><b>Raw Data:</b> This is the raw data sent by the agent</p>
<p class="ml25"> - <img src="../../images/data_m.gif"> Last month</p>
<p class="ml25"> - <img src="../../images/data_w.gif"> Last week</p>
<p class="ml25"> - <img src="../../images/data_d.gif"> Last day</p>
<h4><a name="3323">3.3.2.3. Complete list of monitors</a></h4>
<p>This is the description of all the monitors defined by the agent</p>
<p class="center"><img src="images/image022.png"></p>
<p>The list shows the information about the monitors in the following columns:</p>
<p><b>Agent:</b> Agent where the monitor is defined.</p>
<p><b>Type:</b> Data type of the monitor. For a monitor this value is always of the generic_proc type.</p>
<p><b>Module name:</b> Name given to the module when it was created.</p>
<p><b>Description:</b> Description given to the module in the agent's config file.</p>
<p><b>Status:</b> The table shows the agent status through the following icons:</p>
<p class="ml25"><img src="../../images/b_green.gif"> The monitor is OK</p>
<p class="ml25"><img src="../../images/b_red.gif"> The monitor is failing</p>
<p><b>Last contact:</b> Shows the time and date of the last data packaged received from the agent</p>
<h4><a name="3324">3.3.2.4. Complete list of alerts</a></h4>
<p>This is the description of all the alarms defined in the agent</p>
<p class="center"><img src="images/image023.png"></p>
<p>The monitor information is shown in the list divided in the following fields:</p>
<p><b>ID:</b> Agent were the alert has been defined.</p>
<p><b>Type:</b> Type of alert.</p>
<p><b>Description:</b> Description given to the alert when it was created.</p>
<p><b>Last fired:</b> The last time the alert was executed.</p>
<p><b>Times Fired:</b> Number of times the alert was launched.</p>
<p><b>Status:</b> Shows if the alert has been sent through the following icon:</p>
<p class="ml25"><img src="../../images/dot_green.gif"> No alerts have been sent</p>
<p class="ml25"><img src="../../images/dot_red.gif"> At least one alert has been sent</p>
<h3><a name="333">3.3.3. Group details</a></h3>
<p>The groups configured in Pandora can be
accessed through "View Agents"&gt;"Group detail" in the Operation menu. The group
details can be reviewed quikly thanks to a system of coloured bulbs.</p>
<p class="center"><img src="images/image025.png"></p>
The groups are displayed ordered by the following columns:</p>
<p><b>Groups:</b> Name of the group</p>
<p><b>Agents:</b> Number of agents configured in the group.</p>
<p><b>Monitors:</b> Number of monitors configured in the group.</p>
<p><b>Status:</b> The status is described through the following icons:</p>
<p class="ml25"><img src="../../images/b_green.gif"> All monitors are OK.</p>
<p class="ml25"><img src="../../images/b_red.gif"> At least one monitor has failed.</p>
<p class="ml25"><img src="../../images/b_down.gif"> At least one monitor is down and there is no contact with it.</p>
<p class="ml25"><img src="../../images/b_white.gif"> This Agent doesn't have any monitor defined.</p>
<p><b>OK:</b> Number of monitors that are OK.</p>
<p><b>Failed:</b> Number of failing monitors.</p>
<p><b>Down:</b> Number of down monitors.</p>
<h3><a name="334">3.3.4. Monitors view</a></h3>
<p>The description of all the monitors defined in the server can be viewed from the "View Agents"&gt;"Monitor detail" option in the Operation menu.</p>
<p class="center"><img src="images/image026.png"></p>
<p>In this list all the monitors appear in a similar way as in the individual view, but now they are shown all together. This allows a deeper analisys of each monitor.</p>
<h3><a name="335">3.3.5. Alert details</a></h3>
<p>The description of all the alerts defined in the server can be viewed from the "View Agents"&gt;"Alert Details" option in Operation menu.</p>
<p class="center"><img src="images/image027.png"></p>
<p>In this list all the alerts appear in a similar way as in the individual view, but now they are shown all together. This allows a deeper analisys of each alert.</p>
<h3><a name="336">3.3.6. Data Export</a></h3>
<p>The Data Export tool can be found in the "View Agents"&gt;"Export data" option in the Operation Menu.</p>
<p>Three parameters need to be configured for exporting data: the agent where data resides, the modules to be exported and the date interval of the data to be exported:</p>
<p class="center"><img src="images/image028.png"></p>
<p>The fields in the results of Exporting data are:</p>
<p><b>Module:</b> Module name.</p>
<p><b>Data:</b> Data contained by the module.</p>
<p><b>Timestamp:</b> Date and time of the the package was sent by the agent.</p>
<p class="center"><img src="images/image029.png"></p>
<p>Selecting the CSV format for the output, a text
file with extension <b>.csv</b> is be created. The data is qualified by single quotes
and the fields separated by commas:</p>
<p class="center"><img src="images/image030.png"></p>
<h3><a name="337">3.3.7. Statistics</a></h3>
<p>Two kinds of graphical statistics are displayed from the "View Agents"&gt;"Statistics" option, in the Operation menu:</p>
<ul>
<li>A graph with the number of modules configurated for each agents,</li>
<li>A graph with number of packages sent by each Agent. A package is the number of
values from the modules the agent sends after each time interval.</li>
</ul>
<p class="center"><img src="images/image031.png"></p>
<p class="center"><img src="images/image032.png"></p>
<p class="center"><img src="images/image033.png"></p>
</body>
</html>

View File

@ -0,0 +1,192 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - The Free Monitoring System Help - IV. Incident Management</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
.ml25 {margin-left: 25px;}
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
</head>
<body>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Pandora Help v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap3.php">3. Agents</a> « <a href="toc.php">Table of Contents</a> » <a href="chap5.php">5. Events</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora is a GPL Software Project. &copy; Sancho Lerena 2003-2005, David villanueva 2004-2005, Alex Arnal 2005, Ra&uacute;l Mateos 2004-2005.</p>
</div>
<a name="4"><h1>4. Incident management</h1></a>
<p>The system monitoring process needs to follow up the incidents arising in the system besides receiving and processing the data to be monitored in each time interval</p>
<p>Pandora uses a tool called Incident Manager for this task, where each user can open an incident, where a description of what happened in the network is shown. This can be completed with comments and files
when necessary.</p>
<p>This system is designed for group work. Different roles and workflow systems permit to move incidents from one group to another. The system allows different groups and different users to work on
the same incident, sharing information and files.</p>
<p>Clicking on "Manage Incidents", in the Operation menu, a list showing all the incidents is displayed, ordered by the date-time they were last updated. Filters can be applied to display only those
incidents the user is interested on.</p>
<p class="center"><img src="images/image034.png"></p>
<p>The filters that can be applied are:</p>
<ul>
<li><b>Incident status filter</b>. The user can display:
<p class="ml25">- All incidents</p>
<p class="ml25">- Active incidents</p>
<p class="ml25">- Closed incidents</p>
<p class="ml25">- Rejected incidents</p>
<p class="ml25">- Expired incidents</p>
</li>
<li>
<b>Property filter</b>. The incidents are shown by:
<p class="ml25">- All priorities</p>
<p class="ml25">- Informative priority</p>
<p class="ml25">- Low priority</p>
<p class="ml25">- Medium priority</p>
<p class="ml25">- High priority</p>
<p class="ml25">- Very high priority</p>
<p class="ml25">- Maintenance</p>
</li>
<li><b>Group filter</b>. It can be selected to display just the incidents of a given Pandora group.</li>
</ul>
<br>
<p>The incident list is displayed showing information in the following columns:</p>
<p><b>ID:</b> ID of the incident.</p>
<p><b>Status:</b> The incident status is represented by the following icons:</p>
<p class="ml25"><img src="../../images/dot_red.gif"> Active incident</p>
<p class="ml25"><img src="../../images/dot_yellow.gif"> Active incident with comments</p>
<p class="ml25"><img src="../../images/dot_blue.gif"> Rejected incident</p>
<p class="ml25"><img src="../../images/dot_green.gif"> Closed incident</p>
<p class="ml25"><img src="../../images/dot_white.gif"> Expired incident</p>
<p><b>Incident name:</b> Name given to the incident</p>
<p><b>Priority:</b> The incident assigned priority is represented by the following icons:</p>
<p class="ml25"><img src="../../images/dot_red.gif"><img src="../../images/dot_red.gif"><img src="../../images/dot_red.gif"> Very high priority</p>
<p class="ml25"><img src="../../images/dot_yellow.gif"><img src="../../images/dot_red.gif"><img src="../../images/dot_red.gif"> High priority</p>
<p class="ml25"><img src="../../images/dot_yellow.gif"><img src="../../images/dot_yellow.gif"><img src="../../images/dot_red.gif"> Medium priority</p>
<p class="ml25"><img src="../../images/dot_green.gif"><img src="../../images/dot_yellow.gif"><img src="../../images/dot_yellow.gif"> Low priority</p>
<p class="ml25"><img src="../../images/dot_green.gif"><img src="../../images/dot_green.gif"><img src="../../images/dot_yellow.gif"> Informative priority</p>
<p class="ml25"><img src="../../images/dot_green.gif"><img src="../../images/dot_green.gif"><img src="../../images/dot_green.gif"> Maintenance priority</p>
<p><b>Group:</b> The name of the group the incident has been assigned to. One incident can only belong to a single group.</p>
<p><b>Updated at:</b> This is the date/time the incident was updated for the last time.</p>
<p><b>Source:</b> The source of the incident. The source is selected from a list stored
in the data base. This list can only be modified by the database base
administrator.</p>
<p><b>Owner:</b> User to whom the incident has been assigned to. It doesn't coinced
with the creator of the incident, as the incident may have been moved from one
user to another. The incident can be assigned to another user by its owner, or
by a user with management privileges over the group the incidents belong to.</p>
<h2><a name="41">4.1. Adding an incident</a></h2>
<p>The creation of incidents is performed by clicking on "Manage Incidents" &gt; "New incident", in the Operation menu</p>
<p class="center"><img src="images/image035.png"></p>
<p>The "Create Incident" form will come up, containing the necessary fields to define the incident. The process is completed by clicking on the 'Create' button.</p>
<h2><a name="42">4.2. Incident follow up</a></h2>
<p>All the open incidents can be followed up. The tool is reached by clicking on the "Manage Incidents" option, in the Operation menu.</p>
<p>The indicent is selected by clicking on its name in the "Incident name" column.</p>
<p>The screen coming up shows us the configuration variables of the incident, its comments and attached files.</p>
<p>The first part of the screen contains the Incident configuration.</p>
<p class="center"><img src="images/image036.png"></p>
<p>From this form the following values can be updated:</p>
<ul>
<li><b>Incident name</b></li>
<li><b>Incident owner</b></li>
<li><b>Incident status</b></li>
<li><b>Incident source</b></li>
<li><b>Group the indicent will belong to</b></li>
<li><b>Indicent priority</b></li>
</ul>
<p>The indicent is updated by clicking on the "Update incident" button.</p>
<h3><a name="421">4.2.1. Adding comments to an incident</a></h3>
<p> Comments about the incident can added clicking on "Add note". This will open up a screen with a text box in it.</p>
<p class="center"><img src="images/image037.png"></p>
<p>The comment is written in this box. The Comment will appear in the "Notes attached to incident" section after the button "Add" is pressed.</p>
<p class="center"><img src="images/image038.png"></p>
<p>Only users with writting privilieges can add a comment, and only the owners of the incident or of the notes can delete them.</p>
<h3><a name="422">4.2.2. Attaching files to an incident</a></h3>
<p>Sometimes it is necessary to link an incident with an image, a configuration file, or any kind of file.</p>
<p>The files are attached in the "Attach file" section. Here the file can be searched for in the local machine and attached when the "Upload" button is pressed.</p>
<p>Only a user with writing privileges can attach a file, and only the owner of the incident or of the file can delete it.</p>
<p class="center"><img src="images/image039.png"></p>
<p>The incident follow up screen shows all the files attached to the incident in the "Attached files" section of the screen.</p>
<p class="center"><img src="images/image040.png"></p>
<h2><a name="43">4.3. Searching for an incident</a></h2>
<p>A specific incident can be found amongst the
incidents created in Pandora by either using a filter as explained in the
first section of this chapter - or by making a query using the "Manage Incidents"&gt;"Searh Incident" tool, in the Operation menu.</p>
<p class="center"><img src="images/image041.png"></p>
<p>Any text string included as a sub-string in the
incident can be searched for using this tool. This search engine looks for the
string in the Incident title as well as in the text contained by the incident.
The search engine will not search neither the Comments added to the agent nor
the attached files. The search can be performed in addition to group, priority
or status filters.</p>
<h2><a name="44">4.4. Statistics</a></h2>
<p>The incident statisticts are shown in the "Manage Incidents"&gt;"Statistics" option of the Operation menu. They can be of five different types:</p>
<ul>
<li><b>Incident status</b></li>
<li><b>Incident priority</b></li>
<li><b>Users with the incident opened</b></li>
<li><b>Incidents by group</b></li>
<li><b>Incident source</b></li>
</ul>
<p class="center">
<img src="images/image042.png"><br>
<img src="images/image043.png"><br>
<img src="images/image044.png"><br>
</p>
</body>
</html>

View File

@ -0,0 +1,82 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - The Free Monitoring System Help - V. Events</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
.ml25 {margin-left: 25px;}
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
</head>
<body>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Pandora Help v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap4.php">4. Incident Management</a> « <a href="toc.php">Table of Contents</a> » <a href="chap6.php">6. System Audit</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora is a GPL Software Project. &copy; Sancho Lerena 2003-2005, David villanueva 2004-2005, Alex Arnal 2005, Ra&uacute;l Mateos 2004-2005.</p>
</div>
<a name="5"><h1>5. Events</h1></a>
<p>An event in Pandora is any unusual change happend in an agent.</p>
<p>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.</p>
<p>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.</p>
<p>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.</p>
<p class="center"><img src="images/image045.png"></p>
<br>
<p>The event information list shows the data in the following columns:</p>
<p><b>Status:</b> The event status is represented by the icon bellow:</p>
<p class="ml25"><img src="../../images/dot_green.gif"> The event has been validated</p>
<p class="ml25"><img src="../../images/dot_red.gif"> The event hasn't been validated</p>
<p><b>Event name:</b> Name assigned to the event by Pandora.</p>
<p><b>Agent name:</b> Agent where the event happend.</p>
<p><b>Group name:</b> Group of the agent where the event has happened.</p>
<p><b>User ID: </b>User that validated the event.</p>
<p><b>Timestamp:</b> Date and time when the event was raised or validated- if it has been validated.</p>
<p><b>Action:</b> Action that can be executed over the event.</p>
<p class="ml25"><img src="../../images/ok.gif"> This icon will validate the event, disappearing the icon</p>
<p class="ml25"><img src="../../images/cancel.gif"> This icon will delete the event</p>
<p>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.</p>
<h2><a name="51">5.1. Statistics</a></h2>
<p>Three different kinds of graphical statistic representation can be choosen from the "View Events"&gt;"Statistics" option in the Operation menu:</p>
<ul>
<li>Total number of events divided by revised and not revised
<p class="center"><img src="images/image046.png"></p>
</li>
<li>Total events divided by the users who validated the events
<p class="center"><img src="images/image047.png"></p>
</li>
<li>Total events divided by the group the agent raising the event belongs to
<p class="center"><img src="images/image048.png"></p>
</li>
</ul>
</body>
</html>

View File

@ -0,0 +1,67 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - The Free Monitoring System Help - VI. System Audit</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
</head>
<body>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Pandora Help v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap5.php">5. Events</a> « <a href="toc.php">Table of Contents</a> » <a href="chap7.php">7. Server Configuration</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora is a GPL Software Project. &copy; Sancho Lerena 2003-2005, David villanueva 2004-2005, Alex Arnal 2005, Ra&uacute;l Mateos 2004-2005.</p>
</div>
<a name="6"><h1>6. System audit</h1></a>
<p>The Pandora's system audit shows all the actions performed by each user, as well as the failed logins.</p>
<p>In the actual version of Pandora the system
audit includes actions that somehow try to by pass the security system:
attempts to delete an incident by an unauthorised user, attemps to change user
profiles by unauthoried users, etc. Its main function is, however, to trace the
user connections (login/logout).</p>
<p>The audit Logs can be found in the System Audit option of the Administration menu, ordered chronologicly.</p>
<p>Filters can be applied to the Logs displayed to show only those of interest for the user, selected by the action the Log produces.</p>
<p>The selectable actions are those actions stored in the Data Base at that time.</p>
<p class="center"><img src="images/image049.png"></p>
<p>The following fields display the Audit Logs information:</p>
<p><b>User:</b> User that triggerd the event (SYSTEM isspecial user of the system).</p>
<p><b>Action:</b> Action generated by the entry in the log.</p>
<p><b>Date:</b> Date of the entry in the log.</p>
<p><b>Source IP:</b> IP of the machine or the agent that provoked the entry.</p>
<p><b>Comment:</b> Comment describing the entry</p>
<h2><a name="61">6.1. Statistics</a></h2>
<p>There isn't a special section to view system audit statistics. However, we could use a graph generated in the Users section to evaluate the actions of each user, as this graph would represent the total
number of entries in the audit log for each one: the more active the user is the higher the number of entries.</p>
<p>The graph will also show entries of invalid users, i.e., those entries generated by failed attemps to log in.</p>
<p class="center"><img src="images/image050.png"></p>
</body>
</html>

View File

@ -0,0 +1,68 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - The Free Monitoring System Help - VII. Server Configuration</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
</head>
<body>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Pandora Help v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap6.php">6. System audit</a> « <a href="toc.php">Table of Contents</a> » <a href="chap8.php">8. Database maintenance</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora is a GPL Software Project. &copy; Sancho Lerena 2003-2005, David villanueva 2004-2005, Alex Arnal 2005, Ra&uacute;l Mateos 2004-2005.</p>
</div>
<a name="7"><h1>7. Server Configuration</h1></a>
<p>All the configurable parameters in Pandora can be set in the "Pandora Setup" section, in the Administration menu.</p>
<p class="center"><img src="images/image051.png"></p>
These parameters are:</p>
<p><b>Language:</b> In following versions or revisions of the actual Pandora version will support more languages. At the moment version 1.1 only supports English, Spanish, Euskera and Bable.</p>
<p><b>Page block size:</b> Maximum size of the lists in the event, incident and audit log sections.</p>
<p><b>Max. days before compact data:</b> This parameter controls data compacting. From the
number of days in this parameter the data starts getting compacted. For large
amounts of data it is recommended to set this parameter to a number between 14
and 28; for systems with less data load or very powerful systems, a number
between 30 and 50 will be enough.</p>
<p><b>Max. days before purge:</b> This parameter controls how long the data is kept
before it is permanently deleted. The recommended value is 60. For systems with
little resources or large work load the recommended value is between 40 and 50.</p>
<p><b>Graphic resolution (1 low, 5 high):</b> This value represents the precision of the
interpolation logarithm to generate the graphics.</p>
<p><b>Compact interpolation (Hours: 1 fine, 10 medium, 20 bad):</b> This is the grade of compression used to compact the Data Base, being 1 the lowest compression rate and 20 the highest. A value above 12 means a considerable data loss. It's not recommended to use value above 6 if the data needs to be
represented graphically in large time intervals.</p>
<h2><a name="71">7.1. Links</a></h2>
<p>Links to different Internet or private network links can be configured in Pandora. These could be search engines, applications or company Intranets.</p>
<p>The links configured in Pandora can be edited through the "Pandora Setup"&gt;"Links" option in the Administration menu.</p>
<p class="center"><img src="images/image052.png"></p>
<p>A new link is created by clicking on "Create".The link can be then edited:</p>
<p class="center"><img src="images/image053.png"></p>
</body>
</html>

View File

@ -0,0 +1,144 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - The Free Monitoring System Help - VIII. Database maintenance</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
</head>
<body>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Pandora Help v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap7.php">7. Server Configuration</a> « <a href="toc.php">Table of Contents</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora is a GPL Software Project. &copy; Sancho Lerena 2003-2005, David villanueva 2004-2005, Alex Arnal 2005, Ra&uacute;l Mateos 2004-2005.</p>
</div>
<a name="8"><h1>8. Database Maintenance</h1></a>
<p>The core of Pandora's system is its Database. All the data collected by the monitored
machines is stored in this data base, from the administrator's data, to the
events, incidents and audit data generated in the system at any time.</p>
<p>It is obvious that the efficiency and reliability of this module is vital for the correct functioning of Pandora. A regular data base maintainance is needed. To do so the data base managers can
use standard MySQL commands. Pandora is not a data administration tool, but
maintaining its database in good condition is critital for Pandora to work properly.</p>
<p>As the database size will increase linearly, the data will be compacted to reduce the amount of stored data without loosing important information, specially the different graphs that are generated with
the processed data.</p>
<p>On "DB Maintenance" from the Administration menu we will find the Database configuration defined in the
"Pandora Setup" option of the Administration menu to compact and delete data.</p>
<p class="center"><img src="images/image054.png"></p>
<h2><a name="81">8.1. DB Information</a></h2>
<p>The DB statistics are generated by Agent, on the "DB Maintenance"&gt;"DB Information" in the Administration menu, and are represented in two kinds of graphs:</p>
<ul>
<li>Number of modules configured for each of the agents.</li>
<li>Number of packages sent by each agent. A package is the group of data linked to the module the agent sends in each interval of time.</li>
</ul>
<p class="center">
<img src="images/image055.png"><br>
<img src="images/image056.png"><br>
<img src="images/image057.png"><br>
</p>
These graphs can be also viewed from "View Agents"&gt;"Statistics" in the Operation menu.</p>
<h2><a name="82">8.2. Manual purge of the Datadase</a></h2>
<p>Pandora counts with powerful tools for the
Administrator to manually purge the majority of data stored in the Database.
This includes data generated by both the agents and the own server.</p>
<h2><a name="83">8.3. Agent's data purge</a></h2>
<h3><a name="831">8.3.1. Debuging selected data from a module</a></h3>
<p>The option of purging selected data from a module is used to eliminate those out of range entries, whatever the reason agent failure, out of range values, testing, DB errors, etc. Eliminating erroneous, incorrect or unnecessary data makes the graphical representation more acuarate and shows the data without peaks or unreal scales.</p>
<p>From "DB Maintenance"&gt;"Database Debug" in the Administration menu any of the out of range data received from a agent's module can be deleted.</p>
<p class="center"><img src="images/image058.png"></p>
<p>The purge settings are: agent, module, minimum and maximum data range. Any parameter out of this minimum/maximum range will be deleted.</p>
<p>For example, in a module registering the number of processes, if we are only interested in values between 0 and 100, any values above that number will be usually produced by errors, noise or abnormal
circumstances. If we set to range between 0 and 100 all those values below and above - such as -1, 100 or 100000 - will be permanently deleted from the database.</p>
<h3><a name="832">8.3.2. Purging all the agent's data</a></h3>
<p>All the out of range data received by an agent can be deleted from the "DB Maintainance"&gt;"Database Purge" option in the Administration menu.</p>
<p>The data is deleted by the following parameters from the "Delete data" screen:</p>
<ul>
<li>Purge all data</li>
<li>Purge data over 90 days</li>
<li>Purge data over 30 days</li>
<li>Purge data over 14 days</li>
<li>Purge data over 7 days</li>
<li>Purge data over 3 days</li>
<li>Purge data over 1 day</li>
</ul>
<p class="center"><img src="images/image059.png"></p>
<h2><a name="84">8.4.Purging system data</a></h2>
<h3><a name="841">8.4.1. Audit data purge</a></h3>
<p>All the audit data generated by the system can be deleted from "DB Maintenance"&gt;"Database Audit", in the Administration menu</p>
<p>The data to be deleted is selected by setting the following parameters in the "Delete Data" screen</p>
<ul>
<li>Purge audit data over 90 days</li>
<li>Purge audit data over 30 days</li>
<li>Purge audit data over 14 days</li>
<li>Purge audit data over 7 days</li>
<li>Purge audit data over 3 days</li>
<li>Purge audit data over 1 day</li>
<li>Purge all audit data</li>
</ul>
<p class="center"><img src="images/image060.png"></p>
<h3><a name="842">8.4.2. Event data purge</a></h3>
<p>All the event data generated by the system can be deleted from "DB Maintenance"&gt;"Database Event", in the Administration menu</p>
<p>The data to be deleted is selected by setting the following parameters in the "Delete Data" screen</p>
<ul>
<li>Purge event data over 90 days</li>
<li>Purge event data over 30 days</li>
<li>Purge event data over 14 days</li>
<li>Purge event data over 7 days</li>
<li>Purge event data over 3 days</li>
<li>Purge event data over 1 day</li>
<li>Purge all event data</li>
</ul>
<p class="center"><img src="images/image061.png"></p>
</body>
</html>

View File

Before

Width:  |  Height:  |  Size: 111 KiB

After

Width:  |  Height:  |  Size: 111 KiB

View File

Before

Width:  |  Height:  |  Size: 40 KiB

After

Width:  |  Height:  |  Size: 40 KiB

View File

Before

Width:  |  Height:  |  Size: 49 KiB

After

Width:  |  Height:  |  Size: 49 KiB

View File

Before

Width:  |  Height:  |  Size: 40 KiB

After

Width:  |  Height:  |  Size: 40 KiB

View File

Before

Width:  |  Height:  |  Size: 30 KiB

After

Width:  |  Height:  |  Size: 30 KiB

View File

Before

Width:  |  Height:  |  Size: 20 KiB

After

Width:  |  Height:  |  Size: 20 KiB

View File

Before

Width:  |  Height:  |  Size: 18 KiB

After

Width:  |  Height:  |  Size: 18 KiB

View File

Before

Width:  |  Height:  |  Size: 22 KiB

After

Width:  |  Height:  |  Size: 22 KiB

View File

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 11 KiB

View File

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

View File

Before

Width:  |  Height:  |  Size: 30 KiB

After

Width:  |  Height:  |  Size: 30 KiB

View File

Before

Width:  |  Height:  |  Size: 13 KiB

After

Width:  |  Height:  |  Size: 13 KiB

View File

Before

Width:  |  Height:  |  Size: 18 KiB

After

Width:  |  Height:  |  Size: 18 KiB

View File

Before

Width:  |  Height:  |  Size: 20 KiB

After

Width:  |  Height:  |  Size: 20 KiB

View File

Before

Width:  |  Height:  |  Size: 58 KiB

After

Width:  |  Height:  |  Size: 58 KiB

View File

Before

Width:  |  Height:  |  Size: 20 KiB

After

Width:  |  Height:  |  Size: 20 KiB

View File

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

View File

Before

Width:  |  Height:  |  Size: 6.7 KiB

After

Width:  |  Height:  |  Size: 6.7 KiB

View File

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 14 KiB

View File

Before

Width:  |  Height:  |  Size: 10 KiB

After

Width:  |  Height:  |  Size: 10 KiB

View File

Before

Width:  |  Height:  |  Size: 16 KiB

After

Width:  |  Height:  |  Size: 16 KiB

View File

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

View File

Before

Width:  |  Height:  |  Size: 17 KiB

After

Width:  |  Height:  |  Size: 17 KiB

View File

Before

Width:  |  Height:  |  Size: 26 KiB

After

Width:  |  Height:  |  Size: 26 KiB

View File

Before

Width:  |  Height:  |  Size: 20 KiB

After

Width:  |  Height:  |  Size: 20 KiB

View File

Before

Width:  |  Height:  |  Size: 26 KiB

After

Width:  |  Height:  |  Size: 26 KiB

View File

Before

Width:  |  Height:  |  Size: 18 KiB

After

Width:  |  Height:  |  Size: 18 KiB

View File

Before

Width:  |  Height:  |  Size: 16 KiB

After

Width:  |  Height:  |  Size: 16 KiB

View File

Before

Width:  |  Height:  |  Size: 18 KiB

After

Width:  |  Height:  |  Size: 18 KiB

View File

Before

Width:  |  Height:  |  Size: 2.6 KiB

After

Width:  |  Height:  |  Size: 2.6 KiB

View File

Before

Width:  |  Height:  |  Size: 7.2 KiB

After

Width:  |  Height:  |  Size: 7.2 KiB

View File

Before

Width:  |  Height:  |  Size: 6.6 KiB

After

Width:  |  Height:  |  Size: 6.6 KiB

View File

Before

Width:  |  Height:  |  Size: 53 KiB

After

Width:  |  Height:  |  Size: 53 KiB

View File

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

View File

Before

Width:  |  Height:  |  Size: 24 KiB

After

Width:  |  Height:  |  Size: 24 KiB

View File

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 14 KiB

View File

Before

Width:  |  Height:  |  Size: 17 KiB

After

Width:  |  Height:  |  Size: 17 KiB

View File

Before

Width:  |  Height:  |  Size: 6.0 KiB

After

Width:  |  Height:  |  Size: 6.0 KiB

View File

Before

Width:  |  Height:  |  Size: 8.3 KiB

After

Width:  |  Height:  |  Size: 8.3 KiB

View File

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 12 KiB

View File

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 12 KiB

View File

Before

Width:  |  Height:  |  Size: 4.9 KiB

After

Width:  |  Height:  |  Size: 4.9 KiB

View File

Before

Width:  |  Height:  |  Size: 9.7 KiB

After

Width:  |  Height:  |  Size: 9.7 KiB

View File

Before

Width:  |  Height:  |  Size: 45 KiB

After

Width:  |  Height:  |  Size: 45 KiB

View File

Before

Width:  |  Height:  |  Size: 5.2 KiB

After

Width:  |  Height:  |  Size: 5.2 KiB

View File

Before

Width:  |  Height:  |  Size: 6.1 KiB

After

Width:  |  Height:  |  Size: 6.1 KiB

View File

Before

Width:  |  Height:  |  Size: 6.3 KiB

After

Width:  |  Height:  |  Size: 6.3 KiB

View File

Before

Width:  |  Height:  |  Size: 38 KiB

After

Width:  |  Height:  |  Size: 38 KiB

View File

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 12 KiB

View File

Before

Width:  |  Height:  |  Size: 13 KiB

After

Width:  |  Height:  |  Size: 13 KiB

View File

Before

Width:  |  Height:  |  Size: 9.3 KiB

After

Width:  |  Height:  |  Size: 9.3 KiB

View File

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 11 KiB

View File

Before

Width:  |  Height:  |  Size: 29 KiB

After

Width:  |  Height:  |  Size: 29 KiB

View File

Before

Width:  |  Height:  |  Size: 2.7 KiB

After

Width:  |  Height:  |  Size: 2.7 KiB

View File

Before

Width:  |  Height:  |  Size: 7.4 KiB

After

Width:  |  Height:  |  Size: 7.4 KiB

View File

Before

Width:  |  Height:  |  Size: 6.5 KiB

After

Width:  |  Height:  |  Size: 6.5 KiB

View File

Before

Width:  |  Height:  |  Size: 15 KiB

After

Width:  |  Height:  |  Size: 15 KiB

View File

Before

Width:  |  Height:  |  Size: 19 KiB

After

Width:  |  Height:  |  Size: 19 KiB

View File

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 12 KiB

View File

Before

Width:  |  Height:  |  Size: 12 KiB

After

Width:  |  Height:  |  Size: 12 KiB

View File

@ -0,0 +1,91 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - The Free Monitoring System Help - Table Of Contents</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
dd.help_t1 {margin-left: 10px; margin-top: 6px; margin-bottom: 5px; font-size: 13px; font-weight: bold}
dd.help_t2 {margin-left: 28px; margin-top: 3px;}
dd.help_t3 {margin-left: 55px; margin-top: 4px;}
dd.help_t4 {margin-left: 92px; margin-top: 3px; margin-bottom: 2px;}
</style>
</head>
<body>
<center>
<img src="../../images/logo_menu.gif" alt='logo'>
<p><h1>Pandora Help v1.2</h1></p>
<p>(Updated March, 05<sup>th</sup> 2006).</p>
<p>Pandora is a GPL Software Project. <br>&copy; Sancho Lerena 2003-2006, David Villanueva 2004-2006, Alex Arnal 2005 and Ra&uacute;l Mateos 2004-2006.</p>
</center>
<br>
<h1>Table of Contents</h1>
<dl>
<dd class="help_t1"><a href="chap1.php#1"><h1>1. Introduction</h1></a></dd>
<dd class="help_t2"><a href="chap1.php#11">1.1. Pandora Administration</a></dd>
<dd class="help_t1"><a href="chap2.php#2"><h1>2. Users</h1></a></dd>
<dd class="help_t2"><a href="chap2.php#21">2.1. Profile manager</a></dd>
<dd class="help_t2"><a href="chap2.php#22">2.2. Adding a user</a></dd>
<dd class="help_t2"><a href="chap2.php#23">2.3. Deleting a user</a></dd>
<dd class="help_t2"><a href="chap2.php#24">2.4. Statistics</a></dd>
<dd class="help_t1"><a href="chap3.php#3"><h1>3. Agents</h1></a></dd>
<dd class="help_t2"><a href="chap3.php#31">3.1. Group Manager</a></dd>
<dd class="help_t2"><a href="chap3.php#32">3.2. Adding an agent</a></dd>
<dd class="help_t3"><a href="chap3.php#321">3.2.1. Assigning modules</a></dd>
<dd class="help_t3"><a href="chap3.php#322">3.2.2. Alerts</a></dd>
<dd class="help_t4"><a href="chap3.php#3221">3.2.2.1. Adding an Alert</a></dd>
<dd class="help_t4"><a href="chap3.php#3222">3.2.2.2. Assigning Alerts</a></dd>
<dd class="help_t3"><a href="chap3.php#323">3.2.3. Agent module and agent's alert management</a></dd>
<dd class="help_t2"><a href="chap3.php#33">3.3. Agent monitoring</a></dd>
<dd class="help_t3"><a href="chap3.php#331">3.3.1. Agent view</a></dd>
<dd class="help_t3"><a href="chap3.php#332">3.3.2. Accessing the data of an agent</a></dd>
<dd class="help_t4"><a href="chap3.php#3321">3.3.2.1. Agent general info</a></dd>
<dd class="help_t4"><a href="chap3.php#3322">3.3.2.2. Last data received</a></dd>
<dd class="help_t4"><a href="chap3.php#3323">3.3.2.3. Complete list of monitors</a></dd>
<dd class="help_t4"><a href="chap3.php#3324">3.3.2.4. Complete list of alerts</a></dd>
<dd class="help_t3"><a href="chap3.php#333">3.3.3. Group details</a></dd>
<dd class="help_t3"><a href="chap3.php#334">3.3.4. Monitors view</a></dd>
<dd class="help_t3"><a href="chap3.php#335">3.3.5. Alert details</a></dd>
<dd class="help_t3"><a href="chap3.php#336">3.3.6. Data export</a></dd>
<dd class="help_t3"><a href="chap3.php#337">3.3.7. Statistics</a></dd>
<dd class="help_t1"><a href="chap4.php#4"><h1>4. Incident management</h1></a></dd>
<dd class="help_t2"><a href="chap4.php#41">4.1. Adding an incident</a></dd>
<dd class="help_t2"><a href="chap4.php#42">4.2. Incident follow up</a></dd>
<dd class="help_t3"><a href="chap4.php#421">4.2.1. Adding comments to an incident</a></dd>
<dd class="help_t3"><a href="chap4.php#423">4.2.2. Attaching files to an incident</a></dd>
<dd class="help_t2"><a href="chap4.php#43">4.3. Searching for an incident</a></dd>
<dd class="help_t2"><a href="chap4.php#44">4.4. Statistics</a></dd>
<dd class="help_t1"><a href="chap5.php#5"><h1>5. Events</h1></a></dd>
<dd class="help_t2"><a href="chap5.php#51">5.1. Statistics</a></dd>
<dd class="help_t1"><a href="chap6.php#6"><h1>6. System audit</h1></a></dd>
<dd class="help_t2"><a href="chap6.php#61">6.1. Statistics</a></dd>
<dd class="help_t1"><a href="chap7.php#7"><h1>7. Server configuration</h1></a></dd>
<dd class="help_t2"><a href="chap7.php#71">7.1. Links </a></dd>
<dd class="help_t1"><a href="chap8.php#8"><h1>8. Data Base maintenance</h1></a></dd>
<dd class="help_t2"><a href="chap8.php#81">8.1. DB Information</a></dd>
<dd class="help_t2"><a href="chap8.php#82">8.2. Manual purge of the Database</a></dd>
<dd class="help_t2"><a href="chap8.php#83">8.3. Agent's data purge</a></dd>
<dd class="help_t3"><a href="chap8.php#831">8.3.1. Debuging selected data from a module</a></dd>
<dd class="help_t3"><a href="chap8.php#832">8.3.2. Purging all the agent's data</a></dd>
<dd class="help_t2"><a href="chap8.php#84">8.4. Purging system data</a></dd>
<dd class="help_t3"><a href="chap8.php#841">8.4.1. Audit data purge</a></dd>
<dd class="help_t3"><a href="chap8.php#842">8.4.2. Event data purge</a></dd>
</dl>
</body>
</html>

View File

@ -0,0 +1,61 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - Sistema de monitorizaci&oacute;n de Software Libre - Ayuda - I. Introduci&oacute;n</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Ayuda de Pandora v1.2</h1>
</div>
<div class="toc">
<h1><a href="toc.php">&Iacute;ndice</a> » <a href="chap2.php">2. Usuarios</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora es un proyecto de software GPL. &copy; Sancho Lerena 2003-2006, David Villanueva 2004-2006 y Ra&uacute;l Mateos 2004-2006.</p>
</div>
<h1><a name="1">1. Introducci&oacute;n</a></h1>
<h2><a name="11">1.1. Administraci&oacute;n de Pandora</a></h2>
<p>La administraci&oacute;n de Pandora se realiza desde la aplicaci&oacute;n Web.</p>
<p>La consola Web esta programada en
PHP y no requiere por parte del usuario final la instalaci&oacute;n de ning&uacute;n software
adicional: ni plug-in de FLASH, ni Java, ni ActiveX, puede accederse desde
cualquier plataforma que soporte HTML y CSS (IE5+ o Mozilla 4+).</p>
<p>La consola Web puede ejecutarse
en m&uacute;ltiples servidores, podemos tener tantas consolas Web como queramos, tanto
para repartir carga como para facilitar el acceso por problemas log&iacute;sticos
(grandes redes, numerosos grupos de usuarios diferentes, diferencias
geogr&aacute;ficas, diferencias administrativas, etc.). Su &uacute;nico requisito es poder
acceder al contenedor de datos donde Pandora almacena todo: la base de datos.</p>
<p class="center">
<img src="images/image001.png" alt="image001">
</p>
<p>La administraci&oacute;n de Pandora se divide de la siguiente forma:</p>
<ul>
<li>Usuarios de Pandora</li>
<li>Agentes</li>
<li>Alertas</li>
<li>Incidentes ocurridos en la red</li>
<li>Configuraci&oacute;n del servidor</li>
<li>Mantenimiento de la Base de Datos</li>
</ul>
</body>
</html>

View File

@ -0,0 +1,118 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - Sistema de monitorizaci&oacute;n de Software Libre - Ayuda - II. Usuarios</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Ayuda de Pandora v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap1.php">1. Introducci&oacute;n</a> « <a href="toc.php">&Iacute;ndice</a> » <a href="chap3.php">3. Agentes</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora es un proyecto de software GPL. &copy; Sancho Lerena 2003-2006, David Villanueva 2004-2006 y Ra&uacute;l Mateos 2004-2006.</p>
</div>
<h1><a name="2">2. Usuarios</a></h1>
<p>En Pandora se definen usuarios para la operativa diaria y se les asignan uno o varios perfiles.</p>
<p>Un perfil es una lista de lo que se puede y no se puede hacer sobre un grupo, como por ejemplo «ver incidentes»,
«gestionar bases de datos», etc.</p>
<p>En cada usuario se define a que grupos de agentes se puede acceder y el perfil de administraci&oacute;n que se tendr&aacute;
en cada uno de ellos. Cada usuario puede pertenecer a uno o m&aacute;s grupos, y tiene
asignado un perfil a cada grupo que pertenezca.</p>
<p>Los grupos definen elementos en com&uacute;n y cada agente esta asignado a un grupo (y s&oacute;lo a uno).
Los grupos contienen agentes e incidentes.</p>
<h2><a name="21">2.1. Gesti&oacute;n de perfiles</a></h2>
<p>La caracter&iacute;stica de gesti&oacute;n de
perfiles en Pandora permite definir roles espec&iacute;ficos para cada usuario de
Pandora y poder crear una jerarqu&iacute;a de usuarios ordenados por su perfil dentro
de la compa&ntilde;&iacute;a. As&iacute; se pueden crear operadores con accesos s&oacute;lo de lectura,
coordinadores de un grupo espec&iacute;fico de Agentes o administradores totales del
sistema</p>
<p>La creaci&oacute;n de un perfil en
Pandora se realiza desde Gesti&oacute;n de perfiles dentro del men&uacute; de Administraci&oacute;n.
En esta p&aacute;gina se encuentran todos los perfiles existentes, por defecto hay cinco perfiles creados:</p>
<ul>
<li>Operator (Read)</li>
<li>Operator (Write)</li>
<li>Chief Operator</li>
<li>Group coordinator</li>
<li>Pandora Administrator</li>
</ul>
<p>Para crear un perfil lo hacemos desde «Gesti&oacute;n de perfiles»&gt;«Crear perfil» dentro del men&uacute; de Administraci&oacute;n.</p>
<p class="center"><img src="images/image002.png"></p>
<p>A un nuevo perfil se le puede a&ntilde;adir cualquiera de los siguientes roles:</p>
<ul>
<li>Ver incidentes</li>
<li>Editar incidentes</li>
<li>Ver agentes. Permite ver los datos de los agentes, as&iacute; como los eventos generados por ellos</li>
<li>Editar agentes. Permite modificar los m&oacute;dulos de los agentes</li>
<li>Editar alertas. Permite modificar las alertas asignadas a los agentes</li>
<li>Gesti&oacute;n de usuarios. Permite modificar los usuarios y sus roles</li>
<li>Gesti&oacute;n de Base de Datos. Permite la manipulaci&oacute;n de la Base de Datos (Global)</li>
<li>Gesti&oacute;n de alertas. Permite la definici&oacute;n de las alertas (Global)</li>
<li>Gesti&oacute;n de Pandora. Opciones de configuraciones generales</li>
</ul>
<h2><a name="22">2.2. A&ntilde;adir un usuario</a></h2>
Para a&ntilde;adir un usuario lo hacemos desde «Gesti&oacute;n de usuarios»&gt;«Crear Usuario» dentro del men&uacute; de administraci&oacute;n.</p>
<p>Para crear un usuario se deben completar al menos los datos de identificador, contrase&ntilde;a (dos veces) y perfil global dentro de Pandora.</p>
<p>El perfil global define a un usuario como Administrador o como Usuario est&aacute;ndar dentro de Pandora.</p>
<p>Los usuarios con perfil «Administrador» tendr&aacute;n permisos totales en el servidor.</p>
<p class="center"><img src="images/image003.png"></p>
<p>Para los usuarios con perfil «usuario est&aacute;ndar» se definir&aacute;n los perfiles que tienen en cada uno de los
grupos a los que tiene acceso una vez se ha creado el usuario, y actualizar su configuraci&oacute;n.</p>
<p class="center"><img src="images/image004.png"></p>
<p>Para borrar un perfil de un usuario bastar&aacute; con pulsar en el icono <img src="../../images/cancel.gif">
correspondiente que hay a la derecha de cada perfil.</p>
<h2><a name="23">2.3. Borrar un usuario</a></h2>
<p>Para borrar un usuario bastar&aacute; en pulsar en el icono <img src="../../images/cancel.gif">
correspondiente que hay a la derecha del usuario en la lista de usuarios accesible desde «Gesti&oacute;n de usuarios», en el men&uacute; de administraci&oacute;n.</p>
<p class="center"><img src="images/image005.png"></p>
<h2><a name="24">2.4. Estad&iacute;sticas</a></h2>
<p>Existe una gr&aacute;fica que muestra la actividad de cada
usuario, reflejando el n&uacute;mero de eventos de auditor&iacute;a que ha generado cada uno
de ellos. Suele ser un reflejo de la actividad de cada usuario.</p>
<p>Para mostrar esta gr&aacute;fica, se accede desde «Usuarios» &gt; «Estad&iacute;sticas», en
el men&uacute; de operaci&oacute;n.</p>
<p class="center"><img src="images/image006.png"></p>
</body>
</html>

View File

@ -0,0 +1,476 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - Sistema de monitorizaci&oacute;n de Software Libre - Ayuda - III. Agentes</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
.ml15 {margin-left: 15px;}
.ml25 {margin-left: 25px;}
.ml35 {margin-left: 35px;}
.ml75 {margin-left: 75px;}
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Ayuda de Pandora v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap2.php">2. Usuarios</a> « <a href="toc.php">&Iacute;ndice</a> » <a href="chap4.php">4. Gesti&oacute;n de incidentes</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora es un proyecto de software GPL. &copy; Sancho Lerena 2003-2006, David Villanueva 2004-2006 y Ra&uacute;l Mateos 2004-2006.</p>
</div>
<h1><a name="3">3. Agentes</a></h1>
<p>Los agentes son los recolectores
de informaci&oacute;n, una vez se han instalado en la m&aacute;quina que se va a monitorizar
y se ha copiado la clave publica en el Servidor de Pandora &eacute;ste empezara a
recibir y procesar los datos que el agente recoge. Estos datos se denominan m&oacute;dulos.</p>
<p>Cada m&oacute;dulo tiene el valor de la
variable que monitoriza. Para que estos datos se consoliden en la base de
datos y se puedan tratar, hay que dar de alta el Agente en el Servidor de
Pandora y asignarle a un grupo definido en Pandora.</p>
<p>Para cada agente se permite:</p>
<ul>
<li>Ver el estado</li>
<li>Acceder a la informaci&oacute;n reportada</li>
<li>Acceder a cada caracter&iacute;stica monitorizada y ver su evoluci&oacute;n a lo largo del tiempo</li>
<li>Ver informes gr&aacute;ficos</li>
<li>Configurar alertas</li>
</ul>
<h2><a name="31">3.1. Gesti&oacute;n de grupos</a></h2>
<p>La creaci&oacute;n de grupos en Pandora se realiza desde «Gesti&oacute;n de perfiles» &gt; «Gesti&oacute;n de grupos», en el men&uacute;
de administraci&oacute;n.</p>
<p class="center"><img src="images/image007.png"></p>
<p>En esta pantalla se encuentran todos los grupos existentes, hay nueve grupos creados por defecto:</p>
<ul>
<li><b>All</b> (todos los grupos)</li>
<li><b>Applications</b></li>
<li><b>Comms</b></li>
<li><b>Databases</b></li>
<li><b>Firewall</b></li>
<li><b>IDS</b></li>
<li><b>Others</b></li>
<li><b>Servers</b></li>
<li><b>Workstations</b></li>
</ul>
<p>Se pueden crear todos los grupos que se necesiten pulsando en «Crear grupo» y asign&aacute;ndole un nombre.</p>
<p>Para borrar un grupo se pulsa en
el icono <img src="../../images/cancel.gif"> que cada grupo tienen a su derecha. No se recomienda borrar el grupo «<i>All</i>».</p>
<h2><a name="32">3.2. A&ntilde;adir un agente</a></h2>
<p>Una vez se han copiado en el
servidor de Pandora la clave p&uacute;blica de la m&aacute;quina que se quiere monitorizar y
se ha ejecutado el agente de Pandora, para que los datos empiecen a
consolidarse en la Base de Datos y se pueda acceder a los mismos, se necesita
a&ntilde;adir el agente a trav&eacute;s de la consola Web.</p>
<p>Para a&ntilde;adir un agente accedemos a «Gesti&oacute;n de agentes» &gt; «Crear agente», desde el men&uacute; de administraci&oacute;n.</p>
<p class="center"><img src="images/image008.png"></p>
<p>Para crear un agente se deben de configurar los siguientes datos:</p>
<ul>
<li><b>Nombre del agente:</b> <b>Tiene que coincidir</b> con el nombre que se ha configurado en la
variable «<code>agent name</code>» en el archivo <code>agent.conf</code> que hay en cada agente.
En el caso en el que esta variable est&eacute; comentada se
utilizara el nombre de Host de la m&aacute;quina donde se est&aacute; ejecutando el agente
(&eacute;ste se obtiene ejecutando el comando <i>hostname</i>).
<li><b>Direcci&oacute;n IP:</b> Muestra la IP del agente, es un dato a t&iacute;tulo informativo y puede coincidir en varios Agentes.</li>
<li><b>Grupo:</b> Define el grupo al que pertenece el agente, dentro de los grupos definidos en Pandora.</li>
<li><b>Intervalo:</b> Intervalo de ejecuci&oacute;n que tiene el agente. Es el tiempo que pasa desde que se ejecuta.</li>
<li><b>SO:</b> Define el Sistema Operativo que se quiere monitorizar
dentro de las siguientes opciones: AIX, BeOS, BSD, Cisco, HPUX, GNU/Linux, MacOS, Other, Solaris o Windows.</li>
<li><b>Descripci&oacute;n:</b> Breve descripci&oacute;n del agente</li>
<li><b>Definici&oacute;n de m&oacute;dulos:</b> Existen dos modos de definir un m&oacute;dulo:</li>
<p class="ml15">- <i><b>Modo aprendizaje:</b></i> Se admiten todos los m&oacute;dulos que env&iacute;e el agente
y se definen autom&aacute;ticamente en el sistema.
Al principio es m&aacute;s c&oacute;modo dar de alta los agentes en este modo y posteriormente desactivar el modo aprendizaje.</p>
<p class="ml15">- <i><b>Modo normal:</b></i> Se deben
configurar los m&oacute;dulos que se aceptaran de forma manual. No permite la
autodefinici&oacute;n de ning&uacute;n m&oacute;dulo.</li>
<li><b>Estado:</b> Define si el agente est&aacute; activado y listo para enviar
datos o si est&aacute; desactivado. Los agentes desactivados no se ven en las vistas
de usuario.</li>
</ul>
<h3><a name="321">3.2.1. Asignaci&oacute;n de m&oacute;dulos</a></h3>
<p>Los agentes de Pandora utilizan
comandos propios del sistema operativo para monitorizar un dispositivo. Estos
comandos producen una salida que el servidor de Pandora procesa e inserta en la
Base de Datos. Estos comandos utilizados en los agentes se denominan m&oacute;dulos.</p>
<p>Si el agente se ha a&ntilde;adido en <i>modo normal</i>, se deben de asignar los m&oacute;dulos que queremos monitorizar. Estos
m&oacute;dulos deben de estar configurados en el archivo de configuraci&oacute;n del agente.</p>
<p>Para asignarle los m&oacute;dulos, que
el servidor de Pandora procesar&aacute;, accedemos a «Gesti&oacute;n de agentes» en el men&uacute; de administraci&oacute;n.
En est&aacute; p&aacute;gina aparece una lista con todos los agentes que hay en Pandora.
<p>Al pulsar sobre el agente que se
quiere modificar aparecen los datos que se han configurado al crear el agente.
Desde aqu&iacute; se crear&aacute;n los m&oacute;dulos desde el formulario de asociaci&oacute;n de m&oacute;dulos.</p>
<p class="center"><img src="images/image009.png"></p>
<p>Para crear un m&oacute;dulo se deben completar los siguientes campos:</p>
<ul>
<li><b>Tipo de m&oacute;dulo:</b> En este campo se definen el tipo del dato que Pandora va a procesar. Hay 5 tipos de datos:</li>
<p class="ml15">
- <b><code>generic_data</code></b>, tipo num&eacute;rico de datos enteros.<br>
- <b><code>generic_data_inc</code></b>, tipo num&eacute;rico de datos enteros incrementales.<br>
- <b><code>generic_data_proc</code></b>, tipo num&eacute;rico booleano: 0 Falso, &gt;0 Verdadero.<br>
- <b><code>generic_data_string</code></b>, tipo alfanum&eacute;rico de datos (cadena de texto, m&aacute;ximo 255 caracteres).
</p>
<li><b>Nombre del m&oacute;dulo:</b> Define el nombre del m&oacute;dulo.</li>
<li><b>M&aacute;ximo</b>: Define el valor m&aacute;ximo que se aceptara para este dato.
Cualquier valor por encima del maximo definido se interpretar&aacute; como un dato no v&aacute;lido y se descartar&aacute; el m&oacute;dulo completo.</li>
<li><b>M&iacute;nimo</b>: Define el valor m&iacute;nimo que se aceptara para este dato.
Cualquier valor por debajo del m&iacute;nimo definido se interpretar&aacute; como un dato no v&aacute;lido y se descartar&aacute; el m&oacute;dulo completo.</li>
<li><b>Comentario:</b> Campo para incluir un comentario al m&oacute;dulo.</li>
</ul>
<p>Todos los m&oacute;dulos monitorizados por un agente se pueden ver accediendo al agente en «Gesti&oacute;n de agentes», men&uacute; de administraci&oacute;n.</p>
<p class="center"><img src="images/image010.png"></p>
<p>Desde aqu&iacute; se puede:</p>
<ul>
<li>borrar un m&oacute;dulo pinchando en el icono <img src="../../images/cancel.gif"></li>
<li>o editarlo, pinchando en el icono <img src="../../images/config.gif"></li>
</ul>
<p>No ser&aacute; posible modificar el tipo de dato del m&oacute;dulo.</p>
<h3><a name="322">3.2.2. Alertas</a></h3>
<p>Una alerta es la acci&oacute;n que tomar&aacute; Pandora cuando el valor de un m&oacute;dulo se encuentre fuera de un rango configurado previamente.</p>
<p>Esta acci&oacute;n puede ser desde
enviar un mail o un SMS, enviar un <i>trap</i> de SNMP, escribir el suceso en
el <i>syslog</i> del sistema, o en archivo de <i>log</i> de Pandora, etc.
En definitiva, se podr&aacute; ejecutar cualquier script configurado en el Sistema
Operativo de Pandora.</p>
<h4><a name="3221">3.2.2.1. Creaci&oacute;n de alertas</a></h4>
<p>Para acceder a las alertas creadas lo hacemos desde la opci&oacute;n de «Gesti&oacute;n de alertas» dentro del men&uacute; de administraci&oacute;n.</p>
<p>Por defecto hay definidos 6 ejemplos de alertas:</p>
<ul>
<li><b>eMail</b>. Env&iacute;a un email desde el servidor de Pandora</li>
<li><b>Internal audit</b>. Escribe en el log en el sistema de auditor&iacute;a interna de Pandora</li>
<li><b>LogFile</b>. Escribe en el log </code>/var/log/pandora_alert.log</code>.</p></li>
<li><b>SMS Text</b>. Env&iacute;a un SMS al n&uacute;mero m&oacute;vil elegido</li>
<li><b>SNMP Trap</b>. Env&iacute;a un Trap SNMP</li>
<li><b>Syslog</b>. Env&iacute;a la alerta a un Syslog</p>
</ul>
<p class="center"><img src="images/image011.png"></p>
<p>Para borrar una alerta pulsamos en <img src="../../images/cancel.gif"> que se encuentra a la derecha de la alerta que se quiere borrar.</p>
<p>Para crear una alerta personalizada se accede a «Gesti&oacute;n de alertas» &gt; «Crear alertas», en el men&uacute; de administraci&oacute;n</p>
<p>En las alertas ya configuradas los valores «<code>_field1_»</code>, «<code>_field2_</code>» y «<code>_field3_</code>»
se utilizan como variables para construir el comando que ejecutar&aacute; la m&aacute;quina
donde est&eacute; el servidor de Pandora (si hay varios, en el servidor en modo Master).</p>
<p class="center"><img src="images/image012.png"></p>
<p>Al crear una alerta, hay que rellenar los siguientes campos:</p>
<ul>
<li><b>Nombre de la alerta:</b> Un nombre descriptivo para la alerta</li>
<li><b>Comando:</b> Comando que ejecutar&aacute; la alerta</li>
<li><b>Descripc&oacute;n:</b> Descripci&oacute;n de la alerta</li>
</ul>
<h4><a name="3222">3.2.2.2. Asignaci&oacute;n de alertas</a></h4>
<p>Una vez se ha a&ntilde;adido el agente,
se han configurado los m&oacute;dulos y se han creado las alertas que se quieren
generar, se asignan estas alertas al agente correspondiente.</p>
<p>Desde «Gesti&oacute;n de agentes», desde el men&uacute; de
administraci&oacute;n, seleccionamos el agente que se quiere configurar. Al final de
la p&aacute;gina de configuraci&oacute;n est&aacute; la secci&oacute;n «Formulario de asociaci&oacute;n de alerta».</p>
<p class="center"><img src="images/image013.png"></p>
<p>Para asignar una alerta hay que rellenar los siguientes campos:</p>
<ul>
<li><b>Tipo de Alerta:</b> Se elige la alerta que se generar&aacute; dentro de las alertas que hay definidas.</li>
<li><b>Valor M&aacute;ximo: </b>Define el valor m&aacute;ximo v&aacute;lido para un m&oacute;dulo. Cualquier valor por encima de &eacute;l, disparar&aacute; la alerta.</li>
<li><b>Valor M&iacute;nimo: </b>Define el valor m&iacute;nimo v&aacute;lido para un m&oacute;dulo. Cualquier valor por debajo de &eacute;l, disparar&aacute; la alerta.</li>
<li><b>Descripci&oacute;n: </b>Describe la funci&oacute;n de la alerta, es &uacute;til para poder discriminarlo en la vista general de alertas.</li>
<li><b>Campo #1 (Alias nombre):</b> Define el valor utilizado para la variable «<code>_field1_</code>».</li>
<li><b>Campo #2 (L&iacute;nea sencilla):</b> Define el valor utilizado para la variable «<code>_field2_</code>».</li>
<li><b>Campo #3 (Texto completo):</b> Define el valor utilizado para la variable «<code>_field3_</code>».</li>
<li><b>Umbral de tiempo</b>: Tiempo que ha de pasar desde que se dispara una alerta hasta que se puede disparar otra.</li>
<li><b>Max Alerts Fired</b>: Define el n&uacute;mero m&aacute;ximo de alertas que se env&iacute;an de forma continua.</li>
<li><b>M&oacute;dulo Asignado</b>: Define el m&oacute;dulo que ser&aacute; monitorizado por la alerta.</li>
</ul>
<p>Todas las alertas creadas para un agente se pueden ver accediendo al agente, en «Gesti&oacute;n de agentes» desde el men&uacute; de administraci&oacute;n.</p>
<h3><a name="323">3.2.3. Gesti&oacute;n de m&oacute;dulos y alertas de agentes</a></h3>
<p>En muchos casos un usuario se
encontrara con el caso de que m&oacute;dulos y alertas configuradas en un agente se
repiten en otro agente que se quiere a&ntilde;adir. </p>
<p>Con el fin de simplificar el
trabajo de un administrador, dentro de Pandora se pueden copiar m&oacute;dulos y
alertas definidas en un agente existente sobre otro agente.</p>
<p>Accedemos a «Gesti&oacute;n de agentes» &gt; «Gestionar configuraci&oacute;, men&uacute; de administraci&oacute;n:</p>
<p class="center"><img src="images/image014.png"></p>
<p>Desde Agente origen se accede al
agente del cual se quieren copiar los m&oacute;dulos y/o alertas. Pinchando en
«Obtener info.» se obtienen todos los m&oacute;dulos que tiene el agente elegido.</p>
<p><b><i>El proceso de copia</i></b> se realiza para copiar la configuraci&oacute;n de los
m&oacute;dulos y/o la configuraci&oacute;n de las alertas desde el agente seleccionado como
origen hacia los agentes seleccionados como destino. Pueden seleccionarse
varios agentes, utilizando el CTRL y el rat&oacute;n. Hay que marcar las casillas de «alertas» y/o «m&oacute;dulos» para realizar una copia de los elementos seleccionados.</p>
<p><b><i>El proceso de borrado</i></b> se realiza sobre los agentes seleccionados
como «destino», en la casilla de selecci&oacute;n m&uacute;ltiple. Se pueden seleccionar
varios agentes, indicando si queremos eliminar la configuraci&oacute;n de los m&oacute;dulos,
de las alertas o todo el conjunto. Se pedir&aacute; confirmaci&oacute;n antes de ejecutar
dado que al eliminar los m&oacute;dulos asignados a un agente se eliminar&aacute; tambi&eacute;n
todos los datos asociados a &eacute;stos.</p>
<h2><a name="33">3.3. Monitorizaci&oacute;n de agentes</a></h2>
<p>Una vez el agente empieza a
enviar datos al servidor de Pandora, y es a&ntilde;adido en la consola Web, &eacute;ste los
procesa e inserta los datos en la Base de Datos. Estos datos se consolidan y
son accesibles desde la consola Web ya sea el dato en bruto o mediante
gr&aacute;ficas.</p>
<h3><a name="331">3.3.1. Ver agentes</a></h3>
<p>Desde la opci&oacute;n «Ver agentes» en el
men&uacute; de operaci&oacute;n se tiene acceso a todos los agentes. Desde aqu&iacute; se ve
r&aacute;pidamente estado en que esta cada uno de los agentes simplemente con una
r&aacute;pida mirada, gracias a un sistema de bombillas y c&iacute;rculos coloreados.</p>
<p class="center"><img src="images/image015.png"></p>
<p>En la lista, los agentes aparecen ordenados con las siguientes columnas:</p>
<p><b>Agente</b>: Muestra el nombre del agente.</p>
<p><b>SO</b>: Muestra un icono representante del Sistema Operativo.</p>
<p><b>Intervalo</b>: Muestra el intervalo de tiempo (segundos) en el que el agente env&iacute;a datos.</p>
<p><b>Grupo</b>: Muestra el grupo al que pertenece el agente.</p>
<p><b>M&oacute;dulos</b>: En estado normal aparecen dos valores el n&uacute;mero de
m&oacute;dulos y el n&uacute;mero de monitores, ambos de color negro. Si hay alg&uacute;n monitor en
estado incorrecto, aparecen tres valores: el n&uacute;mero de m&oacute;dulos, el n&uacute;mero de
monitores y el n&uacute;mero de monitores con estado incorrecto, &eacute;ste &uacute;ltimo en color rojo, el resto de color negro.</p>
<p><b>Estado</b>: Muestra el estado «general» del agente mediante los siguientes iconos:</p>
<div class="ml35">
<p><img src="../../images/b_green.gif"> Cuando todos los monitores est&aacute;n OK. El estado ideal.</p>
<p><img src="../../images/b_white.gif"> Cuando no hay monitores definidos. A veces no monitorizamos nada que pueda estar «bien» o «mal», y simplemente reporta datos
num&eacute;ricos o de tipo texto.</p>
<p><img src="../../images/b_red.gif"> Cuando al menos un monitor falla. Generalmente queremos evitar esto y que todos nuestros sistemas tengan un saludable color verde.</p>
<p><img src="../../images/b_blue.gif"> Cuando el agente no tiene datos. Los agentes nuevos con un paquete vac&iacute;o pueden tener este estado.</p>
<p><img src="../../images/b_yellow.gif"> Cuando hay un cambio entre verde y rojo. Esto indica que un agente acaba de cambiar de estado, de «todo bien» a «tenemos un problema».</p>
<img src="../../images/b_down.gif"> Cuando el agente est&aacute; ca&iacute;do o no se ha recibido informaci&oacute;n de &eacute;l en el doble del Intervalo en segundos. Generalmente se debe a un
problema de comunicaci&oacute;n o a un «cuelgue» del sistema remoto.</p>
</div>
<p><b>Alertas:</b> Muestra si se han enviado alertas mediante los siguientes iconos:</p>
<div class="ml35">
<p><img src="../../images/dot_green.gif"> Cuando no se ha enviado ninguna alerta.</p>
<p><img src="../../images/dot_red.gif"> Cuando se ha enviado al menos una alerta en el per&iacute;odo definido como «time threshold» o «umbral de tiempo» en la alerta.</p>
</div>
<p><b>&Uacute;ltimo contacto</b>: Muestra la fecha y hora en que se recibieron los &uacute;ltimos datos del agente.</p>
<p><b><u>Nota:</u></b> El icono <img src="../../images/setup.gif" width="15"> s&oacute;lo es visible si es usuario es administrador y es un enlace a la opci&oacute;n «Gestionar agentes» &gt; «Actualizar agente» del men&uacute; de administraci&oacute;n.</p>
<h3><a name="332">3.3.2. Acceso a los datos de un agente concreto</a></h3>
<p>Al acceder a un agente concreto, pinchando en el nombre del agente, se ven todos los datos relacionados con dicho agente.</p>
<h4><a name="3321">3.3.2.1. Informaci&oacute;n general de un agente</a></h4>
<p>Informa sobre los datos facilitados al crear el agente y el n&uacute;mero de paquetes totales que ha enviado el agente.</p>
<p class="center"><img src="images/image016.png"></p>
<h4><a name="3322">3.3.2.2. Muestra de &uacute;ltimos datos obtenidos</a></h4>
<p>Descripci&oacute;n de todos los m&oacute;dulos monitorizados por el agente.</p>
<p class="center"><img src="images/image017.png"></p>
<p>En la lista, los m&oacute;dulos aparecen ordenados con las siguientes columnas:</p>
<p><b>Nombre de m&oacute;dulo</b>: Nombre asignado al m&oacute;dulo en el archivo de configuraci&oacute;n del agente.</p>
<p><b>Tipo de m&oacute;dulo</b>: Tipo de m&oacute;dulo, seg&uacute;n los valores definidos <a href="#321"> en el punto
3.2.1.</a></p>
<p><b>Descripci&oacute;n</b>: Descripci&oacute;n del m&oacute;dulo configurado en el archivo de configuraci&oacute;n del agente.</p>
<p><b>Datos</b>: &Uacute;ltimo dato enviado por el agente.</p>
<p><b>Gr&aacute;fico</b>: A partir de los datos envidados por el agente a lo
largo del tiempo se generan una serie de gr&aacute;ficas mensuales, semanales, diarias
y horarias (M, W, D y H, respectivamente).</p>
<p>En la parte izquierda de la gr&aacute;fica se sit&uacute;an los datos m&aacute;s nuevos, mientras que en la parte derecha est&aacute;n
los datos m&aacute;s antiguos.</p>
<p>La gr&aacute;ficas que se generan son:</p>
<p class="ml75"> - <b>Gr&aacute;fico horario</b> (<img src="../../images/grafica_h.gif">) con un rango total de 60 minutos</p>
<p class="center"><img src="images/image018.png"></p>
<p class="ml75"> - <b>Gr&aacute;fico diario</b> (<img src="../../images/grafica_d.gif">) con un rango total de 24 horas</p>
<p class="center"><img src="images/image019.png"></p>
<p class="ml75"> - <b>Gr&aacute;fico semanal</b> (<img src="../../images/grafica_w.gif">) con un rango total de 7 d&iacute;as</p>
<p class="center"><img src="images/image020.png"></p>
<p class="ml75"> - <b>Gr&aacute;fico mensual</b> (<img src="../../images/grafica_m.gif">) con un rango total de 30 d&iacute;as</p>
<p class="center"><img src="images/image021.png"></p>
<p><b>Datos</b>: Son, en bruto, los datos enviados por el agente:</p>
<p class="ml25"> - <img src="../../images/data_m.gif"> El &uacute;ltimo mes</p>
<p class="ml25"> - <img src="../../images/data_w.gif"> La &uacute;ltima semana</p>
<p class="ml25"> - <img src="../../images/data_d.gif"> El &uacute;ltimo d&iacute;a</p>
<h4><a name="3323">3.3.2.3. Lista completa de monitores</a></h4>
<p>Descripci&oacute;n de todos los monitores definidos en el agente</p>
<p class="center"><img src="images/image022.png"></p>
<p>En la lista, los monitores aparecen ordenados con las siguientes columnas:</p>
<p><b>Agente;</b> Agente donde est&aacute; definido el monitor.</p>
<p><b>Tipo:</b> Tipo de dato del monitor. Al ser un monitor est&eacute; ser&aacute; siempre de tipo.</p>
<p><b>Nombre del m&oacute;dulo:</b> Nombre definido al crear el m&oacute;dulo.</p>
<p><b>Descripci&oacute;n:</b> Descripci&oacute;n del m&oacute;dulo configurado en el archivo de configuraci&oacute;n del agente.</p>
<p><b>Estado:</b> Aparece el estado del agente mediante los siguientes iconos:</p>
<p class="ml25"><img src="../../images/b_green.gif"> Cuando el monitor est&aacute; correcto</p>
<p class="ml25"><img src="../../images/b_red.gif"> Cuando el monitor falla</p>
<p><b>&Uacute;ltimo contacto</b>: Aparece la fecha y hora en que se recibieron los &uacute;ltimos datos del agente.</p>
<h4><a name="3324">3.3.2.4. Lista completa de alertas</a></h4>
<p>Nos muestra la descripci&oacute;n de todas las alarmas definidas en el agente.</p>
<p class="center"><img src="images/image023.png"></p>
<p>En la lista, los monitores aparecen ordenados con las siguientes columnas:</p>
<p><b>ID:</b> Agente donde est&aacute; definida la alerta.</p>
<p><b>Tipo:</b> Tipo de la alerta.</p>
<p><b>Descripci&oacute;n:</b> Descripci&oacute;n de la alerta definida cuando se cre&oacute;.</p>
<p><b>Lanzada por &uacute;ltimo vez:</b> &Uacute;ltima vez que se ejecut&oacute; la alerta.</p>
<p><b>N&uacute;mero de veces lanzada:</b> N&uacute;mero de veces que se ha lanzado la alerta.</p>
<p><b>Estado:</b> Muestra si se han enviado alertas mediante los siguientes iconos:</p>
<p class="ml25"><img src="../../images/dot_green.gif"> Cuando no se ha enviado ninguna alerta</p>
<p class="ml25"><img src="../../images/dot_red.gif"> Cuando se ha enviado al menos una alerta</p>
<h3><a name="333">3.3.3. Detalle de grupos</a></h3>
<p>Desde «Ver agentes» &gt; «Detalle de grupos» en el men&uacute; de operaci&oacute;n se accede a los grupos configurados en Pandora.
Desde aqu&iacute; se ve r&aacute;pidamente el estado en que est&aacute;n cada uno de los grupos
simplemente con una r&aacute;pida mirada, gracias a un sistema de bombillas de distintos colores.</p>
<p class="center"><img src="images/image025.png"></p>
<p>En la lista, los monitores aparecen ordenados con las siguientes columnas:</p>
<p><b>Grupos:</b> Nombre del grupo.</p>
<p><b>Agente:</b> N&uacute;mero de agentes configurados en el grupo.</p>
<p><b>Monitores:</b> N&uacute;mero de monitores configurados en el grupo.</p>
<p><b>Estado:</b> Estado del agente, mediante los siguientes iconos:</p>
<p class="ml25"><img src="../../images/b_green.gif"> Aparece cuando todos los monitores est&aacute;n correctos.</p>
<p class="ml25"><img src="../../images/b_red.gif"> Aparece cuando al menos un monitor tiene alg&uacute;n fallo.</p>
<p class="ml25"><img src="../../images/b_down.gif"> Aparece cuando al menos un monitor est&aacute; ca&iacute;do o no hay contacto.</p>
<p class="ml25"><img src="../../images/b_white.gif"> Aparece cuando el agente no tiene ning&uacute;n monitor definido.</p>
<p><b>Ok:</b> N&uacute;mero de monitores que est&aacute;n correctos.</p>
<p><b>Fallo:</b> N&uacute;mero de monitores que tienen alg&uacute;n fallo</p>
<p><b>Ca&iacute;dos:</b> N&uacute;mero de monitores que est&aacute;n ca&iacute;dos.</p>
<h3><a name="334">3.3.4. Ver monitores</a></h3>
<p>Desde «Ver agentes» &gt; «Detalle monitores» en el men&uacute; de operaci&oacute;n, se puede ver la descripci&oacute;n de todos los monitores definidos en el servidor.</p>
<p class="center"><img src="images/image026.png"></p>
<p>En la lista, los monitores aparecen ordenados de forma similar a la vista individual de cada agente,
excepto que ahora aparecen todas juntas, esto permite un an&aacute;lisis m&aacute;s pormenorizado de cada monitor.</p>
<h3><a name="335">3.3.5. Detalle de alertas</a></h3>
<p>Desde «Ver agentes» &gt; «Detalle alertas» en el men&uacute; de operaci&oacute;n, se puede ver la descripci&oacute;n de todas las alarmas definidas en el servidor.</p>
<p class="center"><img src="images/image027.png"></p>
<p>En la lista, las alertas aparecen ordenadas de forma similar a la vista individual de cada agente, excepto que
ahora aparecen todas juntas, esto permite un an&aacute;lisis m&aacute;s pormenorizado de cada alerta.</p>
<h3><a name="336">3.3.6. Exportar datos</a></h3>
<p>Desde «Ver agentes» &gt; «Exportar Datos» en el men&uacute; de operaci&oacute;n, se puede acceder a una herramienta que permite exportar datos de un agente.</p>
<p>Se puede configurar el agente desde el que se van a exportar los datos, los m&oacute;dulos dentro de dicho agente y
el rango de fechas del que exportaremos los datos.</p>
<p class="center"><img src="images/image028.png"></p>
<p>Estos datos pueden exportarse ordenados en tres columnas:</p>
<p><b>M&oacute;dulo:</b> Nombre del m&oacute;dulo.</p>
<p><b>Datos:</b> Informaci&oacute;n obtenida por el m&oacute;dulo.</p>
<p><b>Timestamp:</b> Fecha y hora en que el agente remoto de Pandora emiti&oacute; el paquete.</p>
<p class="center"><img src="images/image029.png"></p>
<p>Si se selecciona el formato CVS se obtendr&aacute;n los datos separados por comas, para poder exportar a un fichero de texto.</p>
<p class="center"><img src="images/image030.png"></p>
<h3><a name="337">3.3.7. Estad&iacute;sticas</a></h3>
<p>Desde «Ver agentes» &gt; «Estad&iacute;sticas» en el men&uacute; de operaci&oacute;n se accede a dos tipos de estad&iacute;sticas gr&aacute;ficas de los agentes:</p>
<ul>
<li>Una gr&aacute;fica con el n&uacute;mero de m&oacute;dulos que tiene configurado cada uno de los agentes.</li>
<li>Una gr&aacute;fica con el n&uacute;mero de paquetes enviado por cada
uno de los agentes, siendo un paquete el conjunto de datos relacionados con los
m&oacute;dulos que env&iacute;a un agente cada intervalo de tiempo.</li>
</ul>
<p class="center"><img src="images/image031.png"></p>
<p class="center"><img src="images/image032.png"></p>
<p class="center"><img src="images/image033.png"></p>
</body>
</html>

View File

@ -0,0 +1,198 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - Sistema de monitorizaci&oacute;n de Software Libre - Ayuda - IV. Gesti&oacute;n de incidentes</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
.ml25 {margin-left: 25px;}
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Ayuda de Pandora v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap3.php">3. Agentes</a> « <a href="toc.php">&Iacute;ndice</a> » <a href="chap5.php">5. Eventos</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora es un proyecto de software GPL. &copy; Sancho Lerena 2003-2006, David Villanueva 2004-2006 y Ra&uacute;l Mateos 2004-2006.</p>
</div>
<h1><a name="4">4. Gesti&oacute;n de incidentes</a></h1>
<p>En el proceso de monitorizaci&oacute;n de sistemas, adem&aacute;s de
recibir y procesar datos con el fin de monitorizar &eacute;stos en espacios temporales
definidos, es necesario hacer un seguimiento de los posibles incidentes que
ocurran en dichos sistemas. </p>
<p>Para ello hay configurado un
gestor de incidentes donde cada usuario puede abrir incidentes explicando lo
sucedido en la red y actualizarlos con comentarios y archivos cada vez que haya
alguna novedad. </p>
<p>Este sistema permite un trabajo
en equipo, con diferentes roles y sistemas de «<i>workflow</i>» que permiten
que un incidente pueda pasar de un grupo a otro, y que miembros de diferentes
grupos, y diferentes individuos, puedan trabajar sobre un mismo incidente,
compartiendo informaci&oacute;n y archivos.</p>
<p>Accediendo a «Incidentes», en el men&uacute; de operaci&oacute;n nos aparece una lista con todos los incidentes ordenados por
orden de actualizaci&oacute;n. Mediante los filtros se puede acceder s&oacute;lo a los incidentes que al usuario le interesen.</p>
<p class="center"><img src="images/image034.png"></p>
<p>Los filtros se pueden combinar, pudiendo realizarse filtros por los siguientes campos:</p>
<ul>
<li>
<b>Filtro por estado del incidente</b>. Donde se pueden ver:
<p class="ml25">- Todos los incidentes</p>
<p class="ml25">- Incidentes activos</p>
<p class="ml25">- Incidentes cerrados</p>
<p class="ml25">- Incidentes rechazados</p>
<p class="ml25">- Incidentes expirados</p>
</li>
<li>
<b>Filtro por prioridad</b>. Donde se pueden ver:
<p class="ml25">- De toda prioridad</p>
<p class="ml25">- De prioridad informativa</p>
<p class="ml25">- De prioridad baja </p>
<p class="ml25">- De prioridad media</p>
<p class="ml25">- De prioridad alta</p>
<p class="ml25">- De prioridad muy alta</p>
<p class="ml25">- De mantenimiento</p>
</li>
<li>
<b>Filtro por grupos</b>. Donde se pueden ver los incidentes asociados a cada uno de los grupos que existen en Pandora.
</li>
</ul>
<br>
<p>En la lista de incidentes, cada uno de ellos aparece con informaci&oacute;n distribuida en las siguientes columnas:</p>
<p><b>ID:</b> Identificador del incidente.</p>
<p><b>Estado:</b> Estado en el que se encuentra el incidente mediante los siguientes iconos:</p>
<p class="ml25"><img src="../../images/dot_red.gif"> Cuando el incidente est&aacute; activo</p>
<p class="ml25"><img src="../../images/dot_yellow.gif"> Cuando el incidente est&aacute; activo y tiene comentarios</p>
<p class="ml25"><img src="../../images/dot_blue.gif"> Cuando el incidente ha sido rechazado</p>
<p class="ml25"><img src="../../images/dot_green.gif"> Cuando el incidente est&aacute; cerrado</p>
<p class="ml25"><img src="../../images/dot_white.gif"> Cuando el incidente ha expirado</p>
<p><b>Nombre del Incidente:</b> Nombre que se le ha asignado al incidente</p>
<p><b>Prioridad:</b> Aparece la prioridad que tiene asignada el incidente mediante los siguientes iconos:</p>
<p class="ml25"><img src="../../images/dot_red.gif"><img src="../../images/dot_red.gif"><img src="../../images/dot_red.gif"> Prioridad muy alta</p>
<p class="ml25"><img src="../../images/dot_yellow.gif"><img src="../../images/dot_red.gif"><img src="../../images/dot_red.gif"> Prioridad alta</p>
<p class="ml25"><img src="../../images/dot_yellow.gif"><img src="../../images/dot_yellow.gif"><img src="../../images/dot_red.gif"> Prioridad media</p>
<p class="ml25"><img src="../../images/dot_green.gif"><img src="../../images/dot_yellow.gif"><img src="../../images/dot_yellow.gif"> Prioridad baja</p>
<p class="ml25"><img src="../../images/dot_green.gif"><img src="../../images/dot_green.gif"><img src="../../images/dot_yellow.gif"> Prioridad de tarea informativa</p>
<p class="ml25"><img src="../../images/dot_green.gif"><img src="../../images/dot_green.gif"><img src="../../images/dot_green.gif"> Prioridad de tarea de Mantenimiento</p>
<p><b>Grupo:</b> Define el grupo al que se ha asociado el incidente. Un
incidente s&oacute;lo puede pertenecer a un &uacute;nico grupo. </p>
<p><b>Actualizado el:</b> &Uacute;ltima vez que se produjo alguna actualizaci&oacute;n en el incidente.</p>
<p><b>Origen:</b> Etiqueta que se aplica para asignar un origen al
incidente. Puede ser seleccionada de una lista que se almacena en la base de
datos. Aunque la lista de or&iacute;genes es fija y predefinida, puede ser modificada
por el administrador en la base de datos.</p>
<p><b>Propietario:</b> Usuario que tiene asignado actualmente el incidente.
No confundir con el creador del incidente, ya que el incidente ha
podido cambiar de manos. El propietario puede siempre asignar el incidente a
otro usuario, as&iacute; como cualquier usuario con privilegios de gesti&oacute;n de
incidentes sobre el grupo al que pertenezca el incidente.</p>
<h2><a name="41">4.1. A&ntilde;adir un incidente</a></h2>
<p>Para crear un incidente bastara con acceder a «Gesti&oacute;n de incidentes» &gt; «Nuevo incidente», dentro del men&uacute; de operaci&oacute;n.</p>
<p class="center"><img src="images/image035.png"></p>
<p>Una vez se han completado los campos del incidente se pulsa en el bot&oacute;n «Crear».</p>
<h2><a name="42">4.2. Seguimiento de un incidente</a></h2>
<p>El seguimiento de los incidentes abiertos se realiza desde «Gesti&oacute;n de incidentes», men&uacute; de operaci&oacute;n.</p>
<p>Elegimos un incidente concreto en la columna «Nombre de incidente».</p>
<p>En la p&aacute;gina que se nos muestra podemos acceder a los datos de configuraci&oacute;n del incidente y a las distintas notas y archivos a&ntilde;adidos al mismo.</p>
<p>En la primera parte tenemos la configuraci&oacute;n del incidente.</p>
<p class="center"><img src="images/image036.png"></p>
<p>Desde este formulario se pueden actualizar los siguientes campos:</p>
<ul>
<li><b>Nombre del incidente</b></li>
<li><b>Due&ntilde;o del incidente</b></li>
<li><b>Estado del incidente</b></li>
<li><b>Origen del incidente</b></li>
<li><b>Grupo al que esta asociado el incidente</b></li>
<li><b>Prioridad del incidente</b></li>
</ul>
<p>Pinchando en el bot&oacute;n «Actualizar incidente» se grabaran los cambios realizados.</p>
<h3><a name="421">4.2.1. A&ntilde;adir notas a un incidente</a></h3>
<p>Para a&ntilde;adir Notas al incidente, pinchamos en «Insertar nota», nos aparecer&aacute; una p&aacute;gina que contiene un &aacute;rea de texto:</p>
<p class="center"><img src="images/image037.png"></p>
<p>Una vez terminado el texto, pulsamos en el bot&oacute;n «A&ntilde;adir» y aparecer&aacute; la nota que acabamos de a&ntilde;adir en la secci&oacute;n «Notas asociadas al incidente»</p>
<p class="center"><img src="images/image038.png"></p>
<p>Cualquier usuario con derechos de lectura de un incidente puede agregar una nota. S&oacute;lo los propietarios del incidente o de las notas pueden borrarlas.</p>
<h3><a name="422">4.2.2. A&ntilde;adir archivos a un incidente</a></h3>
<p>En algunas ocasiones es interesante asociar a un incidente una imagen, un archivo de configuraci&oacute;n o cualquier tipo de archivo.</p>
<p>Para ello desde la parte «A&ntilde;adir archivo» se busca el archivo en la m&aacute;quina local y se a&ntilde;ade al servidor pinchando en el bot&oacute;n «Subir».</p>
<p>Cualquier usuario con derechos de lectura de un incidente puede agregar un archivo. S&oacute;lo los propietarios del incidente o de los archivos pueden borrarlos.</p>
<p class="center"><img src="images/image039.png"></p>
<p>Para el seguimiento de la incidencia, desde la misma se puede acceder a todos los archivos adjuntados en «Ficheros adjuntos».</p>
<p class="center"><img src="images/image040.png"></p>
<h2><a name="43">4.3. Buscar incidencia</a></h2>
<p>Si se desea buscar un incidente concreto dentro de todos los incidentes que hay creados en Pandora, adem&aacute;s de los filtros que se han visto al principio del apartado,
se puede hacer una b&uacute;squeda m&aacute;s concreta desde «Gesti&oacute;n de incidentes» &gt; «Buscar incidentes», en el men&uacute; de operaci&oacute;n.</p>
<p class="center"><img src="images/image041.png"></p>
<p>Desde aqu&iacute; se puede buscar cualquier cadena de texto introducida como subcadena dentro del incidente,
haciendo un filtro por el usuario que creo el mismo.</p>
<p>Las b&uacute;squedas se realizan sobre
el t&iacute;tulo del incidente o sobre el contenido del mismo, pero no sobre las notas
asociadas ni sobre los archivos adjuntos. Tambi&eacute;n se pueden combinar estas
b&uacute;squedas con los filtros sobre grupo, prioridad o estado del incidente.</p>
<h2><a name="44">4.4. Estad&iacute;sticas</a></h2>
<p>Desde «Gesti&oacute;n de incidentes» &gt; «Estad&iacute;sticas» en el men&uacute; de operaci&oacute;n, se accede a cinco tipos de estad&iacute;sticas gr&aacute;ficas de los incidentes:</p>
<ul>
<li><b>Estado de los incidentes</b></li>
<li><b>Prioridades asignadas a los incidentes</b></li>
<li><b>Usuarios que tienen abierto un incidente</b></li>
<li><b>Incidentes por grupos</b></li>
<li><b>Or&iacute;genes de los incidentes</b></li>
</ul>
<p class="center">
<img src="images/image042.png"><br>
<img src="images/image043.png"><br>
<img src="images/image044.png"><br>
</p>
</body>
</html>

View File

@ -0,0 +1,79 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - Sistema de monitorizaci&oacute;n de Software Libre - Ayuda - V. Eventos</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
.ml25 {margin-left: 25px;}
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Ayuda de Pandora v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap4.php">4. Gesti&oacute;n de incidentes</a> « <a href="toc.php">&Iacute;ndice</a> » <a href="chap6.php">6. Auditor&iacute;a del Sistema</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora es un proyecto de software GPL. &copy; Sancho Lerena 2003-2006, David Villanueva 2004-2006 y Ra&uacute;l Mateos 2004-2006.</p>
</div>
<h1><a name="5">5. Eventos</a></h1>
<p>En Pandora un evento es cualquier cambio an&oacute;malo que se produce en un agente.</p>
<p>Queda registrado como evento cuando un agente se cae o se levanta, cuando un monitor falla o cambia de estado o cuando se env&iacute;a una alarma.</p>
<p>Generalmente un evento est&aacute; precedido
de un problema en los sistemas que se est&aacute;n monitorizando. Para evitar que
estos problemas queden sin ser estudiados se ha definido una forma de
validarlos y borrarlos en el caso de que el problema pueda ignorarse o se haya
solucionado.</p>
<p>Desde «Ver eventos» en el men&uacute; de operaci&oacute;n se accede a los eventos ordenados por orden de entrada en el sistema, viendo los primeros los m&aacute;s actualizados.</p>
<p class="center"><img src="images/image045.png"></p>
<br>
<p>En la lista de eventos, cada uno de ellos aparece con informaci&oacute;n distribuida en las siguientes columnas:</p>
<p><b>Estado:</b> Estado en el que se encuentra el incidente mediante los siguientes iconos:</p>
<p class="ml25"><img src="../../images/dot_green.gif"> Cuando el evento ha sido validado</p>
<p class="ml25"><img src="../../images/dot_red.gif"> Cuando el evento no ha sido validado</p>
<p><b>Nombre del evento:</b> Nombre asociado por Pandora al evento.</p>
<p><b>Nombre del agente:</b> Agente en el que ha ocurrido el evento.</p>
<p><b>Nombre del grupo:</b> Grupo al que pertenece el agente en el que ha ocurrido el evento.</p>
<p><b>ID de usuario:</b> Usuario que ha validado el evento.</p>
<p><b>Fecha y hora:</b> Fecha y hora de aparici&oacute;n del evento o de validaci&oacute;n en caso de estar validado.</p>
<p><b>Acci&oacute;n:</b> Acci&oacute;n que se puede ejecutar sobre el evento:</p>
<p class="ml25"><img src="../../images/ok.gif"> Pinchando en este icono se validar&aacute; el evento y desaparecer&aacute; el icono</p>
<p class="ml25"><img src="../../images/cancel.gif"> Pinchando en este icono se borrar&aacute; (y desaparecer&aacute;) el evento</p>
<p>Los eventos tambi&eacute;n se pueden validar y eliminar, marc&aacute;ndolos en la columna de la derecha y pinchando en «Validar» o «Borrar».</p>
<h2><a name="51">5.1. Estad&iacute;sticas</a></h2>
<p>Desde «Ver eventos» &gt; «Estad&iacute;sticas», men&uacute; de operaci&oacute;n, se accede a tres tipos de estad&iacute;sticas gr&aacute;ficas de los eventos:</p>
<ul>
<li>Gr&aacute;fica con los eventos totales divididos en revisados y no revisados
<p class="center"><img src="images/image046.png"></p>
</li>
<li>Gr&aacute;fica con los eventos totales divididos por los usuarios que los han validado
<p class="center"><img src="images/image047.png"></p>
</li>
<li>Gr&aacute;fica con los eventos totales divididos por el grupo al que pertenecen los agentes que ocasionan el evento
<p class="center"><img src="images/image048.png"></p>
</li>
</ul>
</body>
</html>

View File

@ -0,0 +1,73 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - Sistema de monitorizaci&oacute;n de Software Libre - Ayuda - VI. Auditor&iacute;a del Sistema</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
.ml25 {margin-left: 25px;}
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Ayuda de Pandora v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap5.php">5. Eventos</a> « <a href="toc.php">&Iacute;ndice</a> » <a href="chap7.php">7. Configuraci&oacute;n de Servidor</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora es un proyecto de software GPL. &copy; Sancho Lerena 2003-2006, David Villanueva 2004-2006 y Ra&uacute;l Mateos 2004-2006.</p>
</div>
<h1><a name="6">6. Auditor&iacute;a del Sistema</a></h1>
<p>En Pandora las entradas de auditor&iacute;a muestran las acciones realizadas por cada usuario, as&iacute; como los intentos de acceso fallidos al sistema.</p>
<p>En la versi&oacute;n actual de Pandora (1.1),
adem&aacute;s se muestran operaciones que de alguna manera han intentado eludir el
sistema de seguridad, tales como intentos de borrar un incidente sobre el que
el usuario no tiene permiso, cambio del perfil de usuario sin tener permiso de
administraci&oacute;n de usuarios y cosas similares. Principalmente sirve para llevar
un seguimiento de las conexiones (login/logoff) de cada usuario.</p>
<p>En «Auditor&iacute;a del Sistema» del men&uacute; de administraci&oacute;n, tenemos todos los <i>Logs</i> de auditor&iacute;a, ordenados por
orden de aparici&oacute;n.</p>
<p>Mediante un filtro puede accederse &uacute;nicamente a los <i>Logs</i> de auditor&iacute;a que interesen al usuario,
pudiendo realizarse filtros por la acci&oacute;n que provoca el <i>Log</i>.</p>
<p>Las acciones posibles son todas las acciones diferentes que haya almacenadas en ese momento en la Base de Datos.</p>
<p class="center"><img src="images/image049.png"></p>
<p>Cada una de las entradas de la lista de Logs de Auditor&iacute;a aparece con informaci&oacute;n distribuida en las siguientes columnas:</p>
<p><b>Usuario:</b> Usuario que ha generado el evento (SYSTEM es un usuario especial del sistema)</p>
<p><b>Acci&oacute;n:</b> Acci&oacute;n que ha generado la entrada en el log de auditor&iacute;a</p>
<p><b>Fecha:</b> Fecha en que se ha creado la entrada de auditor&iacute;a</p>
<p><b>IP Origen:</b> Aparece la IP o el agente que ha provocado la entrada</p>
<p><b>Comentarios:</b> Aparece un comentario asociado a la acci&oacute;n concreta</p>
<h2><a name="61">6.1. Estad&iacute;sticas</a></h2>
<p>Aunque no existe una secci&oacute;n
especial para ver las estad&iacute;sticas de la auditor&iacute;a del sistema, s&iacute; podemos
emplear la gr&aacute;fica generada en la secci&oacute;n de usuarios para evaluar las acciones
de cada usuario, ya que esta gr&aacute;fica representa el n&uacute;mero total de entradas en
el log de auditor&iacute;a para cada usuario: los usuarios m&aacute;s activos del sistema
tendr&aacute;n m&aacute;s entradas.</p>
<p>Tambi&eacute;n aparecer&aacute;n entradas correspondientes a usuarios no v&aacute;lidos: son aquellas entradas generadas por intentos incorrectos de entrada en el sistema o similar.</p>
<p class="center"><img src="images/image050.png"></p>
</body>
</html>

View File

@ -0,0 +1,77 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - Sistema de monitorizaci&oacute;n de Software Libre - Ayuda - VII. Configuraci&oacute;n de Servidor</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
.ml25 {margin-left: 25px;}
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Ayuda de Pandora v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap6.php">6. Auditor&iacute;a del Sistema</a> « <a href="toc.php">&Iacute;ndice</a> » <a href="chap8.php">8. Mantenimiento de la Base de Datos</a></h1>
</div>
<div class="rayah">
<p align='right'>Pandora es un proyecto de software GPL. &copy; Sancho Lerena 2003-2006, David Villanueva 2004-2006 y Ra&uacute;l Mateos 2004-2006.</p>
</div>
<h1><a name="7">7. Configuraci&oacute;n de Servidor</a></h1>
<p>Desde «Configuraci&oacute; en el men&uacute; de administraci&oacute;n se puede acceder a los par&aacute;metros configurables de Pandora</p>
<p class="center"><img src="images/image051.png"></p>
<p>Estos par&aacute;metros son:</p>
<p><b>C&oacute;digo de lenguaje para Pandora.</b> En sucesivas versiones o ampliaciones de la versi&oacute;n
actual pueden aparecer nuevos idiomas. En la versi&oacute;n 1.1, s&oacute;lo est&aacute;n soportados
Ingl&eacute;s y Espa&ntilde;ol (Castellano).</p>
<p><b>Tama&ntilde;o de bloque para la paginaci&oacute;n</b>. Tama&ntilde;o m&aacute;ximo de las listas en la secci&oacute;n de eventos,
incidentes y Logs de auditor&iacute;a.</p>
<p><b>M&aacute;x. d&iacute;as antes de comprimir datos</b>. Este par&aacute;metro controla la compactaci&oacute;n de los datos. A
partir del n&uacute;mero de d&iacute;as indicados, se comienzan a compactar datos. Para datos
con un gran volumen, se recomienda un n&uacute;mero entre 14 y 28, para sistemas con
poca carga o muy potentes, un n&uacute;mero entre 30 y 50.</p>
<p><b>M&aacute;x. d&iacute;as antes de eliminar datos</b>. Este par&aacute;metro controla el m&aacute;ximo total de d&iacute;as que
pueden tener los datos antes de ser definitivamente eliminados de la base de
datos. Un valor recomendado es 60. Para sistemas con pocos recursos o con mucha
carga, est&aacute; recomendado un valor entre 40 y 50.</p>
<p><b>Resoluci&oacute;n de los gr&aacute;ficos</b> (1 baja, 5 alta). Representa la precisi&oacute;n empleada en el
algoritmo de interpolaci&oacute;n empleado para generar los gr&aacute;ficos.</p>
<p><b>Interpolaci&oacute;n de la compactaci&oacute;n</b> (Horas: 1 bueno, 10 medio, 20 malo). Indica el grado de
compresi&oacute;n utilizado para la compactaci&oacute;n de las bases de datos, siendo el valor
1 el de menor y 20 el de mayor compactaci&oacute;n. Un valor por encima de 12
representa una seria degradaci&oacute;n de los valores compactados. No se recomienda
en general utilizar un valor superior a 6 si se emplea la funcionalidad de los
gr&aacute;ficos para comparar tendencias en rangos de tiempo amplios.</p>
<h2><a name="71">7.1. Enlaces</a></h2>
<p>En Pandora se pueden configurar
enlaces a diversos enlaces de Internet o redes internas, tales como motores de
b&uacute;squeda, aplicaciones o sitios de la Intranet corporativa. </p>
<p>Para ver los enlaces que hay configurados accedemos a «Configuraci&oacute; &gt; «Enlaces», en el men&uacute; de administraci&oacute;n.
<p class="center"><img src="images/image052.png"></p>
<p>Para crear un enlace nuevo se pincha en «Crear» y podemos editar el nuevo enlace:</p>
<p class="center"><img src="images/image053.png"></p>
</body>
</html>

View File

@ -0,0 +1,167 @@
<?php
// Pandora - The Free Monitoring System
// This code is protected by GPL license.
// Este codigo esta protegido por la licencia GPL.
// Sancho Lerena <slerena@gmail.com>, 2003-2006
// Raul Mateos <raulofpandora@gmail.com>, 2004-2006
?>
<html>
<head>
<title>Pandora - Sistema de monitorizaci&oacute;n de Software Libre - Ayuda - VIII. Mantenimiento de la Base de Datos</title>
<link rel="stylesheet" href="../../include/styles/pandora.css" type="text/css">
<style>
.ml25 {margin-left: 25px;}
div.logo {float:left;}
div.toc {padding-left: 200px;}
div.rayah {clear:both; border-top: 1px solid #708090; width: 100%;}
</style>
<div class='logo'>
<img src="../../images/logo_menu.gif" alt='logo'><h1>Ayuda de Pandora v1.2</h1>
</div>
<div class="toc">
<h1><a href="chap7.php">7. Configuraci&oacute;n de Servidor</a> « <a href="toc.php">&Iacute;ndice</a>
</div>
<div class="rayah">
<p align='right'>Pandora es un proyecto de software GPL. &copy; Sancho Lerena 2003-2006, David Villanueva 2004-2006 y Ra&uacute;l Mateos 2004-2006.</p>
</div>
<h1><a name="8">8. Mantenimiento de la Base de Datos</a></h1>
<p>La base de datos es el n&uacute;cleo de
Pandora. En esta base de datos reside toda la informaci&oacute;n recolectada por las
m&aacute;quinas monitorizadas, toda la informaci&oacute;n definida por el administrador as&iacute;
como todos los eventos, incidentes e informaci&oacute;n de auditor&iacute;a que han ido
ocurriendo en el sistema a lo largo del tiempo.</p>
<p>Es evidente que el rendimiento y
fiabilidad de este m&oacute;dulo es vital para el funcionamiento correcto de Pandora.
Es necesario hacer un mantenimiento peri&oacute;dico de la base de datos, para ello se
pueden utilizar los comandos est&aacute;ndar de MySQL. Este proceso no es una de las
finalidades de Pandora, pero es una tarea cr&iacute;tica.</p>
<p>Como el tama&ntilde;o de la base de
batos aumentar&aacute; de manera lineal, utilizamos un m&eacute;todo de compactaci&oacute;n para
reducir el n&uacute;mero de datos almacenados sin perder la informaci&oacute;n que se
considere necesaria, en particular las distintas gr&aacute;ficas generadas a partir de
la informaci&oacute;n procesada.</p>
<p>Pinchando en «Mantenimiento BBDD» del men&uacute; de administraci&oacute;n aparece la configuraci&oacute;n en tiempo real de la Base de
Datos con la configuraci&oacute;n que se ha definido en «Configuraci&oacute;, en el mismo
men&uacute; de administraci&oacute;n, para la compactaci&oacute;n y eliminaci&oacute;n de los datos.</p>
<p class="center"><img src="images/image054.png"></p>
<h2><a name="81">8.1. Informaci&oacute;n de la Base de Datos</a></h2>
<p>Desde «Gesti&oacute;n de incidentes» &gt; «Informaci&oacute;n de la Base de Datos» en el men&uacute; de operaci&oacute;n, se accede a dos tipos de estad&iacute;sticas gr&aacute;ficas de la base de datos por agentes:</p>
<ul>
<li>Una gr&aacute;fica con el n&uacute;mero de m&oacute;dulos que tienen configurado cada uno de los agentes.</li>
<li>Una gr&aacute;fica con el n&uacute;mero de paquetes enviado por cada
uno de los agentes. Siendo un paquete el conjunto de datos relacionados con los
m&oacute;dulos que env&iacute;a un agente cada intervalo de tiempo.</li>
</ul>
<p class="center">
<img src="images/image055.png"><br>
<img src="images/image056.png"><br>
<img src="images/image057.png"><br>
</p>
<p>Estas gr&aacute;ficas coinciden con las que se ven a trav&eacute;s de «Ver agentes» &gt; «Estad&iacute;sticas», en el men&uacute; de administraci&oacute;n.</p>
<h2><a name="82">8.2. Purgado Manual de la Base de Datos</a></h2>
<p>Pandora incorpora potentes
herramientas para el purgado manual por un Administrador de la mayor&iacute;a de los
datos guardados en la Base de Datos, ya sean estos datos procedentes de los
agentes o del propio servidor.</p>
<h2><a name="83">8.3. Depuraci&oacute;n de Datos procedentes de los agentes</a></h2>
<h3><a name="831">8.3.1. Depuraci&oacute;n de datos concretos de un m&oacute;dulo</a></h3>
<p>El proceso de depuraci&oacute;n de datos
concretos de un m&oacute;dulo sirve para eliminar aquellas entradas que se salen de
rango por cualquier raz&oacute;n (fallo de agente, valor real pero fuera de escala,
pruebas, errores en la BD, etc.). Eliminar datos falsos, incorrectos o
simplemente molestos permite que la escala de las gr&aacute;ficas sea m&aacute;s «real» y
permita mostrar los datos sin picos ni escalas irreales.</p>
<p>Desde «Mantenimiento BBDD» &gt; «Depurar BD» en el men&uacute; de administraci&oacute;n se pueden borrar los datos recibidos por
el m&oacute;dulo de un agente concreto que est&eacute;n fuera de un rango determinado.</p>
<p class="center"><img src="images/image058.png"></p>
<p>Los valores introducidos: agente, m&oacute;dulo, m&iacute;nimo y m&aacute;ximo sirven para delimitar los datos correctos.
Cualquier dato que se salga de ese par de par&aacute;metros, ser&aacute; eliminado.</p>
<p>Por ejemplo, en un tipo de m&oacute;dulo
que registra n&uacute;mero de procesos, nos interesan valores entre 0 y 100, puede que
tengamos valores muy por encima de 100, pero generalmente ser&aacute;n errores, ruido
o situaciones especiales. Podemos incluir como m&iacute;nimo un 0, y como m&aacute;ximo un
100. Valores tales como -1, 101 &oacute; 100000, ser&aacute;n eliminados permanentemente de
la Base de Datos.</p>
<h3><a name="832">8.3.2. Depuraci&oacute;n de todos los datos de un agente</a></h3>
<p>Desde «Mantenimiento BBDD» &gt; «Depuraci&oacute;n BBDD», men&uacute; de administraci&oacute;n se pueden borrar todos los datos recibidos
por un agente concreto que est&eacute;n fuera de un rango determinado.</p>
<p>Se pueden borrar los datos con los siguientes par&aacute;metros que se configuran en «Borrar datos»:</p>
<ul>
<li>Borrar todos los datos</li>
<li>Borrar los datos con m&aacute;s de tres meses</li>
<li>Borrar los datos con m&aacute;s de treinta d&iacute;as</li>
<li>Borrar los datos con m&aacute;s de dos semanas</li>
<li>Borrar los datos con m&aacute;s de una semana</li>
<li>Borrar los datos con m&aacute;s de tres d&iacute;as</li>
<li>Borrar los datos con m&aacute;s de un d&iacute;a</li>
</ul>
<p class="center"><img src="images/image059.png"></p>
<h2><a name="84">8.4. Depuraci&oacute;n de Datos procedentes del sistema</a></h2>
<h3><a name="841">8.4.1. Depuraci&oacute;n de datos de auditor&iacute;a</a></h3>
<p>Desde «Mantenimiento BBDD» &gt; «BBDD de auditor&iacute; en el men&uacute; de administraci&oacute;n, se pueden borrar todos los datos de
auditor&iacute;a generados por el sistema.</p>
<p>Se pueden borrar los datos con los siguientes par&aacute;metros que se configuran en «Borrar Datos».</p>
<ul>
<li>Borrar los datos de auditor&iacute;a excepto el &uacute;ltimo trimestre</li>
<li>Borrar los datos de auditor&iacute;a excepto los &uacute;ltimos 30 d&iacute;as</li>
<li>Borrar los datos de auditor&iacute;a excepto las &uacute;ltimas dos semanas</li>
<li>Borrar los datos de auditor&iacute;a excepto la &uacute;ltima semana</li>
<li>Borrar los datos de auditor&iacute;a excepto los &uacute;ltimos tres d&iacute;as</li>
<li>Borrar los datos de auditor&iacute;a excepto el &uacute;ltimo d&iacute;a</li>
<li>Borrar todos los datos de auditor&iacute;a</li>
</ul>
<p class="center"><img src="images/image060.png"></p>
<h3><a name="842">8.4.2. Depuraci&oacute;n de datos de eventos</a></h3>
<p>Desde «Mantenimiento BBDD» &gt; «BBDD de eventos», men&uacute; de administraci&oacute;n, se pueden borrar todos los datos de auditor&iacute;a
generados por el sistema.</p>
<p>Se pueden borrar los datos con los siguientes par&aacute;metros que se configuran en «Borrar Datos»:</p>
<ul>
<li>Borrar los datos de eventos excepto el &uacute;ltimo trimestre.</li>
<li>Borrar los datos de eventos excepto los &uacute;ltimos 30 d&iacute;as</li>
<li>Borrar los datos de eventos excepto las &uacute;ltimas dos semanas</li>
<li>Borrar los datos de eventos excepto la &uacute;ltima semana</li>
<li>Borrar los datos de eventos excepto los &uacute;ltimos tres d&iacute;as</li>
<li>Borrar los datos de eventos excepto el &uacute;ltimo d&iacute;a</li>
<li>Borrar todos los datos de eventos</li>
</ul>
<p class="center"><img src="images/image061.png"></p>
</body>
</html>

Binary file not shown.

After

Width:  |  Height:  |  Size: 47 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.7 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.5 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 3.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.7 KiB

Some files were not shown because too many files have changed in this diff Show More