Difference between revisions of "Pandora: Documentation es: IPAM"

From Pandora FMS Wiki
Jump to: navigation, search
Line 1: Line 1:
= IPAM Extension =
+
= Extensión IPAM =
  
Using IPAM extension, we can manage, discover and get event on changes on hosts in a given network. We can know if a given IP address (IPv4 or IPv6) change it's availability (answer to a ping) or hostname (using dns resolution). We also can detect its OS and link a IP address to a current Pandora FMS agent, adding the IP address to their currently assigned addresses. IPAM extension uses the recon server and a recon script on the low level, but you don't need to configure nothing, IPAM extension do everything for you.  
+
Con la extensión IPAM podremos descubrir los hosts de una subred y detectar sus cambios de disponibilidad (si responden a ping o no) o nombre de host (obtenido mediante dns). Además podremos detectar su sistema operativo. La extensión de IPAM utiliza un recon script (dependiente del recon server) para realizar toda la lógica que hay por debajo. La gestión de IP's es independiente de que tenga o no agentes instalados en esas máquinas o un agente con monitores remotos sobre esa IP. Opcionalmente puede "asociar" un agente a la IP y gestionar esa IP, pero no afecta a la monitorización que esté realizando.
  
IP Management works in parallel to the monitoring you currently manage with Pandora FMS agents, you can associate a IP address managed with IPAM extension or not, it depends on you. Managed IP addresses can optionally generate event on change.
+
== Detección de IPs ==
  
== IPs Detection ==
+
Podemos configurar una red (mediante una red y una máscara de red) para que se ejecute cada cierto tiempo el reconocimiento de sus direcciones o bien que únicamente se haga manualmente. Este mecanismo utiliza por debajo el recon server, pero lo gestiona automáticamente.
  
We can setup a network (using a bit mask or a prefix), and this network will be automatically sweeped or setup to have a on-request manual execution. This will execute a recon script task, searching for active IP (using nmap for IPv4 and ping for IPv6). You see the progress on network sweep in the status view and also in the recon server view.
+
En ambos casos podremos forzar el reconocimiento y observar el porcentaje completado en la barra de progreso.
  
== Views ==
+
== Vistas ==
  
Network IP addresses administration and operation are splitted in two views: icon views and edition view.
+
La operación y administración de las direcciones de una subred están separadas en dos tipos de vistas: Vistas de iconos y vista de edición.
  
=== Icon view ===
+
=== Vista de iconos ===
  
 
<br>
 
<br>
Line 21: Line 21:
 
<br>
 
<br>
  
This view reports information on the network, including stats on the percentage and number of occupied IP addresses (only for 'managed' addresses). We can also export to Excel/CSV the filtered list.
+
Con esta vista veremos información de la subred, incluyendo estadísticas del porcentaje y número de direcciones usadas (marcadas como administradas).
  
Addresses will be shown as icons, large or small. This icons will render the following information:
+
Además podremos exportar la lista a formato Excel (CSV)
 +
 
 +
Las direcciones se mostrarán en forma de icono, pudiendo elegir entre dos tamaños: Pequeños (por defecto) y Grandes.
 +
 
 +
Cada dirección tendrá un icono grande que nos aportará información:
  
 
<table border="1" cellpadding="4" cellspacing="0" width="900px" style="background-color: #f0f0f0; border: 1px solid #acacac; margin: 0px auto;">
 
<table border="1" cellpadding="4" cellspacing="0" width="900px" style="background-color: #f0f0f0; border: 1px solid #acacac; margin: 0px auto;">
 
<tr>
 
<tr>
<th colspan="3" style="background-color: #cacaca;">Managed</th>
+
<th colspan="3" style="background-color: #cacaca;">Administrado</th>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<th style="background-color: #cacaca;">Setup</th>
+
<th style="background-color: #cacaca;">Configuración</th>
<th style="background-color: #cacaca;">Alive host</th>
+
<th style="background-color: #cacaca;">Host vivo</th>
<th style="background-color: #cacaca;">Unresponsive host</th>
+
<th style="background-color: #cacaca;">Host no responde</th>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<td>No assigned agent<br><br>Disabled events</td>
+
<td>Sin agente asignado<br><br>Eventos desactivados</td>
 
