Difference between pages "Pandora: Documentation es: Discovery" and "Pandora: Documentation es: Interfaz"

From Pandora FMS Wiki
(Difference between pages)
Jump to: navigation, search
(NetScan)
 
(Página principal de Pandora FMS)
 
Line 1: Line 1:
 
[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]
 
[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]
  
=¿Qué es Pandora FMS Discovery?=
+
=Interfaz de Pandora FMS=
  
{{Tip|Disponible para versiones de Pandora FMS 732 o superiores.}}
+
== Introducción ==
  
Discovery aporta un conjunto de herramientas para simplificar la monitorización a través de asistentes.
+
En este capítulo se explicarán algunas de las bases comunes de la interfaz de Pandora FMS.
  
Se incluyen las siguientes herramientas:
+
== Pantalla de inicio de sesión de Pandora FMS ==
 
 
;Task list: La herramienta Discovery de Pandora FMS permite ver un listado de todas las tareas programadas en nuestro entorno tanto a nivel de consola como a nivel de servidor.
 
;Discovery Applications: Permite monitorizar entornos MySQL, Oracle o VMware desde una nueva consola de administración.
 
;Discovery Cloud: A través de esta utilidad se puede monitorizar su infraestructura en Cloud, desde máquinas virtuales creadas en Amazon Web Services (EC2) o bases de datos relacionales en AWS RDS a máquinas virtuales corriendo en Azure Compute.
 
;Console Tasks: Permite automatizar tareas de consola dentro del sistema Discovery, desde programar informes, realizar backups o ejecutar scripts personalizados desde Pandora FMS Console.
 
;Discovery Host&Devices: Incluye las herramientas necesarias para descubrir o importar dispositivos y equipos en su red.
 
  
 +
En la siguiente imagen se muestra la pantalla de inicio de sesión de Pandora FMS:
 +
<br><br>
 
<center>
 
<center>
[[File:discovery1.png]]
+
[[image:If1.JPG|center|300px]]
 
</center>
 
</center>
  
=Discovery Task list=
 
 
La herramienta Discovery de Pandora FMS permite ver un listado de todas las tareas programadas en nuestro entorno tanto a nivel de consola como a nivel de servidor.
 
  
<center>
+
En ella aparece el número de versión de Pandora FMS, en la parte inferior.
[[File:DISC_Task_list_1.JPG]]
 
</center>
 
  
==Console tasks==
+
En la parte central están las entradas de texto para el usuario y su contraseña, así como el botón de inicio de sesión (Login).
  
Este apartado permite ver el listado de tareas programadas en la consola. La información se nos muestra según los siguientes parámetros:  
+
Una vez que se introduzcan las credenciales de inicio de sesión válidas, que por defecto, serían:
  
* User: Es el usuario que ha creado la tarea.  
+
* '''Usuario''': admin.
* Task: Descripción de la tarea programada.
+
* '''Contraseña''': pandora
* Scheduled: Indica cada cuanto tiempo se ejecutará la tarea.
 
* Next Execution: Especifica la siguiente ejecución de la tarea.
 
* Last Execution: Indica cuándo se ejecutó la tarea por última vez.
 
* Group: El grupo al que pertenece la tarea.
 