<td style="text-align:center;">[[File:green_host.png]]</td>
 
<td style="text-align:center;">[[File:green_host.png]]</td>
 
<td style="text-align:center;">[[File:red_host.png]]</td>
 
<td style="text-align:center;">[[File:red_host.png]]</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<td>With assigned agent<br><br>Disabled events</td>
+
<td>Con agente asignado<br><br>Eventos desactivados</td>
 
<td style="text-align:center;">[[File:green_host_agent.png]]</td>
 
<td style="text-align:center;">[[File:green_host_agent.png]]</td>
 
<td style="text-align:center;">[[File:red_host_agent.png]]</td>
 
<td style="text-align:center;">[[File:red_host_agent.png]]</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<td>No assigned agent<br><br>Enabled events</td>
+
<td>Sin agente asignado<br><br>Eventos activados</td>
 
<td style="text-align:center;">[[File:green_host_alert.png]]</td>
 
<td style="text-align:center;">[[File:green_host_alert.png]]</td>
 
<td style="text-align:center;">[[File:red_host_alert.png]]</td>
 
<td style="text-align:center;">[[File:red_host_alert.png]]</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<td>With assigned agent<br><br>Enabled events</td>
+
<td>Con agente asignado<br><br>Eventos activados</td>
 
<td style="text-align:center;">[[File:green_host_agent_alert.png]]</td>
 
<td style="text-align:center;">[[File:green_host_agent_alert.png]]</td>
 
<td style="text-align:center;">[[File:red_host_agent_alert.png]]</td>
 
<td style="text-align:center;">[[File:red_host_agent_alert.png]]</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<th colspan="3" style="background-color: #cacaca;">Not managed</th>
+
<th colspan="3" style="background-color: #cacaca;">Sin administrar</th>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<th style="background-color: #cacaca;">Setup</th>
+
<th style="background-color: #cacaca;">Configuración</th>
<th style="background-color: #cacaca;">Alive host</th>
+
<th style="background-color: #cacaca;">Host vivo</th>
<th style="background-color: #cacaca;">Unresponsive host</th>
+
<th style="background-color: #cacaca;">Host no responde</th>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<td style="width: 100px;">If an IP address is not managed, you can only view if is responding or not.</td>
+
<td style="width: 100px;">Independientemente de la configuración, si el host no está administrado solo se diferenciará entre si está vivo y no responde</td>
 
<td style="text-align:center;">[[File:green_host_dotted.png]]</td>
 
<td style="text-align:center;">[[File:green_host_dotted.png]]</td>
 
<td style="text-align:center;">[[File:not_host.png]]</td>
 
<td style="text-align:center;">[[File:not_host.png]]</td>
Line 70: Line 74:
  
  
Each IP address have in the bottom right position a link to edit it (with adminitration rights). In the bottom left position, there is a small icon showing the OS detected. On disabled addresses, instead the OS icon, you will see this icon:
+
Cada dirección tendrá en la parte inferior derecha un enlace para editarla, si disponemos de privilegios suficientes. Así mismo, en la parte inferior izquierda, tendrá un pequeño icono indicando el sistema operativo asociado. En el caso de las direcciones desactivadas, el icono del sistema operativo se verá sustituido por el siguiente icono:
  
 
<br>
 
<br>
Line 78: Line 82:
 
<br>
 
<br>
  
When you click on the main icon, a modal window will be opened showing all the IP information, including associated agent and OS, setup for that IP and other information, like creation date, last user edition or last time it was checked by server. In this view you can also do a manual, realtime check to see if that IP respond to ping.
+
Si hacemos click en el icono principal, se abrirá una ventana modal con toda la información de la IP, incluyendo agente y sistema operativo asociados, configuración y el seguimiento de cuando se creó, editó por el usuario o fue chequeado por el servidor por última vez. En esta vista también se podrá hacer un ping a dicha dirección.
  
 
<br>
 
<br>
Line 87: Line 91:
  
  
{{warning|This ping is done by the console, instead the regular check, done by the recon server.}}
+
{{warning|El ping se realiza desde la máquina donde esté instalada la consola de Pandora FMS.}}
  
=== Edit view ===
+
=== Vista de edición ===
  
If you have enought permission, you will have access to setup view, where IP address are shown as a list. You can filter to show only the IP's you are interested into, make changes and update all at once.
+
Si se tienen los permisos suficientes se podrá acceder a la vista de edición, donde las IPs aparecerán mostradas en forma de lista. Se podrá filtrar para mostrar las direcciones deseadas, hacer cambios en ellas y actualizar todas a la vez.
  
Some fields, are automatically filled by the recon script, like hostname, if it have a Pandora FMS agent and the operating system. You can mark that fields as "manual" and edit them.
+
Algunos campos, se rellenan automáticamente por el script de reconocimiento, como el nombre de host, el agente de Pandora FMS asociado y el sistema operativo. Podemos definir estos campos como manuales y editarlos.
  
 
<table border="1" cellpadding="4" cellspacing="0" width="100%" style="background-color: #f0f0f0; border: 1px solid #acacac; width: 900px; margin: 0px auto;">
 
<table border="1" cellpadding="4" cellspacing="0" width="100%" style="background-color: #f0f0f0; border: 1px solid #acacac; width: 900px; margin: 0px auto;">
Line 101: Line 105:
 
<tr>
 
<tr>
 
<td style="text-align:center; width: 25px;">[[File:manual.png]]</td>
 
<td style="text-align:center; width: 25px;">[[File:manual.png]]</td>
<td><b>Manual mode</b>: With this symbol, the field will not be updated by the recon system and you can edit manually. By clicking on it, you will switch to automated mode.</td>
+
<td><b>Modo manual</b>: Con este símbolo el campo no se actualizará desde el script de reconocimiento y podremos editarlo a mano. Al hacer click cambiaremos a modo automático.</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
 
<td style="text-align:center; width: 25px;">[[File:automatic.png]]</td>
 
<td style="text-align:center; width: 25px;">[[File:automatic.png]]</td>
<td><b>Automated mode</b>: With this icon, the field will be updated automatically from the recon script. By clicking on it, it will switch to manual mode.</td>
+
<td><b>Modo automático</b>:Con este símbolo el campo se actualizará desde el script de reconocimiento. Al hacer click cambiaremos a modo manual.</td>
 
</tr>
 
</tr>
 
</table>
 
</table>
  
  
{{warning|Fields marked as "manual" will not be updated by the recon script.}}
+
{{warning|Los campos marcados como manuales no serán actualizados por el script de reconocimiento.}}
  
Other fields you can modify are:
+
Otros campos que podemos modificar son:
- Activate events on an IP address. When availability on this address change (answer or stop to answer) or the hostname change, a new event will be generated.
+
- Activar los eventos de una dirección. Cuando la disponibilidad de estas direcciones cambie (deje de responder o vuelva a hacerlo) o su nombre cambie, se generará un evento.  
  
When an address is created, it always will generate an event.
+
Cuando una dirección se crea la primera vez, siempre generará un evento.
  
- Mark as managed an IP Address. This address are those we will acknowledge as assigned in our network and managed in the system. You can filter to show only managed addresses.
+
- Marcar como administrada una dirección. Estas direcciónes serán las que reconocemos como asignadas en nuestra red. Podremos filtrar las IPs para solamente mostrar las que tengamos marcadas como administradas.
  