* Operations: Muestra las acciones que podemos realizar sobre la tarea, editar y borrar.
 
  
===Edit Console tasks===
+
De forma predeterminada, la consola mostrará la página principal de bienvenida de Pandora FMS. Aunque la página de inicio puede ser personalizada por el usuario, como se explica en el apartado [[Pandora:Documentation_es:Interfaz#P.C3.A1gina_de_inicio_personalizada|Página de Inicio Personalizada]]
  
Este botón nos permitirá acceder a la sección de creación, donde podremos también editar la tarea que se desee según los siguientes parámetros:
+
== Página principal de Pandora FMS ==
  
* Task: La tarea que se ejecutará de entre las siguientes:
+
La página principal por defecto de Pandora FMS muestra información básica y general acerca del estado de los sistemas y del número y tipo de comprobaciones que realiza Pandora FMS.
** Backup Pandora FMS database.
 
** Execute custom script.
 
** Save custom report to disk.
 
** Save custom XML report to disk.
 
** Send custom report (from template) by email.
 
** Send custom report by email.
 
  
* Scheduled: Sirve para especificar cada cuánto tiempo se ejecutará la tarea.
+
A continuación, se muestra la pantalla por defecto de Pandora FMS y sus elementos.
* Next execution: Nos muestra la fecha de la siguiente ejecución, pudiendo modificarla si fuese necesario.
 
* Group: Grupo al que pertenece la tarea.
 
* Parameters: Son los parámetros específicos de cada tarea.
 
 
 
====Parámetros de las diferentes tareas====
 
<br>
 
;Backup Pandora FMS database:
 
* Description: Descripción de la copia de seguridad.
 
* Save to disk in path: ruta en la que se almacenará el backup.<br><br>
 
;Execute custom script:
 
* Custom script: Se indicará el script que se quiere ejecutar.<br> <br>
 
;“Save custom report to disk” y “Save custom XML report to disk”:
 
* Report pending to be created: El informe que queremos crear.
 
* Save to disk in path: Ruta donde se almacenará el informe creado.<br><br>
 
;Send custom report (from template) by email:
 
* Template pending to be created: Plantilla personalizada que se quiere crear.
 
* Agents: Agentes de los que se obtendrá la información que se verá reflejada en el informe.
 
* Report per agent: Si se desea generar informes separados para cada informe.
 
* Report name: Nombre que se desee dar al informe.
 
* Send to email addresses: Direcciones de correo a las que se quiere enviar el informe.
 
* Subject: Tema del correo que se enviará.
 
* Message: Cuerpo del mensaje con el que se enviarán los informes.<br><br>
 
;Send custom report by email:
 
* Report pending to be created: Informe que se generará.
 
* Send to email addresses: Direcciones de correo a las que se quiere enviar el informe.
 
* Subject: Tema del correo que se enviará.
 
* Message: Cuerpo del mensaje con el que se enviarán los informes.
 
* Report Type: Tipo de informe que será enviado.
 
 
 
==Server tasks==
 
 
 
En este apartado se reflejan las tareas de reconocimiento programadas por el servidor. La información se nos muestra según los siguientes parámetros:
 
 
 
* Force: Opción que nos permitirá forzar la ejecución de la tarea.
 
* Task name: Nombre asignado a la tarea.
 
* Server name: Servidor que ejecutará la tarea.
 
* Interval: Intervalo de tiempo en el que se realizará la tarea.
 
* Network: La red donde se realizarán los chequeos.
 
* Status: Estado de la tarea programada.
 
* Task type: Tipo de la tarea que se ha generado.
 
* Progress: Progreso de la tarea en caso de estar ejecutándose.
 
* Updated at: Indica cuándo se actualizó la tarea por última vez.
 
* Operations: Acciones que podemos realizar sobre la tarea. Visualización del estado de la tarea, visualización del mapa de la red descubierta, edición y borrado.
 
 
 
===Operaciones===
 
 
 
La edición de las tareas de reconocimiento del servidor nos permiten ajustar los siguientes parámetros:
 
 
 
* Interval: Podemos determinar el intervalo de ejecución de la tarea, ya sea de forma manual o definida.
 
* Task name: Nombre de la tarea.
 
* Discovery server: Servidor que ejecutará la tarea de reconocimiento. Es un parámetro obligatorio para el correcto funcionamiento del reconocimiento.
 
* Network: Red sobre la que se quieren realizar los chequeos.
 
* Group: Grupo al que pertenece.
 
* Comment: Comentarios a añadir.
 
 
 
=Discovery Applications=
 
 
 
Ahora es posible monitorizar aplicaciones remotamente utilizando ''Discovery Applications''.
 
 
 
 
 
<center>
 
[[File:discoverysap1.png]]
 
</center>
 
 
 
==Discovery Applications: MySQL==
 
 
 
A partir de la versión de Pandora FMS 7.0-733 se pueden monitorizar entornos MySQL utilizando Discovery Applications.
 
 
 
Para ello, será necesario definir los siguientes parámetros:
 
 
 
* Task name: Nombre de la tarea que realizará la monitorización de MySQL.
 
* Discovery Server: Servidor que realizará la ejecución de la tarea especificada.
 
* Group: Grupo al que pertenecerá.
 
* MySQL server IP: IP del servidor donde se encuentra el entorno MySQL a monitorizar.
 
* MySQL server port: Puerto de la dirección especificada a través del que se obtendrá la información de la monitorización MySQL.
 
* User: Usuario de MySQL con el que se accederá. (Importante: Debe ser un usuario con permisos sobre la bbdd a ejecutar las consultas, ya que si no nunca podremos establecer la conexión.)
 
* Password: Contraseña del usuario de MySQL especificado anteriormente.
 
* Interval: Intervalo de tiempo en el que se ejecutará la monitorización.  
 
  
 +
<br><br>
 
<center>
 
<center>
[[File:DISCMySQL1.JPG]]
+
[[image:If2.JPG|center|800px]]
 
</center>
 
</center>
 +
<br><br>
  
Una vez definidos los parámetros con los datos que necesitemos para nuestra instalación, se nos mostrará una nueva ventana en la que será necesario especificar el agente sobre el que queramos crear todos los módulos derivados de la monitorización MySQL.
+
Los elementos estáticos ─que no cambian entre las diferentes pantallas─ en la interfaz son:
  
Las opciones a mostrar son las siguientes:
+
* Menú de Operación
 +
* Menú de Administración
 +
* Enlaces definidos
 +
* Cabecera
  
* Target agent: Agente sobre el que se crearán los módulos derivados de la monitorización.
+
Los elementos dinámicos ─que cambian entre las diferentes pantallas─ son:
* Custom module prefix: Define un prefijo personalizado que se concatenará con el nombre de los módulos generados por la tarea.
 
* Scan databases: Escaneará las bases de datos.
 
* Create agent per database: Esta opción permitirá que se cree un agente por cada base de datos encontrada en nuestro entorno MySQL.
 
* Check engine uptime: Comprobará el tiempo que nuestro motor MySQL está operativo.
 
* Retrieve query statistics: Permite recuperar las estadísticas de las consultas ejecutadas.
 
* Analyze connections: Analiza las conexiones.
 
* Retrieve InnoDB statistics: Devuelve las estadísticas de InnoDB.
 
* Retrieve cache statistics: Devuelve las estadísticas de caché.
 
* Custom queries: Permite definir sentencias personalizadas.
 
  
<center>
+
* En la cabecera podemos destacar:
[[File:DISCMySQL2.JPG]]
+
** Información del usuario, mensajes pendientes, notificaciones del sistema, etc. (se detallará más adelante en la '''subsección cabecera''')
</center>
+
* Noticias del sitio
 +
* Última actividad en la consola web
 +
* Información general básica
 +
* Vista general de las comprobaciones en Pandora FMS:
 +
** <b>Server health</b>: Estado general del servidor.
 +
** <b>Monitor health</b>: Estado general de los monitores.  
 +
** <b>Module sanity</b>: Estado general de los módulos que están recogiendo datos frente a los no inicializados.
 +
** <b>Alert level</b>: Estado general de las alertas.
  
==Discovery Applications: Oracle==
+
Esta es la página principal por defecto, pero el usuario puede personalizarla.
  
A partir de la versión de Pandora FMS 7.0-733 se puede monitorizar Oracle utilizando Discovery Applications.
+
=== Página de inicio personalizada ===
  
La monitorización de Oracle permitirá definir los siguientes parámetros:
+
En la vista Área de trabajo-> Edit my user se puede elegir la pantalla de inicio de Pandora FMS.
  
* Task name: Nombre de la tarea.
+
<center><br><br>
* Discovery server: Servidor que ejecutará la tarea de monitorización de Oracle.
+
[[image:If3.JPG|center|800px]]
* Group: Grupo al que pertenece.
+
</center><br><br>
* Oracle target strings: Donde se definirán las strings objetivo de nuestra tarea.
 
* User: Usuario de Oracle que accederá para realizar la monitorización.
 
* Password: Contraseña del usuario previamente definido.  
 
* Interval: Intervalo de ejecución.
 
  
<center>
+
''Nota: La funcionalidad de la barra de acceso rápido (Shortcut bar) está implementada a partir de Pandora FMS 5.0''
[[File:DISC_Oracle1.JPG]]
 
</center>
 
  
Una vez definidos, será necesario especificar el agente que almacenará la información y los chequeos que se realizarán. La información que se puede definir en esta sección es la siguiente:  
+
Las opciones disponibles son las siguientes:
  
* Target agent: Agente que recibirá la información de la monitorización de Oracle.  
+
* '''Default.''': Pantalla por defecto, explicada con detalle en el apartado anterior <b>Página principal de Pandora FMS</b>.
* Custom module prefix: Define un prefijo personalizado que se concatenará con el nombre de los módulos generados por la tarea.
+
* '''Dashboard.''': Se puede elegir un dashboard del usuario.
* Check engine uptime: Comprobará el tiempo que Oracle está operativo.  
+
* '''Visual console.''': Se puede elegir una visual console del usuario.
* Retrieve query statistics: Permite recuperar las estadísticas de las consultas ejecutadas.
+
* '''Event list.''': Lista de eventos.
* Analyze connections: Analiza las conexiones.  
+
* '''Group view.''': Vista de grupos del agente.
* Calculate fragmentation ratio: Calcula la tasa de fragmentación.  
+
* '''Tactical view.''': Vista táctica de los agentes.
* Monitor tablespaces: Monitoriza las estructuras que contienen los datos en Oracle.  
+
* '''Alert detail.''': Listado de alertas.
* Retrieve cache statistics: Devuelve las estadísticas de caché.
+
* '''Other.''': El usuario puede personalizar la página de inicio introduciendo la url. Un ejemplo sería sec=estado&sec2=operation/agentes/estado_agente para ver el detalle de los agentes.
* Execute custom queries: Ejecuta consultas personalizadas.  
 
* Custom queries: Permite definir consultas personalizadas.
 
  
<center>
+
=== El menú Operación ===
[[File:DISC Oracle2.JPG]]
 
</center>
 
  
===Instalación de paquetes de Oracle===
+
El menú Operación permite visualizar todas las comprobaciones que llevan a cabo los agentes de Pandora FMS, los mapas visuales, los mapas de red, el inventario, ver y gestionar los incidentes (si se dispone de permisos suficientes), ver la consola SNMP, ver los mensajes y usar las extensiones.
  
Es muy importante tener en cuenta que para la correcta integración y funcionamiento de Oracle con Pandora FMS es necesario disponer de los paquetes adecuados. En las ISO de Pandora FMS viene incluido todo lo necesario, pero para instalaciones realizadas de otra manera el proceso de instalación será el siguiente:
+
<br><br>
 +
<CENTER>
 +
[[image:Menuope.jpg|center|200px]]
 +
</CENTER>
 +
<br><br>
  
* Instalar oracle instant client desde la página de Oracle:
+
Dentro de cada submenú del menú de Operación pueden existir otros elementos que se despliegan.
https://www.oracle.com/technetwork/database/database-technologies/instant-client/downloads/index.html
 
  
* Paquetes necesarios:
+
Cada uno de estos elementos proporciona otra página con información. Todas ellas se explicarán en detalle en los capítulos de operación con Pandora FMS.
  
oracle-instantclient11.1-basic-11.1.0.7.0-1.x86_64.rpm
+
=== El menú Administración ===
oracle-instantclient11.1-devel-11.1.0.7.0-1.x86_64.rpm
 
oracle-instantclient11.1-sqlplus-11.1.0.7.0-1.x86_64.rpm
 
  
* Preparar el entorno de arranque de pandora_server:
+
El menú Administración permite visualizar y gestionar las comprobaciones que llevan a cabo los agentes de Pandora FMS, los módulos y componentes de dichas comprobaciones, las alertas que pueden lanzar dichos módulos y agentes y cómo funcionan dichas alertas, las políticas existentes, los usuarios, los perfiles de los usuarios, los servidores de Pandora FMS y sus tareas asignadas, el registro de auditoría del sistema, el comportamiento general de la consola web de Pandora FMS, el mantenimiento de la base de datos y las extensiones de la consola.
  
{{Warning|En el directorio del pandora_server se debe crear un fichero llamado pandora_server.env con la información posterior. Se debe ejecutar ./pandora_server.env}}
+
<br><br>
 +
<CENTER>
 +
[[image:Extension.jpg|center|200px]]
 +
</CENTER>
 +
<br><br>
  
# Set Oracle environment for pandora_server
+
Dentro de cada submenú del menú de Administración pueden existir otros elementos que se despliegan al seleccionar el menú.
cat > /etc/pandora/pandora_server.env << 'EOF_ENV'
 
#!/bin/bash
 
VERSION=11.1
 
export PATH=$PATH:$HOME/bin:/usr/lib/oracle/$VERSION/client64/bin
 
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib/oracle/$VERSION/client64/lib
 
export ORACLE_HOME=/usr/lib/oracle/$VERSION/client64
 
EOF_ENV
 
  
* Reiniciar pandora_server
+
Cada uno de estos elementos proporciona otra página con información. Todas ellas se explicarán en detalle en los capítulos de operación y gestión con Pandora FMS.
  
/etc/init.d/pandora_server restart
+
=== El menú Enlaces ===
  
{{Warning|Si se está usando el paquete E7, se tendrán que instalar la librería y las variables de entorno de la versión 12.2, así como usar los paquetes de Oracle (v12.2)}}
+
El menú de enlaces simplemente muestra un enlace a sitios preconfigurados. Estos se pueden añadir, modificar y borrar desde el menú de Administración de Pandora FMS. Estos enlaces permiten enlazar Pandora FMS con otras aplicaciones WEB de su organización y hacer que Pandora FMS sea un punto de gestión central.
<br>
 
==Discovery Applications: SAP==
 
<br>
 
Discovery Applications incorpora un nuevo miembro a su familia a partir de la versión 741 de Pandora FMS. A partir de esta versión viene incluida de serie en la ISO oficial de instalación.  
 
  
{{Warning|Si instala Pandora FMS desde paquetes, o su sistema es anterior a NG741 deberá desplegar el plugin oficial de SAP en el servidor de Pandora FMS y configurarlo manualmente (vea más abajo).}}
+
<br><br>
 +
<CENTER>
 +
[[image:Enlaces.jpg|center|400px]]
 +
</CENTER><br><br>
  
{{Warning|Para poder usar SAP en Discovery debe configurar un número de licencia específico para este plugin, que no está incluido en la licencia Enterprise de Pandora FMS. Debe configurar esta licencia en Setup -> Enterprise.}}
+
=== La Cabecera ===
  
El sistema guiará cada paso para configurar SAP según las necesidades que se tengan. Se podrá definir la misma tarea para monitorizar sistemas con configuraciones similares.
+
La cabecera de Pandora FMS ofrece varios enlaces rápidos, o accesos directos, a características importantes del sistema, así como una barra de búsqueda:
  
 +
<br><br>
 
<center>
 
<center>
[[File:discoverysap2.png]]
+
[[image:If4.JPG|550px|center]]
 
</center>
 
</center>
 +
<br><br>
  
En el ejemplo de la imagen superior los servidores sapsample.artica.lan, sap2.artica.lan y 10.0.30.33 utilizan la misma configuración de mandante, sistema y credenciales, por lo que se pueden agrupar en la misma tarea.  
+
De izquierda a derecha, la cabecera proporciona:
 
+
* La barra de búsqueda que permite buscar en diversos elementos: agentes, informes, alertas, mapas, gráficas combinadas, usuarios y/o políticas en la base de datos de Pandora FMS.
{{Warning|Si se necesitan monitorizar diferentes configuraciones, se deberá crear una tarea para cada configuración.}}
+
* El botón de auto-refresco que, además de actualizar la pantalla, puede configurarse para que auto-refresque en un intervalo de tiempo seleccionable. Esto permite que en cualquier página pueda definir que esta se refresque cada X tiempo, haciendo que no se pierda la sesión y que muestre los datos actualizados.
 
+
* En caso de haber notificaciones del sistema pendientes se mostrará un icono de alerta que, al clickar en él, desplegará una ventana modal con los avisos actuales.
Se seleccionará de la lista la información acerca del sistema SAP que se desee recuperar:
 
  
 +
<br><br>
 
<center>
 
<center>
[[File:discoverysap3.png]]
+
[[image:System_advises.jpeg|700px|center]]
 
</center>
 
</center>
 +
<br><br>
  
Pandora FMS Discovery se encargará de recolectar la información, almacenándola en agentes representados por los 'SAP Hostnames' que se hayan definido.  
+
{{Warning|Estos mensajes, al igual que las notificaciones por email de la consola, redirigen a la url del archivo <b>/etc/crontab</b> o a una public url con la opción "force" activada. Por lo que si no lo configuramos, utilizará como url <b>"localhost" por defecto</b>.}}
  
 
===Instalación manual del conector de Discovery para SAP===
 
 
Si su versión de Pandora FMS fue instalada antes de la versión NG741, necesitará descargar el conector y configurarlo manualmente.
 
 
Primero, necesitará instalar JAVA (JRE) en el servidor de Pandora FMS para el funcionamiento de Discovery SAP.
 
Después necesita descargar el conector/plugin remoto para Linux de SAP, puede descargarlo de nuestra librería en https://pandorafms.com/library/sap-r3-monitoring-agent/.
 
 
También necesitará configurar su pandora_server.conf y establecer los parámetros siguientes:
 
 
# Discovery SAP
 
java /usr/bin/java
 
 
   
 
   
# Discovery SAP utils
+
* Enlace al estado de los sistemas, que muestra el estado de los servidores de Pandora FMS.
sap_utils /usr/share/pandora_server/util/recon_scripts/SAP
+
* Un enlace al soporte de Pandora FMS.
 +
* Un enlace a la ayuda contextual general de Pandora FMS.
 +
* Información acerca del usuario que está conectado, un enlace directo a su página de usuario (entre corchetes).
 +
* El botón de cerrar la sesión.
 +
* En caso de tener mensajes pendientes por leer, se mostrará un icono de una carta que desplegará una ventana modal con los mensajes disponibles.
  
En el directorio indicado con el token de configuración ''sap_utils'' debe descomprimir los ficheros que encontrará en el tarball descargado de la librería denominado "Pandora FMS SAP Discovery for Linux" y que contiene los siguientes ficheros:
+
El enlace al estado del sistema avisa también de cuándo se cae algún servicio, cambiando de icono:
 
 
Deset_SAP_Plugin.jar
 
dev_jco_rfc.trc
 
libsapjco3.so
 
sapjco3.dll
 
sapjco3.jar
 
 
 
Una vez modificado el fichero de configuración, reinice el servidor de Pandora FMS.
 
 
 
=== SAP View ===
 
<br>
 
Se podrá ver el estado general de los servidores SAP de la instalación a través de la vista SAP View.
 
  
 +
<br><br>
 
<center>
 
<center>
[[File:discoverysap4.png]]
+
[[image:Servers.jpg|center]]
 
</center>
 
</center>
 +
<br><br>
  
Esta vista mostrará un panel con los módulos SAP disponibles del agente SAP seleccionado.
+
Al pulsar sobre el enlace, este lleva directamente al estado de los servidores, informando de diversos detalles acerca de los mismos:
 
 
Se podrá seleccionar el tiempo de refresco y el intervalo a mostrar en las gráficas.
 
<br>
 
<br>
 
 
 
=== Vista específica de SAP ===
 
<br>
 
La vista SAP también se integra como una nueva pestaña dentro de la vista de agente. Si el sistema detecta que el agente es un agente SAP, se mostrará el acceso a la pestaña de SAP View:  
 
  
 +
<br><br>
 
<center>
 
<center>
[[File:discoverysap5.png]]
+
[[image:Config.jpg|center|800px]]
 
</center>
 
</center>
 +
<br><br>
  
La vista del agente proporcionará una visión general del estado de los módulos SAP del agente actual:  
+
En la sección de edición de usuario podemos configurar el autorrefresco para ciertas secciones. Si está habilitado en la sección en la que nos encontramos, el botón de auto refresco permite actualizar la página al pulsar sobre él, o bien seleccionar una frecuencia de actualización:
  
 +
<br><br>
 
<center>
 
<center>
[[File:discoverysap6.png]]
+
[[image:Autorefresh_select_time_pandora_v5.png|center]]
 
</center>
 
</center>
 +
<br><br>
  
== Discovery Applications: VMware ==
+
Una vez seleccionada esta, se mostrará el tiempo restante hasta la próxima actualización junto al nombre del enlace:
 
 
{{Warning|En caso de instalación manual o actualización desde una versión de '''Pandora FMS''' anterior a la '''732''', será necesario instalar '''SDK''' para el correcto funcionamiento de VMWare.}}
 
 
 
A partir de la versión de Pandora FMS 7.0-732 se pueden monitorizar infraestructuras VMware utilizando Discovery Applications.
 
 
 
  
 
<center>
 
<center>
[[File:discoveryapplications2.png]]
+
[[image:Autorefresh count down pandora v5.png|center]]
 
</center>
 
</center>
  
  
Se debe de especificar:
+
Tenga en cuenta que solo es posible usar esta funcionalidad en las siguientes páginas, el resto está deshabilitado para evitar conflictos y pérdidas de datos al editar formularios. La lista de permitidas es:
  
* Un nombre para identificar la tarea.
+
* '''Vista táctica'''
* Un servidor Discovery donde ejecutarlo.
+
* '''Detalles de grupo'''
* Un grupo al que se asociarán los agentes generados por la tarea VMware.
+
* '''Detalle de agente'''
 +
* '''Detalle de alerta'''
 +
* '''Detalle de monitor'''
 +
* '''Vista de servicio'''
 +
* '''Dashboard'''
 +
* '''Vista de eventos'''
 +
* '''Consola de traps SNMP'''
 +
* '''Mapa de red'''
 +
* '''Vista de cluster'''
 +
* '''Vista de gráficas'''
 +
* '''Consolas visuales'''
  
{{Tip|Se debe tener  en cuenta que si el servidor de Pandora FMS tiene activo el token ''autocreate_group'', se dará prioridad al grupo correspondiente al ID indicado, en vez de aplicar la configuración del asistente.}}
+
<br><br>
  
 +
La barra de búsqueda permite buscar términos en los mapas, informes, gráficas, alertas, usuarios, agentes y políticas. Se muestra un resumen de los elementos encontrados. La información se muestra clasificada en pestañas para cada tipo de dato, estando la pestaña de agente seleccionada de forma predeterminada:
  
Los datos necesarios para monitorizar VMware son:
+
<br><br>
 
 
* V-Center IP
 
* El nombre del datacenter (se puede ver a través de la pantalla de administración de la instalación de VMware).
 
* Usuario con permisos de lectura.
 
* Contraseña del usuario.
 
* Intervalo de la monitorización.
 
 
 
Se puede habilitar el cifrado de contraseñas pulsando el botón '''encriptar contraseñas'''. Sólo aplica al asistente en curso.
 
 
 
 
 
En la siguiente página se pueden especificar los detalles de la monitorización de VMware:
 
 
 
 
<center>
 
<center>
[[File:discoveryapplications3.png]]
+
[[image:newsearch2.JPG|center|800px]]
 
</center>
 
</center>
 +
<br><br>
  
* Max threads: Se elige el número de hilos que utilizará el script de monitorización VMware para agilizar la obtención de datos.
+
El enlace directo a los eventos es el mismo que el que proporciona el menú Operación. Este muestra los eventos en el sistema y permite gestionarlos en caso de tener suficientes permisos. La gestión de eventos se explica en el capítulo Gestión de la aplicación.
* Retry send: La información de los agentes detectados se envía por XML al DataServer. Se debe de activar esta opción para reintentar los envíos en caso de error.
 
* Event mode: '''Solo para VCenter'''. Se habilita la monitorización basada en eventos del VMware VCenter. Este modo de trabajo es exclusivo e independiente de la monitorización estándar.
 
* Virtual network monitoring: Habilita la monitorización de los dispositivos de red virtuales definidos en VMware.
 
* Extra settings: Se deben incluir aquí, en modo texto, cualquier configuración avanzada que sea necesaria para personalizar la monitorización de VMware.  
 
  
Para más información, visite [https://pandorafms.com/docs/index.php?title=Pandora:Documentation_es:Monitorizacion_entornos_Virtuales#Renombrado_de_entidades esta sección].
+
== Iconos en la interfaz de Pandora FMS ==
<br>
 
<br>
 
<br>
 
<br>
 
 
 
==Discovery Applications: MS SQL==
 
<br>
 
Esta nueva integración de Pandora FMS permite monitorizar bases de datos de Microsoft SQL server.
 
  
Será necesario tener instalado el <b>ODBC</b> de Microsoft en el sistema donde corre el servidor de Pandora FMS.  
+
En Pandora FMS existen bastantes iconos junto a textos, junto a otros iconos, solos, etc. En esta sección se explican los más importantes.
<br>
 
<br>
 
{{Tip|A partir de la versión 745, ODBC vendrá preinstalado en la ISO de Pandora FMS.}}
 
  
=== Cómo instalar el ODBC de Microsoft ===
+
=== Icono de ayuda contextual ===
 
 
* En <b>CentOS 6</b>:
 
 
 
curl https://packages.microsoft.com/config/rhel/6/prod.repo > /etc/yum.repos.d/mssql-release.repo && \
 
yum remove unixODBC-utf16 unixODBC-utf16-devel && \
 
ACCEPT_EULA=Y yum install -y msodbcsql17
 
 
 
* En <b>CentOS 7</b>:
 
 
 
curl https://packages.microsoft.com/config/rhel/7/prod.repo > /etc/yum.repos.d/mssql-release.repo && \
 
yum remove unixODBC-utf16 unixODBC-utf16-devel && \
 
ACCEPT_EULA=Y yum install -y msodbcsql17
 
 
 
Una vez instalado el ODBC podría ser necesario indicar a Pandora FMS qué driver utilizar. Para ello tendremos que revisar el fichero de configuración del servidor de Pandora FMS.
 
 
 
/etc/pandora/pandora_server.conf
 
 
 
Una vez en el fichero de configuración, buscaremos el siguiente token:
 
 
 
mssql_driver CADENA IDENTIFICATIVA
 
 
 
El parámetro <b>CADENA IDENTIFICATIVA</b> se puede encontrar en <b>/etc/odbcinst.ini</b> que se creará al instalar ODBC.
 
 
 
Por defecto esta cadena es:
 
 
 
ODBC Driver 17 for SQL Server
 
 
 
=== Configurar una tarea de Discovery Applications MS SQL ===
 
 
 
Para crear una tarea de monitorización para una base de datos Microsoft SQL Server tendremos que acceder a través de Discovery (Discovery -> Applications -> Miscrosoft SQL Server).
 
 
 
Una vez elegimos la tarea de Microsoft SQL Server podremos definir las instancias de la siguiente forma:
 
 
 
IP\Instancia
 
 
 
Si se quiere definir un puerto se hará así:
 
 
 
IP:Puerto\Instancia
 
 
 
<center>
 
[[File:mssql1.png]]
 
</center>
 
 
 
 
 
Las opciones avanzadas de configuración de esta integración incluyen estabilidad del servicio, estadísticas de uso, estado de conexiones y consultas personalizadas.
 
 
 
<center>
 
[[File:mssql3.png]]
 
</center>
 
 
 
Si se quiere ejecutar alguna consulta personalizada, deberá tenerse en cuenta que siguen el mismo formato que las de Oracle.
 
 
 
=Discovery Cloud=
 
 
 
Discovery Cloud permite monitorizar estructuras en la nube de AWS. Gracias a Pandora FMS se pueden gestionar multitud de cuentas de Amazon Web Services así como de Microsoft Azure, concentrando así la gestión de la información en una única herramienta. 
 
 
 
<center>
 
[[File:azure66.JPG]]
 
</center>
 
 
 
La gestión de  todas las cuentas, tanto de AWS como de Microsoft Azure, se hará a través de la <b>Credential Store</b> ubicada en Profiles -> Manage agent groups -> Credential Store.
 
  
 +
El icono de ayuda contextual representa una ayuda general sobre el campo al que acompaña o el formulario o página en el que está. Abre una ventana emergente (se deberán tener activadas las ventanas emergentes en el navegador) y proporciona una ayuda completa.
 +
<br><br>
 
<center>
 
<center>
[[File:credential_store.png]]
+
[[image:Icono.jpg|40px|center]]
</center>
+
</center><br>
 
 
==Discovery Cloud: Amazon Web Services (AWS)==
 
 
 
{{Warning|Esta sección se encuentra en construcción.}}
 
 
 
Para monitorizar una infraestructura en Amazon Web Services se deberán seguir paso a paso las diferentes páginas del asistente.
 
 
 
 
 
=== AWS. Validación de credenciales ===
 
 
 
 
 
Pandora FMS permite la gestión de varias cuentas de AWS. Una vez se accede al menú de Amazon Web Services la navegación se redirigirá automáticamente a la ventana para seleccionar la cuenta con la que se necesite acceder al servicio. En caso de existir alguna cuenta previamente creada en versiones anteriores de Pandora FMS, esta se mostrará como "imported_aws_account".
 
 
 
<center>
 
[[File:AWSCredentials1.JPG]]
 
</center>
 
 
 
Se pueden añadir tantas cuentas como sea necesario a través de la opción "Manage Accounts" que se encuentra junto al desplegable de AWS Account.
 
 
 
Esto permitirá acceder a la sección "Credential store" de Profiles > Manage agent groups y que hará las veces de almacén de todas las cuentas de Amazon Web Services previamente creadas y que se quieran registrar.
 
 
 
<center>
 
[[File:AWS4.png]]
 
</center>
 
 
 
<center>
 
[[File:AWS5.png]]
 
</center>
 
 
 
Las cuentas de consulta en Amazon AWS se deben crear con los siguientes permisos:
 
 
 
<center>
 
[[File:awsgrants.png]]
 
</center>
 
 
 
* Billing (read)
 
* CloudWatch (list,read)
 
* Cost Explorer Service (Full access)
 
* EC2 (full read, limited: list)
 
 
 
 
 
Resumen de la política en JSON:
 
 
 
{
 
    "Version": "2012-10-17",
 
    "Statement": [
 
        {
 
            "Sid": "VisualEditor0",
 
            "Effect": "Allow",
 
            "Action": [
 
                "ec2:DescribeInstances",
 
                "ec2:DescribeVolumesModifications",
 
                "ec2:GetHostReservationPurchasePreview",
 
                "ec2:DescribeSnapshots",
 
                "aws-portal:ViewUsage",
 
                "ec2:DescribePlacementGroups",
 
                "ec2:GetConsoleScreenshot",
 
                "ec2:DescribeHostReservationOfferings",
 
                "ec2:DescribeInternetGateways",
 
                "ec2:GetLaunchTemplateData",
 
                "ec2:DescribeVolumeStatus",
 
                "ec2:DescribeScheduledInstanceAvailability",
 
                "ec2:DescribeSpotDatafeedSubscription",
 
                "ec2:DescribeVolumes",
 
                "ec2:DescribeFpgaImageAttribute",
 
                "ec2:DescribeExportTasks",
 
                "ec2:DescribeAccountAttributes",
 
                "aws-portal:ViewBilling",
 
                "ec2:DescribeNetworkInterfacePermissions",
 
                "ec2:DescribeReservedInstances",
 
                "ec2:DescribeKeyPairs",
 
                "ec2:DescribeNetworkAcls",
 
                "ec2:DescribeRouteTables",
 
                "ec2:DescribeReservedInstancesListings",
 
                "ec2:DescribeEgressOnlyInternetGateways",
 
                "ec2:DescribeSpotFleetRequestHistory",
 
                "ec2:DescribeLaunchTemplates",
 
                "ec2:DescribeVpcClassicLinkDnsSupport",
 
                "ec2:DescribeVpnConnections",
 
                "ec2:DescribeSnapshotAttribute",
 
                "ec2:DescribeVpcPeeringConnections",
 
                "ec2:DescribeReservedInstancesOfferings",
 
                "ec2:DescribeIdFormat",
 
                "ec2:DescribeVpcEndpointServiceConfigurations",
 
                "ec2:DescribePrefixLists",
 
                "cloudwatch:GetMetricStatistics",
 
                "ec2:GetReservedInstancesExchangeQuote",
 
                "ec2:DescribeVolumeAttribute",
 
                "ec2:DescribeInstanceCreditSpecifications",
 
                "ec2:DescribeVpcClassicLink",
 
                "ec2:DescribeImportSnapshotTasks",
 
                "ec2:DescribeVpcEndpointServicePermissions",
 
                "ec2:GetPasswordData",
 
                "ec2:DescribeScheduledInstances",
 
                "ec2:DescribeImageAttribute",
 
                "ec2:DescribeVpcEndpoints",
 
                "ec2:DescribeReservedInstancesModifications",
 
                "ec2:DescribeElasticGpus",
 
                "ec2:DescribeSubnets",
 
                "ec2:DescribeVpnGateways",
 
                "ec2:DescribeMovingAddresses",
 
                "ec2:DescribeAddresses",
 
                "ec2:DescribeInstanceAttribute",
 
                "ec2:DescribeRegions",
 
                "ec2:DescribeFlowLogs",
 
                "ec2:DescribeDhcpOptions",
 
                "ec2:DescribeVpcEndpointServices",
 
                "ce:GetCostAndUsage",
 
                "ec2:DescribeSpotInstanceRequests",
 
                "cloudwatch:ListMetrics",
 
                "ec2:DescribeVpcAttribute",
 
                "ec2:GetConsoleOutput",
 
                "ec2:DescribeSpotPriceHistory",
 
                "ce:GetReservationUtilization",
 
                "ec2:DescribeNetworkInterfaces",
 
                "ec2:DescribeAvailabilityZones",
 
                "ec2:DescribeNetworkInterfaceAttribute",
 
                "ce:GetDimensionValues",
 
                "ec2:DescribeVpcEndpointConnections",
 
                "ec2:DescribeInstanceStatus",
 
                "ec2:DescribeHostReservations",
 
                "ec2:DescribeIamInstanceProfileAssociations",
 
                "ec2:DescribeTags",
 
                "ec2:DescribeLaunchTemplateVersions",
 
                "ec2:DescribeBundleTasks",
 
                "ec2:DescribeIdentityIdFormat",
 
                "ec2:DescribeImportImageTasks",
 
                "ec2:DescribeClassicLinkInstances",
 
                "ec2:DescribeNatGateways",
 
                "ec2:DescribeCustomerGateways",
 
                "ec2:DescribeVpcEndpointConnectionNotifications",
 
                "ec2:DescribeSecurityGroups",
 
                "ec2:DescribeSpotFleetRequests",
 
                "ec2:DescribeHosts",
 
                "ec2:DescribeImages",
 
                "ec2:DescribeFpgaImages",
 
                "ec2:DescribeSpotFleetInstances",
 
                "ec2:DescribeSecurityGroupReferences",
 
                "ec2:DescribeVpcs",
 
                "ec2:DescribeConversionTasks",
 
                "ec2:DescribeStaleSecurityGroups",
 
                "ce:GetTags"
 
            ],
 
            "Resource": "*"
 
        }
 
    ]
 
}
 
 
 
 
 
Se debe de asignar la política a un usuario nuevo.
 
 
 
<center>
 
[[File:awsgrants2.png]]
 
</center>
 
 
 
 
 
De vuelta en Pandora FMS, se podrá usar la cuenta registrada para vincularla y poder acceder a la monitorización de AWS.
 
 
<br>
 
<br>
{{Tip|Si no se dispone de pandora-cm-api en la instalación, se puede obtener del siguiente enlace: [https://pandorafms.com/library/pandora-cloud-monitoring-api/]}}
 
  
 +
=== Icono de sugerencia o consejo ===
  
===Discovery Cloud. AWS===
+
El icono de sugerencia o consejo proporciona una pequeña ayuda acerca del campo al que acompaña. Esta se muestra al posar el ratón encima del icono.
 
 
Una vez validadas las credenciales, se accederá al menú de <i>Discovery Cloud => Amazon Web Services</i>
 
  
 +
<br><br>
 
<center>
 
<center>
[[File:AWS6.png]]
+
[[image:Estrella.jpg|center]]
 
</center>
 
</center>
 +
<br><br>
  
En esta sección de encuentran Amazon EC2 y Amazon RDS. Por cada cuenta que se añada a la "Credential store" se podrá monitorizar una instancia de EC2, pero tantas como se deseen de RDS.
+
=== Icono de gestión ===
<br>
 
{{Tip|Solo se puede tener activa una tarea de reconocimiento por cuenta de AWS. La cuenta será la misma para todas las tecnologías monitorizadas dentro del proveedor.}}
 
 
 
 
 
===Discovery Cloud. AWS.EC2===
 
 
 
Dentro de la monitorización de EC2 se puede encontrar:
 
 
 
* Monitorización de costes.
 
* Resumen de recursos registrados en AWS.EC2.
 
* Monitorización de instancias específicas.
 
* Monitorización de volúmenes y direcciones IP elásticas.
 
  
Para iniciar el proceso de monitorización se solicitan una serie de datos básicos:
+
El icono de gestión acompaña a algunas filas de algunas tablas y representa un enlace directo a la configuración del elemento. Para acceder a la página que enlaza se debe pulsar sobre él.
  
 +
<br><br>
 
<center>
 
<center>
[[File:cloud3.png]]
+
[[image:Mango.jpg|40px|center]]
 
</center>
 
</center>
 +
<br><br>
  
Se necesitará un nombre para la tarea, indicar el servidor Discovery desde donde se ejecutará y el intervalo de la monitorización.
+
=== Icono de pantalla completa ===
 
 
====Discovery Cloud AWS.EC2 Costes====
 
 
 
Al pulsar siguiente, se pasará a configurar la monitorización de costes de AWS:
 
 
 
{{warning|La monitorización de costes de Amazon Web Services supone costes extra. En el siguiente enlace se puede obtener más información al respecto [https://aws.amazon.com/aws-cost-management/pricing/|Amazon cost management pricing]}}
 
  
La monitorización de costes proporciona un intervalo independiente de monitorización para evitar cargos extra.
+
Presente en secciones principalmente visuales para mostrar la información en pantalla completa ocultando los menús.
  
 +
<br><br>
 
<center>
 
<center>
[[File:cloud4.png]]
+
[[image:Flecha.jpg|center]]
 
</center>
 
</center>
 +
<br><br>
  
Se puede monitorizar tanto el coste global como los costes independientes por región.
+
=== Icono de varita mágica (Wizard) ===
 
 
 
 
====Discovery Cloud AWS.EC2 Resumen====
 
 
 
Se puede configurar la tarea Discovery para recolectar información general del estado de reservas en todas las regiones.
 
  
Para habilitarlo, se debe de activar la opción de ''Scan and general monitoring''.
+
El icono de la varita mágica o wizard indica que la funcionalidad servirá para aplicar de manera sencilla (mediante un asistente) a un gran número de items una acción.  
  
 +
<br><br>
 
<center>
 
<center>
[[File:cloud5.png]]
+
[[image:Magica.jpg|center]]
 
</center>
 
</center>
 +
<br><br>
  
Se puede agregar contadores genéricos de uso de CPU, operaciones de entrada salida (disco), volumen de datos transferidos (bytes) de disco y de red.
+
=== Icono de edición de la configuración remota ===
 
 
 
 
 
 
====Discovery Cloud AWS.EC2 Monitorización de instancias específicas====
 
 
 
Se puede monitorizar instancias específicas para obtener lecturas de:
 
 
 
* CPUUtilization: Uso promedio de CPU
 
* DiskReadBytes: Bytes de lectura (disco)
 
* DiskWriteBytes: Bytes de escritura (disco)
 
* DiskReadOps: Operaciones de lectura (disco)
 
* DiskWriteOps: Operaciones de escritura (disco)
 
* NetworkPacketsIn: Paquetes de entrada (red)
 
* NetworkPacketsOut: Paquetes de salida (red)
 
 
 
Los agentes que representan las instancias específicas tendrán como padre el agente que representa la región en la que se alojan.
 
  
Se debe verificar que se tiene configurado el token ''update_parent'' a 1 en la configuración del servidor de Pandora FMS para mantener las relaciones padre-hijo actualizadas.
+
Para editar remotamente el fichero de configuración de los agentes software:
 
 
Se debe navegar por el explorador seleccionando las instancias que se necesite monitorizar:
 
  
 +
<br><br>
 
<center>
 
<center>
[[File:cloud6.png]]
+
[[image:Oso.jpg|center]]
 
</center>
 
</center>
 +
<br><br>
  
 +
=== Icono de forzar acción ===
  
====Discovery Cloud AWS.EC2 Extras====
+
Las comprobaciones remotas de Pandora FMS tienen un intervalo de actualización, pero este se puede forzar pulsando sobre el botón en cuestión.
 
+
<br><br>
En esta última pantalla se puede indicar si se desea monitorizar los volúmenes que utilizan las instancias reservadas.
 
 
 
Aparecerán dos módulos extra en los agentes de región:
 
 
 
* Total de volumen reservado (GB)
 
* Total de volúmenes registrados (número)
 
 
 
 
 
También se pueden elegir activar el token ''Elastic IP addresses''. Se informará del número de IP elásticas registradas en la cuenta AWS.EC2.
 
 
 
 
<center>
 
<center>
[[File:cloud7.png]]
+
[[image:Force.JPG|center]]
 
</center>
 
</center>
 +
<br><br>
  
 +
=== Icono de refresco (tras forzar acción)===
  
Una vez completado el asistente, se podrá ver el progreso de la ejecución en ''Discovery Task list:''
+
Una vez que se ha pulsado el icono de forzar acción, este cambia para indicar que se ha pulsado sobre él.
 
+
<br><br>
 
<center>
 
<center>
[[File:tasklist1.png]]
+
[[image:Toner.jpg|center]]
 
</center>
 
</center>
 +
<br><br>
 +
Volverá a su estado normal una vez que se actualice la comprobación.
  
===Discovery Cloud. AWS.RDS===
+
=== Textos alternativos en los iconos/imágenes al posar el ratón ===
 
 
AWS RDS permite monitorizar las bases de datos relacionales que provee Amazon Web Services.
 
 
 
El servicio RDS provee un servidor de base de datos y permite crear la instancia relacionada a dicha base de datos. Asimismo, RDS ofrece la posibilidad de conectar a sus instancias por medio de clientes como SSMS, MySQL workbench o mediante JDBC u ODBC DB APIs.
 
  
 +
Prácticamente todas las imágenes de Pandora FMS tienen un texto alternativo que se muestra al posar el ratón encima de ellas; de esta forma se puede obtener contexto acerca de estas imágenes:
 +
<br><br>
 
<center>
 
<center>
[[File:AWS8.JPG]]
+
[[image: Raton.jpg|center]]
 
</center>
 
</center>
 +
<br><br>
  
A través de Pandora FMS se pueden monitorizar diferentes estancias RDS rellenando los parámetros indicados en el menú que se muestra en la parte superior.
+
== Gestión de servidores ==
  
La integración de AWS RDS con Pandora FMS nos permite monitorizar tanto el origen de los datos como su disponibilidad.  
+
La vista detallada de los servidores se utiliza para conocer, además del estado general de los servidores de Pandora FMS, su nivel de carga y retraso en las ejecuciones.
  
Además se puede monitorizar la base de datos que corra por debajo de RDS sacando todas las métricas que podrían monitorizarse en una base de datos de forma habitual.  
+
Algunos iconos tienen especial relevancia, tal como se ven en la captura de arriba:
 +
 
 +
* Poll request: Solicita al servidor de pruebas remotas que ejecute todos los chequeos que tenga, forzando a ejecutarlas otra vez. Válido para todos los servidores de red, por ejemplo Network server, WMI server, Plugin server, WEB Server, etc. 
 +
* Editar tareas del recon server. 
 +
* Editar configuración remota del servidor. Válido para servidores de Pandora FMS o de satélite server.  
  
{{Warning|La integración con AWS RDS sólo soporta <b>Oracle</b>, <b>MySQL</b> y <b>Mariadb</b>.}}
+
En esta vista podemos ver distinta información en cada columna: 
  
===Discovery Cloud. Vista general===
+
* '''Nombre del servidor:''' Generalmente usa el hostname de la máquina. 
 +
* '''Estado:''' (verde = activo, gris = parado o caído).
 +
* '''Tipo de servidor:''' Data server, network server, etc. 
 +
* '''Versión:''' Muestra la versión actual de nuestro servidor de Pandora FMS. 
 +
* '''Módulos:''' Nº de módulos de ese tipo ejecutados por el servidor respecto al nº total de módulos de este tipo. 
 +
* '''Server Lag / Módulos atrasados:''' Tiempo más alto que lleva el módulo más antiguo esperando a recibir datos / Nº de módulos que están fuera de su tiempo de vida. Este indicador sirve para conocer si tenemos muchos módulos y saber si el servidor está al límite de su capacidad de carga. Delayed modules (módulos atrasados) nos indica la cantidad de módulos que no han reportado al servidor. 
 +
* '''T/Q (Current threads/queued modules currently):''' Muestra el número de hilos activos actualmente en cada servidor. Nº total de módulos en cola a espera de ser atendidos. Estos parámetros reflejan estados de carga excesiva. No debería haber casi nunca módulos en cola; esto refleja la incapacidad del servidor para procesar los datos. 
 +
* '''Actualización de datos:''' Cada servidor tiene un "Keepalive" que actualiza su estado, para asegurarse de que está activo, actualizando además sus estadísticas.
 +
                   
  
Discovery Cloud incluye una vista general donde revisar los puntos claves de la infraestructura en Amazon Web Services. Pandora FMS permite mostrar diferentes mapas en función de las cuentas existentes.
 
  
En la vista de AWS se podrá seleccionar la cuenta de la que se quiera mostrar la información:
 
 
<center>
 
[[File:AWS9.JPG]]
 
</center>
 
  
Incluye:
+
== Estados y posibles valores de los agentes, módulos y grupos ==
  
* Coste actual
+
Los agentes contienen módulos con los diferentes chequeos que realizan. Sus estados pueden ser:
* Coste en el periodo previo
 
* Gráfica de evolución de costes (6 meses)
 
* Gráfica de evolución de reservas/instancias (1 mes)
 
* Mapa de regiones con el número de instancias por región.
 
  
<center>
+
* '''Correcto:''' color verde.
[[File:awsview.png]]
+
* '''Advertencia/aviso:''' color amarillo.
</center>
+
* '''Crítico:''' color rojo.
 +
* '''Desconocido:''' color gris.
 +
* '''No inicializado:''' No se visualiza. Aparece con color azul solo en la vista de gestión.
  
 +
Esta sería una vista de datos de un agente, lo que en Pandora FMS se llaman módulos. En ella se muestra el nombre del módulo, su estado (con un recuadro de color), y su valor numérico o alfanumérico.
  
==Discovery Cloud: Microsoft Azure==
 
 
<br>
 
<br>
Para monitorizar una infraestructura en Microsoft Azure se deberán seguir paso a paso las siguientes instrucciones.
 
<br>
 
===¿Cómo dar de alta un usuario para usar la API de Azure?===
 
 
* Acceder a https://portal.azure.com/#home
 
* Abrir el servicio "Azure Active Directory"
 
 
 
<center>
 
<center>
[[File:azure.png]]
+
[[image:Modulos_descr.jpg|center|800px]]
 
</center>
 
</center>
 +
<center>''Vista de datos de un agente''</center>
 +
<br>
  
* Ir a 'App registrations' > 'New registration'
+
Existen las vistas detalladas de agente, que resumen de un vistazo el estado del agente "en conjunto" y el estado resumido de sus módulos. En esta vista, vemos varios agentes en diferentes estados:
 
 
<center>
 
[[File:azure2.png]]
 
</center>
 
 
 
 
 
* Introducir los datos.
 
  
 +
<br>
 
<center>
 
<center>
[[File:azure3.png]]
+
[[image:If5.JPG|center|850px]]
 
</center>
 
</center>
 
+
<center>''Vista de agentes''</center>
 
 
* Será necesario apuntar los datos "client_id" y "directory".
 
 
 
<center>
 
[[File:azure4.png]]
 
</center>
 
 
 
* A continuación se accederá a 'certificates & secrets' y se creará uno nuevo:
 
 
 
<center>
 
[[File:azure5.png]]
 
</center>
 
 
 
{{Warning|Será necesario apuntar la clave que se muestra, es el application_secret.}}
 
 
 
===Asignación de permisos===
 
 
 
Será necesario asignar un rol a la cuenta con la que se vaya a operar (app). Para ello habrá que acceder a "home" y entrar en la suscripción.
 
<center>
 
[[File:azure6.png]]
 
</center>
 
 
 
 
 
Dentro de la suscripción, se seleccionará "Access control (IAM)".
 
 
 
<center>
 
[[File:azure7.png]]
 
</center>
 
 
 
Se agregará una nueva asignación de rol en la que se seleccionará el rol "reader" para la app creada.
 
 
 
<center>
 
[[File:azure8.png]]
 
</center>
 
 
 
Es importante que se guarden los cambios pulsando "save".
 
 
 
 
 
A partir de este momento se podrá conectar con el servicio y hacer solicitudes a través de pandora-cm-api.
 
 
 
====Ejemplos====
 
 
 
Se podría comprobar el estado de Azure desde Pandora FMS como sigue:
 
 
 
* Precargar el entorno.
 
* Ejecutar . load_env.sh
 
* pandora-cm-api --product Azure --get availability
 
 
 
 
 
En caso de que nuestro entorno esté operativo, el sistema debería devolver una respuesta de 1.
 
 
 
Un ejemplo de contenido del script load_env.sh sería el siguiente:
 
 
<br>
 
<br>
* Azure
 
  
<pre>
+
Los agentes reflejarán en su estado la situación más grave de sus módulos, por lo que si hay uno solo en estado crítico, el agente se mostrará en color rojo.
export CLIENT_ID=XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX
 
  
export DOMAIN=XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX
+
'''Vista de grupos'''
  
export APPLICATION_SECRET="XXXXXXXXXXXXXXXXXXXXXXXXX"
+
De la misma forma tenemos la vista de grupos que resume el estado de un grupo de agentes.
  
export AZURE_SUBSCRIPTION_ID=XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXX
+
En esta vista un grupo puede tener los siguientes estados:
</pre>
 
  
===Configurar la tarea en Pandora FMS===
+
* '''Correcto''': (color verde). Todos sus agentes están en estado correcto.
 +
* '''Advertencia/aviso''': (color amarillo). Al menos uno de sus agentes está en estado de advertencia.
 +
* '''Crítico''': (color rojo). Al menos uno de sus agentes está en estado crítico.
 +
* '''Desconocido''': (color gris). Todos sus agentes están en estado desconocido.
 +
* '''Sin módulos''': (color blanco). Cuando los agentes del grupo no tienen módulos o estos no están inicializados.
  
 +
'''Vista de módulos'''
  
Pandora FMS permite la gestión de varias cuentas de Microsoft Azure.
+
En esta vista podrá ver un listado con todos los módulos de todos los agentes. En ella se muestra el estado del módulo con el código de colores arriba explicado.
  
Se pueden añadir tantas cuentas como sea necesario a través de la opción "Manage Accounts" que se encuentra junto al desplegable de Account.
+
Esta vista es muy útil para comparar la información de módulos de diferentes agentes gracias a sus opciones de filtrado.
  
Esto permitirá acceder a la sección "Credential store" de Profiles -> Manage agent groups y que hará las veces de almacén de todas las cuentas de Microsoft Azure previamente creadas y que se quieran registrar.
+
== Caja de agente de autocompletado ==
  
Para configurar una nueva tarea, habrá que seguir los siguientes pasos:
+
En varias secciones de Pandora FMS podremos ver un control como el siguiente:
 
 
* Se agregará una nueva clave a la "credential store".
 
 
 
<center>
 
[[File:azure9.png]]
 
</center>
 
 
 
 
 
 
 
* Será necesario acceder a 'Discovery > Cloud > Azure' y validar la cuenta de Azure.
 
 
 
 
 
<center>
 
[[File:azure10.png]]
 
</center>
 
 
 
 
 
<center>
 
[[File:azure11.png]]
 
</center>
 
 
 
 
 
<center>
 
[[File:azure12.png]]
 
</center>
 
 
 
* A partir de este punto será necesario definir el nombre que tendrá nuestra tarea de reconocimiento, el servidor que ejecutará la tarea, el grupo al que pertenecerá y el intervalo de ejecución.
 
 
 
<center>
 
[[File:AzureX3.PNG]]
 
</center>
 
 
 
* Una vez definidos los datos de la tarea, seleccionaremos las regiones de nuestra cuenta de Azure que queramos monitorizar. Cada región nos permitirá a su vez seleccionar las instancias deseadas.
 
 
 
<center>
 
[[File:AzureX4.PNG]]
 
</center>
 
 
 
* El último paso será seleccionar las métricas que queramos obtener de los agentes que Pandora FMS creará por cada instancia que encuentre en Microsoft Azure. Una vez configurada esta sección, se podrá lanzar la tarea y Pandora FMS creará de forma automática los agentes en función de las instancias solicitadas en los pasos previos.
 
 
 
<center>
 
[[File:AzureX5.PNG]]
 
</center>
 
  
 
<br>
 
<br>
 
=Discovery Console Tasks=
 
 
De manera prácticamente idéntica a lo visto anteriormente en Task List, Console Task permitirá crear nuevas tareas teniendo en cuenta los siguientes parámetros:
 
 
* Task: La tarea que se ejecutará de entre las siguientes:
 
** Backup Pandora FMS database.
 
** Execute custom script.
 
** Save custom report to disk.
 
** Save custom XML report to disk.
 
** Send custom report (from template) by email.
 
** Send custom report by email.
 
 
* Scheduled: Sirve para especificar cada cuánto tiempo se ejecutará la tarea.
 
* Next execution: Nos muestra la fecha de la siguiente ejecución, pudiendo modificarla si fuese necesario.
 
* Group: Grupo al que pertenece la tarea.
 
* Parameters: Son los parámetros específicos de cada tarea.
 
 
 
<center>
 
<center>
[[File:ConsoleTasks.JPG]]
+
[[File:Agent autocomplete.png]]
 
</center>
 
</center>
 
====Parámetros de las diferentes tareas====
 
 
<br>
 
<br>
;Backup Pandora FMS database:
 
* Description: Descripción de la copia de seguridad.
 
* Save to disk in path: ruta en la que se almacenará el backup.<br><br>
 
;Execute custom script:
 
* Custom script: Se indicará el script que se quiere ejecutar.<br> <br>
 
;“Save custom report to disk” y “Save custom XML report to disk”:
 
* Report pending to be created: El informe que queremos crear.
 
* Save to disk in path: Ruta donde se almacenará el informe creado.<br><br>
 
;Send custom report (from template) by email:
 
* Template pending to be created: Plantilla personalizada que se quiere crear.
 
* Agents: Agentes de los que se obtendrá la información que se verá reflejada en el informe.
 
* Report per agent: Si se desea generar informes separados para cada informe.
 
* Report name: Nombre que se desee dar al informe.
 
* Send to email addresses: Direcciones de correo a las que se quiere enviar el informe.
 
* Subject: Tema del correo que se enviará.
 
* Message: Cuerpo del mensaje con el que se enviarán los informes.<br><br>
 
;Send custom report by email:
 
* Report pending to be created: Informe que se generará.
 
* Send to email addresses: Direcciones de correo a las que se quiere enviar el informe.
 
* Subject: Tema del correo que se enviará.
 
* Message: Cuerpo del mensaje con el que se enviarán los informes.
 
* Report Type: Tipo de informe que será enviado.
 
 
=Discovery Host&Devices=
 
 
La sección Host & Devices de Discovery ofrece multitud de opciones para ayudar a gestionar y descubrir dispositivos dentro de los entornos en que sea necesario.
 
 
Para ello cuenta con las siguientes herramientas:
 
 
* Net Scan.
 
* Agent deployment.
 
* Import CSV.
 
* Custom NetScan.
 
* Manage NetScan scripts.
 
 
 
<center>
 
[[File:DISCHost&Devices.JPG|800]]
 
</center>
 
 
==NetScan==
 
 
Con la herramienta NetScan se pueden descubrir dispositivos en una red y aplicarles diferentes reglas de monitorización.
 
 
Primero, se debe de definir el nombre de la tarea, el servidor Discovery que la ejecutará, el grupo al que se asignarán los agentes descubiertos y el intervalo de escaneo.
 
 
Además, se dispondrá de dos opciones a la hora de hacer la tarea de escaneo. Se pueden indicar las redes a descubrir en el espacio habilitado en ''Red'', o se puede habilitar el token ''Usar fichero CSV'' que permitirá cargar un archivo en formato csv con los dispositivos concretos a comprobar, o la red, en el reconocimiento. Si se selecciona el fichero csv la opción inferior Network no estará habilitada.
 
 
<center>
 
[[File:3oaKq2yukE.png]]
 
</center>
 
 
{{Warning|Los intervalos seleccionados como manuales deberán lanzarse manualmente. '''Discovery no lanzará una tarea manual automáticamente.'''}}
 
 
 
En el apartado de características, se pueden indicar las siguientes opciones:
 
 
<center>
 
[[File:Wvia6RtpOr2.png|800]]
 
</center>
 
 
 
* '''Autodescubrimiento de hardware conocido''': Aplica dinámicamente las plantillas añadidas previamente en la sección ''Private Enterprise Number''. Para más información vaya al siguiente [https://pandorafms.com/docs/index.php?title=Pandora:Documentation_es:Plantillas_y_Componentes#Private_Enterprise_Number| enlace.]
 
* '''Plantillas de módulos''': Intenta aplicar los módulos de las plantillas seleccionadas. Si la ejecución no pasa el test, no se agregarán a la lista de monitorización.
 
* '''Revisar resultados''': El usuario deberá validar los resultados seleccionando qué agentes se crearán de los encontrados por la tarea de descubrimiento.
 
* '''Aplicar normas de autoconfiguración''': Aplica las reglas de configuración automática definidas previamente a los agentes detectados. Para más información vaya al siguiente [https://wiki.pandorafms.com/index.php?title=Pandora:Documentation_es:Configuracion_Agentes#Configuraci.C3.B3n_autom.C3.A1tica_de_agentes| enlace.]
 
 
{{Tip|La configuración automática permite aplicar políticas, cambios de grupo y configuración, así como lanzar eventos personalizados o ejecutar scritps en acciones.}}
 
 
{{Tip|Los agentes detectados por NetScan son agentes remotos sin fichero de configuración. No podrá aplicar políticas de monitorización locales ni agregar cambios de configuración en bloque si no despliega un agente en los objetivos.}}
 
 
 
* '''SNMP activado''': Para completar la información obtenida de los dispositivos de red descubiertos se debe de habilitar SNMP. Con ello se mejora la detección escaneando la información SNMP disponible en los objetivos descubiertos. Al habilitar este token aparecerán dos opciones adicionales:
 
** '''Versión SNMP''': Se deberá seleccionar la versión SNMP configurada en los dispositivos de la red escaneada. Se soporta SNMP en sus versiones 1,2, 2c y 3.
 
** '''Comunidades SNMP''': Se deberá indicar la comunidad configurada en el entorno. Se pueden añadir tantas comunidades como se necesiten escribiéndolas en la recuadro contiguo.
 
 
* '''WMI habilitado''': Se puede habilitar el escaneo WMI. Simplemente se deben seleccionar las credenciales previamente cargadas en el [https://pandorafms.com/docs/index.php?title=Pandora:Documentation_es:Gestion_y_Administracion#Almac.C3.A9n_de_credenciales| almacén de claves.]
 
 
{{Tip|Se probarán las diferentes credenciales provistas contra los objetivos detectados que soporten WMI, complementando la monitorización con módulos que informarán sobre el uso de CPU, memoria y disco.}}
 
 
* '''Detección de SO''': Detectar el sistema operativo del objetivo.
 
 
* '''Resolución de nombres''': Resolver el nombre del objetivo.
 
 
* '''Detección de padres''': A través de la información recolectada mediante SNMP, se calcularán las diferentes interconexiones entre dispositivos, para poder representar su infraestructura de red.
 
 
* '''Recursión de padres''': Mejora la detección de padres agregando recursión al proceso.
 
 
* '''VLAN habilitada''': Detecta las VLAN a las que están conectados los diferentes dispositivos.
 
 
 
Una vez se complete el asistente, Discovery empezará a ejecutarlo en cada intervalo definido. Si el intervalo es manual se deberá iniciar manualmente la tarea:
 
 
<center>
 
[[File:AFgAv40l9Y.png|800]]
 
</center>
 
 
Una vez finalizada la tarea, si se accede desde Review, se verá un resumen de los dispositivos encontrados y que respondan a ping y al resto de métricas disponibles a través de SNMP o WMI. Se mostrarán todas las IPs, pero podrán tener dos estados:
 
* '''Deshabilitado''': ya existe un agente o módulo en el entorno monitorizándose y no se creará ni modificará.
 
* '''Habilitado''': se trata de un elemento nuevo que no se está monitorizando o dentro de las métricas que se obtienen ha respondido un nuevo módulo que se verá en un desplegable. En los dispositivos que se encuentren en este estado se podrá seleccionar  agregarlo a la lista de agentes monitorizados o si se quiere agregar alguna de las nuevas métricas habilitadas.
 
 
<center>
 
[[File:HK8XAXtv92.png]]
 
</center>
 
 
{{Tip|Una vez seleccionados los objetivos a monitorizar, el sistema los creará sistemáticamente. Durante este proceso, se detectará el S.O. del objetivo para complementar la información ya recabada.}}
 
 
==Despliegue automático de agentes==
 
 
{{Warning|Antes de usar esta característica confirme que dispone del comando '''winexe''' instalado en su equipo y funcionando correctamente. Este comando se provee con el servidor enterprise de Pandora FMS. Requiere las dependencias '''zlib.i686''' y '''glibc.i686''' para funcionar.}}
 
 
{{Warning|En entornos <b>Windows</b> se recomienda realizar la instalación como usuario administrador. Antes de iniciar el servicio será necesario definir una cuenta de administrador para su uso.}}
 
 
A partir de la versión 737 de Pandora FMS es posible desplegar agentes desde la consola utilizando la '''central de despliegues'''.
 
 
{{Warning|Será necesario que el servidor esté con la versión <b>EL7</b> para que el despliegue automático de agentes funcione.}}
 
 
[[File:Depl1.png]]
 
 
 
Los pasos para desplegar agentes desde la consola son:
 
 
'''Registrar las versiones de agentes software a desplegar en el repositorio de agentes.'''
 
 
Necesitará los instaladores de los agentes que quiera desplegar a lo largo de su infraestructura. Puede utilizar agentes personalizados.
 
 
Para más información acerca del uso del '''repositorio de agentes''' visite [https://pandorafms.com/docs/index.php?title=Pandora:Documentation_es:Gestion_y_Administracion#Repositorio_de_agentes_software este enlace]
 
 
 
'''Registrar las credenciales que se utilizarán para conectar a los objetivos en el administrador de credenciales.'''
 
 
Deberá especificar las credenciales con las que se testearán los accesos a los objetivos encontrados o especificados.
 
 
Para más información acerca del '''almacén de credenciales''' visite [https://pandorafms.com/docs/index.php?title=Pandora:Documentation_es:Gestion_y_Administracion#Almac.C3.A9n_de_credenciales este enlace]
 
 
 
'''Confirme que su entorno está preparado para el despliegue.'''
 
 
La primera vez que visite la central de despliegues verá los siguientes avisos:
 
 
[[File:depl_info1.png]]
 
 
Este mensaje indica que todavía no se han definido objetivos para el despliegue.
 
 
 
[[File:Depl_info2.png]]
 
 
En estos mensajes se indica:
 
 
El primer mensaje le indica que deberá configurar la URL de acceso público ''public_url'' para que los objetivos puedan conectar con la consola y configurarse.
 
 
{{Warning|Este sistema no realiza operaciones tipo PUSH; todos los despliegues se transmiten ''ofertando'' el software y ordenando al objetivo instalarlo.}}
 
 
 
En el segundo se indica que aún no ha agregado ningún instalador al repositorio de agentes. Deberá registrar instaladores para desplegar el software.
 
 
 
 
 
====Búsqueda de objetivos====
 
 
'''Buscar o indicar los objetivos en la central de despliegue.'''
 
 
Utilice cualquiera de los métodos descritos a continuación para registrar nuevos objetivos.
 
 
Puede utilizar cualquiera de las siguientes opciones para definir objetivos:
 
 
[[File:Depl_action_buttons.png]]
 
 
 
 
===== Escanear una o varias redes en busca de objetivos.=====
 
 
Al pulsar el botón de escanear objetivos se mostrará un pop-up con los siguientes campos:
 
 
[[File:Depl2.png]]
 
 
 
Deberá indicar:
 
 
* La red o redes (separadas por comas) a escanear.
 
* El servidor Discovery que realizará el escaneo.
 
* Las credenciales que se utilizarán para intentar conectar con los objetivos descubiertos.
 
* La versión del agente software que se registra como ''deseada'' para los objetivos descubiertos.
 
* La IP del servidor objetivo donde apuntarán estos agentes software cuando se instalen (se corresponde con el campo ''server_ip'' del fichero de configuración del agente).
 
 
 
Cuando pulse 'Escanear' recibirá una confirmación, con un enlace que puede seguir para consultar el progreso de esta tarea.
 
 
[[File:Depl_info3.png]]
 
 
 
En la lista de tareas aparecerá una nueva entrada:
 
 
[[File:Depl2b.png]]
 
 
 
{{Tip|Las tareas de Discovery relacionadas con el despliegue de agentes son tareas '''volátiles'''. Una vez concluidas se eliminarán automáticamente. La información acerca de un escaneo o despliegue, tanto satisfactorio como erróneo, podrá consultarla desde la propia central de despliegues.}}
 
 
 
 
Según vayan encontrándose posibles objetivos, irán apareciendo en la central de despliegues:
 
 
[[File:Depl3.png]]
 
 
 
{{Tip|Los objetivos descubiertos agregados a esta lista son todos los dispositivos encontrados cuyo sistema operativo coincide con Windows o sistemas basados en Linux/Unix, independientemente de que se hayan encontrado credenciales válidas o no}}
 
 
 
 
 
=====Definir manualmente un objetivo.=====
 
 
Puede registrar manualmente el objetivo definiendo:
 
 
* IP.
 
* Sistema operativo; en esta versión solo se permite Windows y aquellos basados en Linux/Unix (compatibles con el instalador tar.gz del agente).
 
* Arquitectura.
 
* Las credenciales que se utilizarán para conectar al objetivo.
 
* La versión del agente que desea desplegar.
 
* La dirección IP del servidor donde apuntará ese agente una vez instalado (se corresponde con el campo ''server_ip'' de la configuración del agente software).
 
  
[[File:Depl5.png]]
+
Este control nos permite, según va escribiendo, realizar un filtrado y mostrar los agentes que coinciden con la búsqueda, visualizándose por bloques como los siguientes:
 +
* '''Primer bloque de color verde''', los agentes que coinciden en el nombre con lo tecleado.
 +
* '''Segundo bloque de color amarillo''', los agentes que coinciden en la descripción con lo tecleado.
 +
* '''Tercer bloque de color morado''', los agentes que coinciden en la dirección con lo tecleado.
  
 +
{{Tip|Recuerde que el control empieza a funcionar a partir de los dos caracteres tecleados.}}
  
 +
== Tabla de interfaces de red ==
  
 +
Esta tabla puede aparecer en lugares como la vista general de un agente, la vista en detalle de un agente en la vista de árbol, ciertos tipos de informe, etc. Como su nombre indica, muestra información sobre las interfaces de red de un agente determinado.
  
 
=====Subir un archivo CSV con información de objetivos.=====
 
 
Si desea registrar objetivos de forma masiva, puede subir un archivo CSV con el siguiente formato:
 
 
 
IP; OS; Architecture; Target agent version; Credential identifier; Target server ip
 
 
 
[[File:Depl6.png]]
 
 
El sistema creará los objetivos basándose en lo definido en el CSV.
 
 
====Desplegar el software====
 
 
{{Warning|Solo podrá programar el despliegue contra objetivos cuya información sea completa, especificando tanto credenciales como versiones de software a desplegar}}
 
 
En el momento en que tenga posibles objetivos en la lista podrá lanzar el despliegue del agente:
 
 
[[File:Depl4.png]]
 
 
 
Seleccione las IP de los objetivos de la lista (solo aparecerán objetivos válidos) y presione ''desplegar''.
 
 
Automáticamente se creará una tarea Discovery para despliegue en segundo plano, que se encargará de instalar el agente en los objetivos deseados.
 
 
Podrá confirmar que el agente ha sido instalado satisfactoriamente desde la propia lista de objetivos de la central de despliegues:
 
 
[[File:Depl7.png]]
 
 
 
El nombre del objetivo también pasa a ser un enlace al agente de Pandora FMS correspondiente.
 
 
 
Ejemplo de error: El usuario no introdujo únicamente la IP del objetivo, sino también su máscara de red ('''CON LA IP ES SUFICIENTE''').
 
 
Cuando el sistema intente desplegar el software encontrará que el formato de la IP es incorrecto e informará al usuario:
 
 
[[File:Depl_err1.png]]
 
 
==Importar una lista de sus dispositivos en CSV==
 
 
Se puede importar un listado de dispositivos para representarlos como agentes utilizando el asistente de importación de agentes vía CSV.
 
 
{{Tip|Esta utilidad solo crea los agentes en Pandora FMS para su monitorización de forma remota}}
 
 
<center>
 
[[File:hostdevices2.png]]
 
</center>
 
 
Se debe seleccionar el separador utilizado, el servidor en el que se quiere importar y el archivo que contiene los datos, posteriormente se debe pulsar en ''siguiente''.
 
 
<center>
 
[[File:hostdevices3.png]]
 
</center>
 
 
==Custom NetScan==
 
 
Permite la ejecución de scripts personalizados para la ejecución de tareas de reconocimiento de red.
 
 
Será necesario la creación de una tarea de reconocimiento especificando:
 
 
* Task name: Nombre de la tarea de reconocimiento.
 
* Comment: Permite añadir comentarios.
 
* Discovery server: Servidor que ejecutará la tarea.
 
* Group: Grupo al que pertenece.
 
* Interval: Intervalo de ejecución.
 
 
<center>
 
[[File:DISC_NetScan_Custom_1.JPG]]
 
</center>
 
 
Una vez completado el proceso de creación de la tarea será necesario especificar el script que se quiera correr, así como el fichero de configuración necesario para su ejecución.
 
 
 
==Net scan scripts==
 
 
Esta sección nos mostrará los diferentes scripts que se hayan creado para las tareas de reconocimiento personalizadas. Se muestra una vista en la que se definen el nombre y la descripción de la tarea.
 
  
 
<center>
 
<center>
[[File:DISC_Net_scan_scripts.JPG]]
+
[[File:snmp-interface-table.png]]
 
</center>
 
</center>
  
Pandora FMS permite añadir scripts adicionales para facilitar la monitorización y el reconocimiento de las redes requeridas.
 
 
Los parámetros que se podrán definir son los siguientes:
 
  
* Name: Nombre del script.
+
Hay varias formas de hacer que se muestre esta tabla:
* Script fullpath: Ruta en la que se encuentra el script.  
+
* '''Script de reconocimiento''': [[Pandora:Documentation es:ReconServer#Script de Recon SNMP L2|Más información]]. Este script creará agentes y módulos, los cuales estarán preparados para mostrar correctamente la información en el caso de ser módulos de interfaces de red.
* Description: Descripción del script. Se pueden definir descripciones de los distintos campos, así como valores por defecto para los mismos.
 
* Hide value: Si se desea ocultar el valor de un campo.
 
* Help: Campos de ayuda.  
 
  
<center>
+
* '''Wizard de interfaces SNMP''': A través de una configuración sencilla, este asistente, que puede encontrarse en la vista de configuración de un agente, mostrará las interfaces encontradas y solo habrá que elegir los módulos a crear. Para que la interfaz aparezca en la tabla, será necesario al menos el módulo '''ifOperStatus'''. Para poder visualizar la gráfica de tráfico entrante y saliente de la interfaz, será necesario seleccionar los módulos '''ifInOctets''' e '''ifOutOctets'''.
[[File:DISC_Net_scan_scripts_2.JPG]]
 
</center>
 
  
La creación de scripts permite añadir macros con las que definir todos los parámetros que sean necesarios para la correcta ejecución del script.
+
* '''Creación manual''': Para que la interfaz aparezca en la tabla, habrá que crear un módulo siguiendo ciertas convenciones en el nombre. Este módulo debe llamarse '''''<nombre de la interfaz>''_ifOperStatus''' y debe ser de uno de estos tipos: ''remote_snmp_proc'', ''remote_icmp_proc'', ''remote_tcp_proc'', ''generic_proc''. Se recomienda usar el tipo ''remote_snmp_proc'' y atacar al ''OID'' de ''ifOperStatus'' de la interfaz (.1.3.6.1.2.1.2.2.1.8.<index>) para obtener su estado real. Para poder visualizar la gráfica de tráfico entrante y saliente, habrá que crear dos módulos de tipo ''remote_snmp_inc'' llamados '''''<nombre de la interfaz>''_ifInOctects''' e '''''<nombre de la interfaz>''_ifOutOctets'''. Estos módulos deben atacar a las ''OID'' .1.3.6.1.2.1.2.2.1.10.<index> y .1.3.6.1.2.1.2.2.1.16.<index>, respectivamente. Para que aparezca en la tabla información sobre la IP y la MAC de la interfaz, basta con meter esos dos datos en la descripción del módulo ''ifOperStatus'' creado anteriormente.
  
 
[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]
 
[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]
  
 
[[Category: Pandora FMS]]
 
[[Category: Pandora FMS]]
[[Category:Documentation]]
 

Revision as of 09:21, 3 June 2020

Volver a Indice de Documentacion Pandora FMS

1 Interfaz de Pandora FMS

1.1 Introducción

En este capítulo se explicarán algunas de las bases comunes de la interfaz de Pandora FMS.

1.2 Pantalla de inicio de sesión de Pandora FMS

En la siguiente imagen se muestra la pantalla de inicio de sesión de Pandora FMS:

If1.JPG


En ella aparece el número de versión de Pandora FMS, en la parte inferior.

En la parte central están las entradas de texto para el usuario y su contraseña, así como el botón de inicio de sesión (Login).

Una vez que se introduzcan las credenciales de inicio de sesión válidas, que por defecto, serían:

  • Usuario: admin.
  • Contraseña: pandora

De forma predeterminada, la consola mostrará la página principal de bienvenida de Pandora FMS. Aunque la página de inicio puede ser personalizada por el usuario, como se explica en el apartado Página de Inicio Personalizada

1.3 Página principal de Pandora FMS

La página principal por defecto de Pandora FMS muestra información básica y general acerca del estado de los sistemas y del número y tipo de comprobaciones que realiza Pandora FMS.

A continuación, se muestra la pantalla por defecto de Pandora FMS y sus elementos.



If2.JPG



Los elementos estáticos ─que no cambian entre las diferentes pantallas─ en la interfaz son:

  • Menú de Operación
  • Menú de Administración
  • Enlaces definidos
  • Cabecera

Los elementos dinámicos ─que cambian entre las diferentes pantallas─ son:

  • En la cabecera podemos destacar:
    • Información del usuario, mensajes pendientes, notificaciones del sistema, etc. (se detallará más adelante en la subsección cabecera)
  • Noticias del sitio
  • Última actividad en la consola web
  • Información general básica
  • Vista general de las comprobaciones en Pandora FMS:
    • Server health: Estado general del servidor.
    • Monitor health: Estado general de los monitores.
    • Module sanity: Estado general de los módulos que están recogiendo datos frente a los no inicializados.
    • Alert level: Estado general de las alertas.

Esta es la página principal por defecto, pero el usuario puede personalizarla.

1.3.1 Página de inicio personalizada

En la vista Área de trabajo-> Edit my user se puede elegir la pantalla de inicio de Pandora FMS.



If3.JPG


Nota: La funcionalidad de la barra de acceso rápido (Shortcut bar) está implementada a partir de Pandora FMS 5.0

Las opciones disponibles son las siguientes:

  • Default.: Pantalla por defecto, explicada con detalle en el apartado anterior Página principal de Pandora FMS.
  • Dashboard.: Se puede elegir un dashboard del usuario.
  • Visual console.: Se puede elegir una visual console del usuario.
  • Event list.: Lista de eventos.
  • Group view.: Vista de grupos del agente.
  • Tactical view.: Vista táctica de los agentes.
  • Alert detail.: Listado de alertas.
  • Other.: El usuario puede personalizar la página de inicio introduciendo la url. Un ejemplo sería sec=estado&sec2=operation/agentes/estado_agente para ver el detalle de los agentes.

1.3.2 El menú Operación

El menú Operación permite visualizar todas las comprobaciones que llevan a cabo los agentes de Pandora FMS, los mapas visuales, los mapas de red, el inventario, ver y gestionar los incidentes (si se dispone de permisos suficientes), ver la consola SNMP, ver los mensajes y usar las extensiones.



Menuope.jpg



Dentro de cada submenú del menú de Operación pueden existir otros elementos que se despliegan.

Cada uno de estos elementos proporciona otra página con información. Todas ellas se explicarán en detalle en los capítulos de operación con Pandora FMS.

1.3.3 El menú Administración

El menú Administración permite visualizar y gestionar las comprobaciones que llevan a cabo los agentes de Pandora FMS, los módulos y componentes de dichas comprobaciones, las alertas que pueden lanzar dichos módulos y agentes y cómo funcionan dichas alertas, las políticas existentes, los usuarios, los perfiles de los usuarios, los servidores de Pandora FMS y sus tareas asignadas, el registro de auditoría del sistema, el comportamiento general de la consola web de Pandora FMS, el mantenimiento de la base de datos y las extensiones de la consola.



Extension.jpg



Dentro de cada submenú del menú de Administración pueden existir otros elementos que se despliegan al seleccionar el menú.

Cada uno de estos elementos proporciona otra página con información. Todas ellas se explicarán en detalle en los capítulos de operación y gestión con Pandora FMS.

1.3.4 El menú Enlaces

El menú de enlaces simplemente muestra un enlace a sitios preconfigurados. Estos se pueden añadir, modificar y borrar desde el menú de Administración de Pandora FMS. Estos enlaces permiten enlazar Pandora FMS con otras aplicaciones WEB de su organización y hacer que Pandora FMS sea un punto de gestión central.



Enlaces.jpg


1.3.5 La Cabecera

La cabecera de Pandora FMS ofrece varios enlaces rápidos, o accesos directos, a características importantes del sistema, así como una barra de búsqueda:



If4.JPG



De izquierda a derecha, la cabecera proporciona:

  • La barra de búsqueda que permite buscar en diversos elementos: agentes, informes, alertas, mapas, gráficas combinadas, usuarios y/o políticas en la base de datos de Pandora FMS.
  • El botón de auto-refresco que, además de actualizar la pantalla, puede configurarse para que auto-refresque en un intervalo de tiempo seleccionable. Esto permite que en cualquier página pueda definir que esta se refresque cada X tiempo, haciendo que no se pierda la sesión y que muestre los datos actualizados.
  • En caso de haber notificaciones del sistema pendientes se mostrará un icono de alerta que, al clickar en él, desplegará una ventana modal con los avisos actuales.



System advises.jpeg



Template warning.png

Estos mensajes, al igual que las notificaciones por email de la consola, redirigen a la url del archivo /etc/crontab o a una public url con la opción "force" activada. Por lo que si no lo configuramos, utilizará como url "localhost" por defecto.

 



  • Enlace al estado de los sistemas, que muestra el estado de los servidores de Pandora FMS.
  • Un enlace al soporte de Pandora FMS.
  • Un enlace a la ayuda contextual general de Pandora FMS.
  • Información acerca del usuario que está conectado, un enlace directo a su página de usuario (entre corchetes).
  • El botón de cerrar la sesión.
  • En caso de tener mensajes pendientes por leer, se mostrará un icono de una carta que desplegará una ventana modal con los mensajes disponibles.

El enlace al estado del sistema avisa también de cuándo se cae algún servicio, cambiando de icono:



Servers.jpg



Al pulsar sobre el enlace, este lleva directamente al estado de los servidores, informando de diversos detalles acerca de los mismos:



Config.jpg



En la sección de edición de usuario podemos configurar el autorrefresco para ciertas secciones. Si está habilitado en la sección en la que nos encontramos, el botón de auto refresco permite actualizar la página al pulsar sobre él, o bien seleccionar una frecuencia de actualización:



Autorefresh select time pandora v5.png



Una vez seleccionada esta, se mostrará el tiempo restante hasta la próxima actualización junto al nombre del enlace:

Autorefresh count down pandora v5.png


Tenga en cuenta que solo es posible usar esta funcionalidad en las siguientes páginas, el resto está deshabilitado para evitar conflictos y pérdidas de datos al editar formularios. La lista de permitidas es:

  • Vista táctica
  • Detalles de grupo
  • Detalle de agente
  • Detalle de alerta
  • Detalle de monitor
  • Vista de servicio
  • Dashboard
  • Vista de eventos
  • Consola de traps SNMP
  • Mapa de red
  • Vista de cluster
  • Vista de gráficas
  • Consolas visuales



La barra de búsqueda permite buscar términos en los mapas, informes, gráficas, alertas, usuarios, agentes y políticas. Se muestra un resumen de los elementos encontrados. La información se muestra clasificada en pestañas para cada tipo de dato, estando la pestaña de agente seleccionada de forma predeterminada:



Newsearch2.JPG



El enlace directo a los eventos es el mismo que el que proporciona el menú Operación. Este muestra los eventos en el sistema y permite gestionarlos en caso de tener suficientes permisos. La gestión de eventos se explica en el capítulo Gestión de la aplicación.

1.4 Iconos en la interfaz de Pandora FMS

En Pandora FMS existen bastantes iconos junto a textos, junto a otros iconos, solos, etc. En esta sección se explican los más importantes.

1.4.1 Icono de ayuda contextual

El icono de ayuda contextual representa una ayuda general sobre el campo al que acompaña o el formulario o página en el que está. Abre una ventana emergente (se deberán tener activadas las ventanas emergentes en el navegador) y proporciona una ayuda completa.

Icono.jpg


1.4.2 Icono de sugerencia o consejo

El icono de sugerencia o consejo proporciona una pequeña ayuda acerca del campo al que acompaña. Esta se muestra al posar el ratón encima del icono.



Estrella.jpg



1.4.3 Icono de gestión

El icono de gestión acompaña a algunas filas de algunas tablas y representa un enlace directo a la configuración del elemento. Para acceder a la página que enlaza se debe pulsar sobre él.



Mango.jpg



1.4.4 Icono de pantalla completa

Presente en secciones principalmente visuales para mostrar la información en pantalla completa ocultando los menús.



Flecha.jpg



1.4.5 Icono de varita mágica (Wizard)

El icono de la varita mágica o wizard indica que la funcionalidad servirá para aplicar de manera sencilla (mediante un asistente) a un gran número de items una acción.



Magica.jpg



1.4.6 Icono de edición de la configuración remota

Para editar remotamente el fichero de configuración de los agentes software:



Oso.jpg



1.4.7 Icono de forzar acción

Las comprobaciones remotas de Pandora FMS tienen un intervalo de actualización, pero este se puede forzar pulsando sobre el botón en cuestión.

Force.JPG



1.4.8 Icono de refresco (tras forzar acción)

Una vez que se ha pulsado el icono de forzar acción, este cambia para indicar que se ha pulsado sobre él.

Toner.jpg



Volverá a su estado normal una vez que se actualice la comprobación.

1.4.9 Textos alternativos en los iconos/imágenes al posar el ratón

Prácticamente todas las imágenes de Pandora FMS tienen un texto alternativo que se muestra al posar el ratón encima de ellas; de esta forma se puede obtener contexto acerca de estas imágenes:

Raton.jpg



1.5 Gestión de servidores

La vista detallada de los servidores se utiliza para conocer, además del estado general de los servidores de Pandora FMS, su nivel de carga y retraso en las ejecuciones.

Algunos iconos tienen especial relevancia, tal como se ven en la captura de arriba:

  • Poll request: Solicita al servidor de pruebas remotas que ejecute todos los chequeos que tenga, forzando a ejecutarlas otra vez. Válido para todos los servidores de red, por ejemplo Network server, WMI server, Plugin server, WEB Server, etc.
  • Editar tareas del recon server.
  • Editar configuración remota del servidor. Válido para servidores de Pandora FMS o de satélite server.

En esta vista podemos ver distinta información en cada columna:

  • Nombre del servidor: Generalmente usa el hostname de la máquina.
  • Estado: (verde = activo, gris = parado o caído).
  • Tipo de servidor: Data server, network server, etc.
  • Versión: Muestra la versión actual de nuestro servidor de Pandora FMS.
  • Módulos: Nº de módulos de ese tipo ejecutados por el servidor respecto al nº total de módulos de este tipo.
  • Server Lag / Módulos atrasados: Tiempo más alto que lleva el módulo más antiguo esperando a recibir datos / Nº de módulos que están fuera de su tiempo de vida. Este indicador sirve para conocer si tenemos muchos módulos y saber si el servidor está al límite de su capacidad de carga. Delayed modules (módulos atrasados) nos indica la cantidad de módulos que no han reportado al servidor.
  • T/Q (Current threads/queued modules currently): Muestra el número de hilos activos actualmente en cada servidor. Nº total de módulos en cola a espera de ser atendidos. Estos parámetros reflejan estados de carga excesiva. No debería haber casi nunca módulos en cola; esto refleja la incapacidad del servidor para procesar los datos.
  • Actualización de datos: Cada servidor tiene un "Keepalive" que actualiza su estado, para asegurarse de que está activo, actualizando además sus estadísticas.



1.6 Estados y posibles valores de los agentes, módulos y grupos

Los agentes contienen módulos con los diferentes chequeos que realizan. Sus estados pueden ser:

  • Correcto: color verde.
  • Advertencia/aviso: color amarillo.
  • Crítico: color rojo.
  • Desconocido: color gris.
  • No inicializado: No se visualiza. Aparece con color azul solo en la vista de gestión.

Esta sería una vista de datos de un agente, lo que en Pandora FMS se llaman módulos. En ella se muestra el nombre del módulo, su estado (con un recuadro de color), y su valor numérico o alfanumérico.


Modulos descr.jpg
Vista de datos de un agente


Existen las vistas detalladas de agente, que resumen de un vistazo el estado del agente "en conjunto" y el estado resumido de sus módulos. En esta vista, vemos varios agentes en diferentes estados:


If5.JPG
Vista de agentes


Los agentes reflejarán en su estado la situación más grave de sus módulos, por lo que si hay uno solo en estado crítico, el agente se mostrará en color rojo.

Vista de grupos

De la misma forma tenemos la vista de grupos que resume el estado de un grupo de agentes.

En esta vista un grupo puede tener los siguientes estados:

  • Correcto: (color verde). Todos sus agentes están en estado correcto.
  • Advertencia/aviso: (color amarillo). Al menos uno de sus agentes está en estado de advertencia.
  • Crítico: (color rojo). Al menos uno de sus agentes está en estado crítico.
  • Desconocido: (color gris). Todos sus agentes están en estado desconocido.
  • Sin módulos: (color blanco). Cuando los agentes del grupo no tienen módulos o estos no están inicializados.

Vista de módulos

En esta vista podrá ver un listado con todos los módulos de todos los agentes. En ella se muestra el estado del módulo con el código de colores arriba explicado.

Esta vista es muy útil para comparar la información de módulos de diferentes agentes gracias a sus opciones de filtrado.

1.7 Caja de agente de autocompletado

En varias secciones de Pandora FMS podremos ver un control como el siguiente:


Agent autocomplete.png


Este control nos permite, según va escribiendo, realizar un filtrado y mostrar los agentes que coinciden con la búsqueda, visualizándose por bloques como los siguientes:

  • Primer bloque de color verde, los agentes que coinciden en el nombre con lo tecleado.
  • Segundo bloque de color amarillo, los agentes que coinciden en la descripción con lo tecleado.
  • Tercer bloque de color morado, los agentes que coinciden en la dirección con lo tecleado.

Info.png

Recuerde que el control empieza a funcionar a partir de los dos caracteres tecleados.

 


1.8 Tabla de interfaces de red

Esta tabla puede aparecer en lugares como la vista general de un agente, la vista en detalle de un agente en la vista de árbol, ciertos tipos de informe, etc. Como su nombre indica, muestra información sobre las interfaces de red de un agente determinado.


Snmp-interface-table.png


Hay varias formas de hacer que se muestre esta tabla:

  • Script de reconocimiento: Más información. Este script creará agentes y módulos, los cuales estarán preparados para mostrar correctamente la información en el caso de ser módulos de interfaces de red.
  • Wizard de interfaces SNMP: A través de una configuración sencilla, este asistente, que puede encontrarse en la vista de configuración de un agente, mostrará las interfaces encontradas y solo habrá que elegir los módulos a crear. Para que la interfaz aparezca en la tabla, será necesario al menos el módulo ifOperStatus. Para poder visualizar la gráfica de tráfico entrante y saliente de la interfaz, será necesario seleccionar los módulos ifInOctets e ifOutOctets.
  • Creación manual: Para que la interfaz aparezca en la tabla, habrá que crear un módulo siguiendo ciertas convenciones en el nombre. Este módulo debe llamarse <nombre de la interfaz>_ifOperStatus y debe ser de uno de estos tipos: remote_snmp_proc, remote_icmp_proc, remote_tcp_proc, generic_proc. Se recomienda usar el tipo remote_snmp_proc y atacar al OID de ifOperStatus de la interfaz (.1.3.6.1.2.1.2.2.1.8.<index>) para obtener su estado real. Para poder visualizar la gráfica de tráfico entrante y saliente, habrá que crear dos módulos de tipo remote_snmp_inc llamados <nombre de la interfaz>_ifInOctects e <nombre de la interfaz>_ifOutOctets. Estos módulos deben atacar a las OID .1.3.6.1.2.1.2.2.1.10.<index> y .1.3.6.1.2.1.2.2.1.16.<index>, respectivamente. Para que aparezca en la tabla información sobre la IP y la MAC de la interfaz, basta con meter esos dos datos en la descripción del módulo ifOperStatus creado anteriormente.

Volver a Indice de Documentacion Pandora FMS