- Disable. Disabled IP addresses are not checked by the recon script.
+
- Deshabilitar. Las IPs deshabilitadas no serán chequeadas por el script de reconocimiento.
  
- Comments. A free field to add comments on each address.
+
- Comentarios. Un campo libre para añadir los comentarios que deseemos a cada dirección.
  
 
<br>
 
<br>
Line 129: Line 133:
 
<br>
 
<br>
  
== Filters ==
+
== Filtros ==
  
On both views you can sort by IP, Hostname and by the last update.
+
En ambas vistas se podrán orenar por IP, Hostname y por la última vez que fueron chequeadas.
  
You can filter by a text substring, which will match in IP, hostname or comments of each IP in the system. Enabling the checkbox near to search box, it will force an exact match by IP.
+
Se podrá filtrar por una cadena libre que buscará subcadenas en la IP, Hostname o Comentarios. Activando el checkbox junto a la caja de búsqueda se hará una búsqueda exacta por IP.
  
By default, not responding hosts are not shown, but you can change the filter.
+
Por defecto los hosts que no responden no se muestran, pero se puede activar.
  
You can also show only the managed IP addresses.
+
También se pueden mostrar solamente las IPs que hayamos marcadas como administradas.
  
== Subnetwork calculator ==
+
== Calculadora de subredes ==
  
IPAM includes a tool to calculate IPv4 and IPv6 subnetworks.
+
IPAM incluye una herramienta para calcular subredes IPV4 e IPv6.
  
In this tool, you can, using an IP address and a netmask, obtain the information of that network:
+
En dicha herramienta podremos, a partir de una dirección IP y la máscara de la red a la que pertenece, obtener información de dicha subred:
  
 
*Red (Dirección/Bitmask)
 
*Red (Dirección/Bitmask)
Line 154: Line 158:
 
*Número de IPs en la red
 
*Número de IPs en la red
  
{{tip|These fields are given in address format (decimal for IPv4 and hexadecimal for IPv6) and binary format.}}
+
{{tip|Estos campos son dados en formato dirección (decimal para IPv4 y hexadecimal para IPv6) y en formato binario.}}
  
 
<br>
 
<br>

Revision as of 11:29, 15 May 2014

1 Extensión IPAM

Con la extensión IPAM podremos descubrir los hosts de una subred y detectar sus cambios de disponibilidad (si responden a ping o no) o nombre de host (obtenido mediante dns). Además podremos detectar su sistema operativo. La extensión de IPAM utiliza un recon script (dependiente del recon server) para realizar toda la lógica que hay por debajo. La gestión de IP's es independiente de que tenga o no agentes instalados en esas máquinas o un agente con monitores remotos sobre esa IP. Opcionalmente puede "asociar" un agente a la IP y gestionar esa IP, pero no afecta a la monitorización que esté realizando.

1.1 Detección de IPs

Podemos configurar una red (mediante una red y una máscara de red) para que se ejecute cada cierto tiempo el reconocimiento de sus direcciones o bien que únicamente se haga manualmente. Este mecanismo utiliza por debajo el recon server, pero lo gestiona automáticamente.

En ambos casos podremos forzar el reconocimiento y observar el porcentaje completado en la barra de progreso.

1.2 Vistas

La operación y administración de las direcciones de una subred están separadas en dos tipos de vistas: Vistas de iconos y vista de edición.

1.2.1 Vista de iconos


IPAM icons.png


Con esta vista veremos información de la subred, incluyendo estadísticas del porcentaje y número de direcciones usadas (marcadas como administradas).

Además podremos exportar la lista a formato Excel (CSV)

Las direcciones se mostrarán en forma de icono, pudiendo elegir entre dos tamaños: Pequeños (por defecto) y Grandes.

Cada dirección tendrá un icono grande que nos aportará información:

Administrado
Configuración Host vivo Host no responde
Sin agente asignado

Eventos desactivados
Green host.png Red host.png
Con agente asignado

Eventos desactivados
Green host agent.png Red host agent.png
Sin agente asignado

Eventos activados
Green host alert.png Red host alert.png
Con agente asignado

Eventos activados
Green host agent alert.png Red host agent alert.png
Sin administrar
Configuración Host vivo Host no responde
Independientemente de la configuración, si el host no está administrado solo se diferenciará entre si está vivo y no responde Green host dotted.png Not host.png


Cada dirección tendrá en la parte inferior derecha un enlace para editarla, si disponemos de privilegios suficientes. Así mismo, en la parte inferior izquierda, tendrá un pequeño icono indicando el sistema operativo asociado. En el caso de las direcciones desactivadas, el icono del sistema operativo se verá sustituido por el siguiente icono:


Disabled.png


Si hacemos click en el icono principal, se abrirá una ventana modal con toda la información de la IP, incluyendo agente y sistema operativo asociados, configuración y el seguimiento de cuando se creó, editó por el usuario o fue chequeado por el servidor por última vez. En esta vista también se podrá hacer un ping a dicha dirección.


IPAM Details.png



Template warning.png

El ping se realiza desde la máquina donde esté instalada la consola de Pandora FMS.

 


1.2.2 Vista de edición

Si se tienen los permisos suficientes se podrá acceder a la vista de edición, donde las IPs aparecerán mostradas en forma de lista. Se podrá filtrar para mostrar las direcciones deseadas, hacer cambios en ellas y actualizar todas a la vez.

Algunos campos, se rellenan automáticamente por el script de reconocimiento, como el nombre de host, el agente de Pandora FMS asociado y el sistema operativo. Podemos definir estos campos como manuales y editarlos.

Cambio entre manual y automático
Manual.png Modo manual: Con este símbolo el campo no se actualizará desde el script de reconocimiento y podremos editarlo a mano. Al hacer click cambiaremos a modo automático.
Automatic.png Modo automático:Con este símbolo el campo se actualizará desde el script de reconocimiento. Al hacer click cambiaremos a modo manual.


Template warning.png

Los campos marcados como manuales no serán actualizados por el script de reconocimiento.

 


Otros campos que podemos modificar son: - Activar los eventos de una dirección. Cuando la disponibilidad de estas direcciones cambie (deje de responder o vuelva a hacerlo) o su nombre cambie, se generará un evento.

Cuando una dirección se crea la primera vez, siempre generará un evento.

- Marcar como administrada una dirección. Estas direcciónes serán las que reconocemos como asignadas en nuestra red. Podremos filtrar las IPs para solamente mostrar las que tengamos marcadas como administradas.

- Deshabilitar. Las IPs deshabilitadas no serán chequeadas por el script de reconocimiento.

- Comentarios. Un campo libre para añadir los comentarios que deseemos a cada dirección.


IPAM edition.png


1.3 Filtros

En ambas vistas se podrán orenar por IP, Hostname y por la última vez que fueron chequeadas.

Se podrá filtrar por una cadena libre que buscará subcadenas en la IP, Hostname o Comentarios. Activando el checkbox junto a la caja de búsqueda se hará una búsqueda exacta por IP.

Por defecto los hosts que no responden no se muestran, pero se puede activar.

También se pueden mostrar solamente las IPs que hayamos marcadas como administradas.

1.4 Calculadora de subredes

IPAM incluye una herramienta para calcular subredes IPV4 e IPv6.

En dicha herramienta podremos, a partir de una dirección IP y la máscara de la red a la que pertenece, obtener información de dicha subred:

  • Red (Dirección/Bitmask)
  • Máscara de red
  • La máscara Wildcard
  • La dirección de red
  • La dirección de Broadcast
  • Primera IP válida
  • Última IP válida
  • Número de IPs en la red

Info.png

Estos campos son dados en formato dirección (decimal para IPv4 y hexadecimal para IPv6) y en formato binario.

 



IMAP Calculator IPV4.png
IPv4



IMAP Calculator IPV6.png
IPv6