Configuración de la Consola
System Settings
Menú Management → Settings → System Settings.
En esta sección se puede modificar y ajustar parámetros de funcionamiento de la Consola web de Pandora FMS, lo cual afectará a su funcionamiento general.
General Setup
La sección principal y más densa está facilitada en siete secciones:
- Basic: Idiomas, fecha y hora, etcétera.
- Security: Los puntos relacionados a fortalecer la Consola web y API.
- Behavior: Comportamientos de la consola de reportes, agentes y módulos, eventos y, finalmente, misceláneos como operaciones masivas, colecciones y NCM.
- Features: Activar o desactivar funcionalidades importantes de PFMS.
- Network: De vital importancia para alcanzar la Consola web.
- Directories: Las rutas absolutas más importantes y esenciales de las funcionalidades PFMS (adjuntos, RMM, etcétera).
- Alerts configuration: El correo electrónico aún es una herramienta válida para mantener conectadas a las personas, aquí se incluyen instrucciones para que PFMS funciones como cliente de solamente envío de mensajes.
Basic
Menú Management → Settings → System settings → General Setup →
Basic .
- Language code: Por defecto se utiliza inglés (
English (UK)) y establece el idioma para los usuarios que tengan el idioma por defecto establecido. Cada usuario podrá elegir su propio idioma y este valor general será ignorado para ese usuario. - Time source: Lista donde se puede elegir el origen de la fecha y hora a usar. Puede ser el sistema local (
Systempor defecto) o la base de datos (Database). La primera se suele usar cuando la base de datos está en un sistema diferente con una zona horaria distinta a la de la Consola web. - Server timezone setup: Define el huso horario en el que se encuentra la Consola web. A diferencia de los códigos y abreviaturas de todos los países (norma ISO 3166), la lista de husos horarios tiene complicadas normas (IANA Time Zone Database) y por ello se incluye una primera lista con continentes y sus países y al seleccionar una opción de ella se actualizará la segunda lista donde se podrá escoger con exactitud un país, ciudad o región. A partir de la versión 785 el botón Change timezone queda sin efecto, bastará utilizar ambas listas descritas y guardar luego los cambios realizados.
- Enable update manager: Activa o desactiva la opción del Warp Update Manager.
- Automatically check for updates: Habilitar o deshabilitar el chequeo automático de actualizaciones en el Warp Update. Esto hace que la Consola web contacte cada vez que se inicia sesión con el proveedor de actualizaciones de Pandora FMS, enviando información anónima sobre el uso de Pandora FMS (numero de agentes).
- Enable console log: Por la gran cantidad de datos de depurado que genera que este log se recomienda deshabilitarlo, tal como viene configurado por defecto. Si se activa, para el registro de eventos de la Consola se utiliza el fichero:
/var/log/php-fpm/error.log
- Si se está utilizando EL8 (Enterprise Linux 8), aparte de habilitar Enable console log, se debe modificar el fichero:
/etc/php-fpm.d/www.conf
- Y comentar con un punto y coma el siguiente parámetro:
;php_admin_value[error_log] = /var/log/php-fpm/www-error.log
De esta manera se guardarán los datos en …/pandora_console/log/console.log.
- Tutorial mode: Por defecto en modo de asistencia completa, permite indicar los mensajes y accesos de ayuda en las diferentes secciones y/o funcionalidades de la Consola web.
- Enable Feedback: Activo por defecto, permite un acceso directo en la cabecera de la Consola web para notificar de un error al equipo de Pandora FMS, incluidos los datos de instalación en in fichero PDF.
Security
Menú Management → Settings → System settings → General Setup →
Security .
- Enable audit log: Al activarlo también se utiliza el fichero
…/pandora_console/log/audit.logpara registrar la auditoría. - Use SSL certificate: Permite indicar un certificado digital para cifrar la comunicación de la Consola web y los usuarios. Cada PFMS Server debe utilizar un certificado singular, la ruta que trae por defecto indica el directorio dónde almacenarlo y el nombre de fichero es una solamente una sugerencia.
- Enforce HTPS: Forzar la redirección al protocolo seguro (HTTPS). Si se habilita tendrá forzosamente que activar el uso de Pandora FMS con HTTPS en el servidor WEB.
Si se ha habilitado este campo y no se ha configurado Apache para que utilice HTTPS, no se podrá acceder a la Consola web y se tendrá que deshabilitar esta opción nuevamente accediendo a la base de datos directamente mediante MySQL e insertando la siguiente instrucción:
UPDATE tconfig SET `value` = 0 WHERE `token` = 'https';
Antes de recargar la página se debe modificar de nuevo http://… en la barra de direcciones del navegador web.
- Referer security: Cuando está activo, por seguridad, se verifica que el usuario viene de una URL de Pandora FMS y que el enlace no es externo y por lo tanto deja de ser sospechoso. Por defecto está desactivado. Los sitios de extrema seguridad que se verifican son:
- Extensión de DB manager.
- Configuración de usuario.
- Configuración de los scripts de Recon Server.
- API password: Método de autenticación para acceder a la API 1.0 de Pandora FMS.
- IP list with API access: Lista de direcciones IP que tendrán acceso a la API web service de Pandora FMS (por defecto
127.0.0.1, solamente acceso local). Se puede utilizar el asterisco como comodín, de tal modo que colocando*sirva para dar acceso a todas las direcciones IP o, por ejemplo,125.56.24.*para que otorgue acceso a toda la subred125.56.24.
Behavior
Menú Management → Settings → System settings → General Setup →
Behavior .
En esta sección se controlan los comportamientos consola de reportes y conectividad, detalles de los agentes y módulos (incluidos API y SNMP traps), los eventos PFMS, y misceláneos como operaciones masivas, colecciones y NCM.
Console
Menú Management → Settings → System settings → General Setup →
Behavior → Console .
Enable console dedicated to report generation: La Consola dedicada para informes tiene como misión crítica, a partir de los datos extraídos de las bases de datos PFMS (principal e histórico), el preparar, convertir en información útil, generar, guardar y enviar informes de centenares de agentes y EndPoints.
Para ello tiene preconfigurados aspectos especiales tanto para el software como para el hardware:
- La memoria (RAM, virtual o real) para PHP debe ser capaz de utilizar, si es necesario, la máxima cantidad que tenga el equipo. De no ser así recibirá un aviso oportuno de tal insuficiencia. Consulte en la instalación los detalles de configuración.
- Solamente los usuarios administradores podrán iniciar sesión en la Consola dedicada para informes.
- Las opciones de menú están limitadas al funcionamiento esencial, especialmente para la actualización de software PFMS. Se deberá configurar todo lo demás por medio de otra Consola web conectada a las mismas bases de datos. Consulte la sección para la configuración de envío de correo electrónico.
- Para utilizar la Consola dedicada para informes se deberá agregar el fichero
config.phprespectivo el siguiente parámetro:$config["reporting_console_node"] = true;
- Check connection interval: Intervalo de tiempo (en segundos) para comprobar la conexión con el servidor de base de datos. Por defecto
180, valor mínimo60.
Agent & modules
Menú Management → Settings → System settings → General Setup →
Behavior → Agent & modules .
- Set alias as name by default in agent creation: Al activar este parámetro para la creación de agentes por Consola web se activa por defecto la opción Use alias as name lo que permite que el nombre y el alias del nuevo agente sean el mismo valor. Deshabilitado por defecto.
- Unique IP: Al activar este parámetro se activará de forma automática el botón Unique IP en la creación y edición de los agentes para detectar si las direcciones IP asignadas a un agente están disponibles o si están en uso por el mismo agente u otro agente. Deshabilitado por defecto.
- Forward SNMP traps to an agent (if it exists): Configuración que permite asociar Traps SNMP y agentes. Al activar esta opción, cuando se recibe un trap con la misma dirección IP que un agente, se crea un módulo en ese mismo agente con nombre
SNMPTrapy de tipoasync_string. El valor del módulo será el del último OID recibido, es decir, se va actualizando con la llegada de nuevos traps. Si está seleccionado Yes, and change status, además de actualizar el valor al recibir el trap, el módulo cambia a estadoCRITICAL. Para que vuelva a estadoNORMALhay que validar o borrar todos los traps asociados a ese agente desde la consola SNMP. En el caso de seleccionar Yes, but do not change status solamente se cambia el valor del módulo. El valor por defecto es no reenviar los traps SNMP (botón No, do not forward). - Include manually disabled agents: Permite habilitar o deshabilitar la visualización de agentes deshabilitados manualmente en ciertas vistas de la Consola web.
- Enable module custom ID read-only: Activando este parámetro se bloquea la edición del custom id del módulo de un agente desde la Consola pero se permite la edición desde CLI y la API. Esto es de utilidad para integraciones automáticas de terceros sin que el usuario pueda modificar este valor.
- Command line snapshot: Los módulos de cadena que devuelven más de una línea mostrarán su contenido como texto formateado en forma de consola de comandos.
- Change remote config encoding: Al activar este parámetro se convierte la codificación de caracteres (encoding) de la escritura de los módulos en los ficheros de configuración remota de UTF-8 por defecto a la codificación configurada en los propios ficheros de configuración.
- Number of modules in queue: Establece el número máximo de módulos en cola (
500por defecto) y en caso de sobrepasar dicho valor mostrará un icono de advertencia para cada item en la administración de servidores. - API interval for module (seconds): Valor por defecto
300segundos, mínimo60.
Events
Menú Management → Settings → System settings → General Setup →
Behavior → Events .
- Event storm protection: Si se habilita esta opción se seguirán recibiendo datos sin generar eventos o alertas.
- Keep in process status for new events with extra ID: Si se activa y hay algún evento “En proceso” (In process) con un identificador extra específico (ID Extra) y se recibe un nuevo evento con ese ID Extra, se creará como In process en su lugar. Los nuevos eventos también heredan el ID Extra del evento.
- Max. hours old events comments: Cuando se muestren los eventos de forma agrupada, los comentarios de los eventos idénticos agrupados serán limitados a la última cantidad de horas aquí especificadas.
- Inventory change blacklist: Los módulos de inventario incluidos dentro de la lista de denegados no generarán eventos cuando cambien. Por defecto están agregados, tanto para Linux® como para MS Windows®, los siguientes:
CPU,Process,Security.
Other
Menú Management → Settings → System settings → General Setup →
Behavior → Other .
- Allow create scheduled downtimes in the past: Activar o desactivar la posibilidad de crear paradas planificadas en fechas pasadas. El propósito de esto es modificar información para los informes de SLA.
- Limit for bulk operations: Límite de elementos que se pueden modificar mediante operaciones masivas de una sola vez, por defecto
500(mínimo100), para evitar atascos de memoria. - Log size limit in system logs viewer extension: Establece un tamaño máximo, en kilobytes, de los ficheros de registro.
- Collection size (Bytes): Este es el tamaño máximo, en bytes, para las Colecciones.
- IPAM critical threshold for occupied addresses: Umbral para el mapa de superred de la extensión IPAM, indica un intervalo crítico de direcciones ocupadas.
- IPAM warning threshold for occupied addresses: Umbral para el mapa de superred de la extensión IPAM en el rango de advertencia de direcciones ocupadas.
- NCM configuration FTP server IP: Dirección IP del servidor FTP en las Plantillas de equipo de red. Este valor será utilizado por la macro
TFTP_SERVER_IPen los scripts NCM.
Features
Menú Management → Settings → System settings → General Setup →
Features .
Al instalar PFMS estas funcionalidades vienen desactivadas por defecto (excepto la exploración de vulnerabilidades):
- Show experimental features: El equipo de Pandora FMS trabaja en el desarrollo continuo y puede colocar aquí nuevas mejoras a las cuales los usuarios pueden echar un vistazo inicial de las mismas.
- Use Advanced ACL System: Esto activará el Sistema ACL Advanced que es más flexible que el sistema ACL estándar.
- Enable GIS features: Habilitar o deshabilitar las características GIS para la Consola web de Pandora FMS.
- Enable NetFlow: Habilitar o deshabilitar la monitorización de NetFlow®.
- Enable IOT Server: La integración Pandora IOT tiene como finalidad supervisar mensajes que se reciben de un servidor broker de MQTT.
- Enable agent vulnerability scanning: Los EndPoints de Pandora FMS y el motor de descubrimiento remoto buscarán información sobre el software instalado en el sistema para hallar posibles vulnerabilidades. Solamente se aplica a los agentes que tengan la configuración de escaneo de vulnerabilidades con la opción Use global settings seleccionada.
Network
Menú Management → Settings → System settings → General Setup →
Network .
- Public URL: Se puede almacenar una URL pública. Es útil completar este campo cuando se tiene un proxy inverso o, por ejemplo, con el modo
mod_proxydel servidor web Apache.
Los siguientes dos token solamente serán tomados en cuenta si se ha establecido una URL en el campo anterior.
- Force use Public URL: Se utiliza única y exclusivamente la Public URL para navegar a la Consola web (todos los enlaces y referencias se construirán en base a la URL pública).
Si se ha habilitado este campo y no se ha configurado URL pública, no se podrá acceder a la Consola web y se tendrá que deshabilitar esta opción accediendo a la base de datos directamente mediante MySQL e insertando la siguiente instrucción:
UPDATE tconfig SET `value` = 0 WHERE `token` = 'force_public_url';
- Public URL host exclusions: Las direcciones IP aquí agregadas utilizarán su propia dirección IP para construir sus enlaces y referencias, incluso si el token Force use Public URL se encuentra activado. Se pueden separar mediante comas y/o en lineas distintas. Para agregar comentarios en una linea esta debe comenzar con el símbolo
#.
Directories
Menú Management → Settings → System settings → General Setup
→ Directories.
- Attachment directory: Directorio de ficheros de la Consola de Pandora FMS. Utilizado para alojar colecciones, adjuntos de incidencias y otra serie de ficheros. Debe tener permisos de escritura para el servidor web y está ubicado por defecto en:
/var/www/html/pandora_console/attachment
Si se cambia la ruta por defecto a otra ubicación personalizada deberá contactar con el administrador (root) del sistema operativo donde se ejecute el PFMS Server ya que ningún directorio ni fichero alojado será movido automáticamente. Se recomienda, previo respaldo de datos y descarga de los elementos almacenados (colecciones, adjuntos de incidencias y repositorio de archivos), borrar por Consola web dichos contenidos, cambiar la ruta, guardar los cambios y volver a subir todo ello a la nueva ubicación.
- Remote configuration directory: Campo donde se identifica el directorio que guarda la configuración remota de la funcionalidad RMM, por defecto ubicado en:
/var/spool/pandora/data_in
- RMM remote config directory: Campo donde se identifica el directorio que guarda la configuración remota de los agentes, por defecto ubicado en:
/var/spool/pandora/rmm_server
- General network path: Directorio donde a su vez también se almacenarán los directorios
netflowysflowpara los datos correspondientes. Valor por defecto:/var/spool/pandora/data_in/
- Chromium path: Chromium es un componente especial que se utiliza para poder generar gráficas dinámicamente en PDF. Se debe introducir la ruta o PATH donde se encuentra instalado este componente, por defecto:
/usr/bin/chromium-browser
- Server log directory: Directorio donde se almacenan los ficheros de registro o log del servidor, valor por defecto al instalar PFMS (aunque no sea mostrado):
/var/log/pandora
Alerts configuration
Menú Management → Settings → System settings → General Setup
→ Alerts configuration.
Los valores por defecto al instalar Pandora FMS son meramente ilustrativos y deberán ser cambiados según el proveedor de correo electrónico utilizado. Pandora FMS utiliza Postfix para el enrutamiento y envío de correo electrónico ya que viene incluido en muchas distribuciones de GNU/Linux®, además de macOS® y BSD®.
Esta sección permite configurar el envío de alertas mediante correo electrónico y la mensajería instantánea Telegram®:
Pandora FMS soporta el uso de OAuth 2.0.
En los campos From address y From name se deben configurar, de manera correspondiente, la cuenta de correo remitente y el nombre del remitente que serán mostrados al destinatario.
Hoy en día, y a fin de evitar ataques de correo basura a terceros, los servidores de correo generalmente exigen un usuario (que puede ser diferente de From address) y su respectiva contraseña, los cuales deben ser especificados en el campo usuario E-mail user y contraseña E-mail password.
Se recomienda cifrar el tráfico al enviar mensajes de correo electrónico para evitar ataques de tipo man-in-the-middle (MITM). Para ello se utiliza el campo Encryption con el protocolo utilizado por el servidor de correo electrónico. Resumen de los métodos de cifrado disponibles en PFMS:
- STARTTLS (Start Transport Layer Security): (opción recomendada) Este protocolo comienza con una conexión SMTP sin cifrado en el puerto estándar y luego solicita la actualización a una conexión segura utilizando TLS. El puerto
587es el más comúnmente utilizado por la mayoría de los proveedores de correo. El puerto25es el puerto estándar de SMTP, suele estar bloqueado por muchos ISP para evitar correo basura (spam) y a menudo solamente se usa para el tráfico privado entre servidores. - SMTPS (SMTP Secure): La conexión comienza directamente utilizando SSL/TLS. No se permite una conexión sin cifrado. EL puerto
465se usa para conexiones SMTP seguras utilizando SSL/TLS desde el inicio. Aunque fue descontinuado en algún momento, todavía es soportado por muchos proveedores de correo y sigue siendo una opción válida para conexiones cifradas.Para mayor seguridad y compatibilidad, se recomienda utilizar el puerto
587con STARTTLS. - SMTP Server y SMTP Port: Almacenan el dominio (o dirección IP) y número de puerto del servidor de correo electrónico.
Se debe comprobar que Pandora FMS server es capaz de resolver, mediante servidor o servidores DNS, la dirección (mta_address) del servidor de correo encargado del dominio de correo. Para ello se puede utilizar el comando nslookup sustituyendo example.com por el dominio de correo a utilizar:
nslookup -type=mx example.com
También se ha de comprobar de que dicho servidor de correos acepta los correos redirigidos desde el Pandora FMS server.
El token mta_auth , por defecto, viene establecido como un comentario (y con la opción LOGIN establecida). Si es necesario se puede activar editando dicha línea y colocar el tipo de autenticación requerida.
Configuración de algunos proveedores de alojamiento de correo electrónico:
Una vez guardada la configuración del correo electrónico, haciendo clic en la opción Email test se podrá chequear si la configuración es correcta con el envío de un mensaje generado por Pandora FMS a la dirección que se indique. Solamente en caso de que la configuración seleccionada sea correcta, se podrá ver el mensaje en la bandeja de entrada de la dirección de correo indicada.
Aruba (aruba.it)®
- SMTP Server:
smtps.aruba.it. - SMTP Port:
465. - Encryption:
SSL.
Amazon Simple Email Service (AWS SES)®
- SMTP Server:
email-smtp.< region >.amazonaws.comdonde< region >debe sustituirse por la ubicación del servidor (en España esemail-smtp.eu-south-2.amazonaws.com; AWS puede cambiar estos valores en cualquier momento). - SMTP Port:
587. - Encryption:
STARTTLS.
easyDNS (outbound mail)®
- SMTP Server:
mailout.easydns.com. - SMTP Port:
587. - Encryption:
STARTTLS.
Gmail®
Por seguridad se debe utilizar una cuenta de correo Gmail® creada expresa y únicamente para enviar mensajes de aviso del Pandora FMS server. Nunca utilizar una cuenta de correo de uso personal para ello.
Gmail® tiene límites de envío estrictos que restringen la cantidad creciente de mensajes a enviar. Se recomienda utilizar un servicio transaccional como SendGrid® o Mailgun® para los grandes equipos que utilicen la configuración SMTP.
Véase también Google (OAuth 2.0).
- SMTP Server:
smtp.gmail.com. - SMTP Port:
587. - Encryption:
STARTTLS.
Si se encuentran errores de autenticación, se debe verificar que:
Mailgun®
- SMTP Server:
smtp.mailgun.org. - SMTP Port:
587. - Encryption:
STARTTLS.
Postmark®
- SMTP Server:
smtp.postmarkapp.com. - SMTP Port:
587. - Encryption:
STARTTLS.
Proton Mail
- SMTP Server:
smtp.protonmail.ch. - SMTP Port:
587. - Encryption:
STARTTLS.
Microsoft 365 Exchange (OAuth 2.0)
Hay que tener en cuenta que las versiones de prueba de MS 365 Exchange® pueden dar error ya que tal vez sean detectados como correo basura o spam. Esto se debe a la configuración realizada en la cuenta de Azure®.
En caso de que esto suceda el cliente tendrá que contactar con Microsoft® para que sean introducidos de forma manual en la lista de correos no sospechosos.
- En Microsoft Azure® se debe registrar la aplicación a utilizar:
- Al tener la aplicación registrada tomar nota del Client ID y el Tenant ID:
- Crear un Client secret y anotar debidamente dicho valor:
El Secret ID únicamente será mostrado la primera vez que sea creado el token.
- Otorgar permisos en la API para obtener los usuarios y enviar los correos:
- Comprobar que se tiene registrada la aplicación Office 365 Exchange:
- Acto seguido se debe activar la aplicación Office 365 Exchange:
- Por último se debe configurar en Pandora FMS el OAuth2 con los datos conseguidos:
Menú Management → Settings → System settings → General Setup → Alerts configuration y activar OAuth2 para que aparezcan los campos a configurar.
Google (OAuth 2.0)
Al activar la opción OAuth 2.0 se debe seleccionar Google como OAuth 2.0 Mail server y los datos necesarios se deben obtener de Google Cloud®. Para ello se debe crear un proyecto nuevo:
Una vez creado, ir a la biblioteca de Gmail®, sección API Library, opción Gmail API:
Se debe activar dicha opción:
En el apartado Data Access otorgar permisos a envíos de correo:
En Service accounts crear un nuevo elemento para poder obtener el CLIENT ID:
Una vez activado y configurado todo lo anterior, el siguiente paso consiste en configurar con el administrador del dominio credenciales OAuth2 para poder obtener las distintas claves a configurar.
Con la cuenta del superadmin teniendo copiado el CLIENT ID se han de realizar los siguientes pasos:
- Ir a la consola de administración de Google®:
admin.google.com. - Acceder a Security → Access and data control → API controls.
- Clic en Manage Domain-Wide Delegation.
- Clic en Add new.
- Crear el registro con el ID de la Service account creada y su alcance:
https://www.googleapis.com/auth/gmail.send
Documentación de Google sobre OAuth 2.0:
Command center
Menú Management → Settings → System Settings → Command Center
.
Esta sección permite integrar un PFMS Server standalone a un Command center y que de esta manera se convierta en uno de sus nodos.
Los diferentes campos albergan la ubicación, tipo de base de datos (MySQL siempre por defecto), nombre de base de datos, etcétera, incluyendo las opciones necesarias de cifrado de las comunicaciones (token Enable SSL). En Command center link status se podrá conocer siempre el estado de dicha conexión, incluyendo mensajes de ayuda para cada caso.
Password policies
Menú Management → Settings → System Settings → Password policy
.
Para activar la política de contraseñas, debe tener perfil de administrador (Pandora administrator) o ser superadmin.
Historical database
Menú Management → Settings → System Settings → Historical database → Enable historical database
.
Esta funcionalidad permite guardar los datos con una antigüedad configurada en una base de datos distinta de la principal para acelerar la explotación de esta última.
En la configuración de conexión (Configure connection target) se deben configurar los datos básicos (dirección y puerto, nombre de base de datos y credenciales). A partir de la versión 782 se puede conectar MySQL por conexión segura (SSL) estableciendo los siguientes parámetros:
- Enable SSL: Habilita o deshabilita el uso de SSL para la conexión a la base de datos.
- SSL server key: Ruta o ubicación del fichero, en formato PEM, que contiene la clave SSL del servidor MySQL.
- SSL server cert: Ruta o ubicación del fichero, en formato PEM, que contiene el certificado de la clave SSL del servidor MySQL.
- SSL CA cert: Ruta o ubicación del fichero, en formato PEM, que contiene una lista de certificados SSL emitidos por una Autoridad de certificación.
- SSL CA path: Ruta o ubicación del directorio o carpeta que alberga certificados SSL emitidos por una Autoridad de certificación. Los certificados deben estar en formato PEM.
- SSL verify server cert: Si está habilitado realiza la verificación en la conexión MySQL (CN del certificado SSL), si no coinciden no realiza conexión.
Téngase en cuenta que en la primera conexión hacia la futura base de datos histórica, el usuario indicado creará una nueva estructura de datos que si resultare fallida ocasionará que sea desactivado el botón Enable historical database. Consulte con su administrador de red y/o administrador de base de datos acerca de los privilegios establecidos para la cuenta de usuario utilizada.
Luego de conectar exitosamente a la base de datos histórica, se pueden configurar los parámetros personalizados (Customize settings):
Configuraciones para datos activos a históricos:
- Advanced options: Habilita las opciones avanzadas:
- String data days old to keep in active database: Antigüedad de los datos en cadena a mantener en la base de datos activa. Los datos de cadena estarán disponibles en la base de datos activa a la hora y los días que especifique aquí. La información más antigua se enviará a la base de datos de histórico. Los datos se purgarán de la base de datos activa después de
0días (valor por defecto).
- Data days old to keep in active database: A partir de cuántos días los datos serán transferidos a la base de datos histórica. Valor por defecto: quince
15días. - Transference block size (Step): Mecanismo para la transferencia de datos (similar un buffer de datos) a la base de datos histórica. Cuanto menor sea el número de registros impactará menos al rendimiento de la base de datos principal. Valor por defecto mil quinientos
1500registros, valor recomendado mil. Véase el siguiente punto para configurar el período de tiempo. - Delay between transferences (seconds): Tiempo de espera -en segundos- entre transferencias de datos entre la base de datos principal y la histórica. Valor por defecto uno
1, valor recomendado: dos2.
Configuraciones para datos históricos:
- Maximum historical data age (days): Cantidad máxima de días a retener datos numéricos. Valor por defecto: ciento ochenta
180. - Maximum historical string data age (days): Cantidad máxima de días a retener datos de cadena de texto. Valor por defecto: ciento ochenta
180. - Automatic partition of big tables: Para crear automáticamente particiones mensuales en archivos IDB de bases de datos específicas (
tagente_datos,tagente_datos_string,ttrap).
Configuraciones para eventos históricos:
- Al pulsar Enable historical events activa los siguientes tokens
- Events days old to keep in active database: Número de días para mantener los eventos en la base de datos histórica. Valor por defecto: noventa
90días. Note que de la base de datos principal los eventos son borrados (purgados) después de siete días. - Maximum historical events age (days): Número de días para finalmente eliminar los eventos de la base de datos histórica. Valor por defecto: ciento ochenta días
180.
Configuraciones para SNMP trap históricos:
- Al activar la opción Enable historical traps se permite almacenar los traps SNMP en la base de datos histórica:
- Days old to keep in active database: Número de días de antigüedad a mantener en la base de datos activa. Valor por defecto:
6días. - Maximum historical traps age (days): Número de días de antigüedad a mantener en la base de datos histórica. Valor por defecto:
180días.
Log collector
Menú Management → Settings → System Settings → Log collector
.
Se debe configurar según se explica en “Recolección y monitorización de logs”.
SIEM
Menú Management → Settings → System Settings → SIEM → Activate SIEM
.
Para comenzar a realizar la monitorización SIEM se deberá contar con una licencia SIEM específica instalada en el PFMS Server y un servidor OpenSearch a fin de realizar la debida conexión con Pandora FMS.
Una vez puesto a punto dicho servidor, se colocará acá su dirección IP o URL (se recomienda utilizar HTTPS) y el número de puerto (por defecto 9200) y la conexión será probada, mostrando su éxito o fracaso en la sección SIEM status:
Es importante que en Basic authentication sean establecidas las credenciales del usuario a utilizar en el servidor OpenSearch.
Para los valores de Index configuration véase el tema “Recolección y monitorización de logs”.
Authentication
Menú Management → Settings → System Settings → Authentication
.
En los procesos de autentificación remota se debe verificar que los números de puerto están configurados de manera correcta.
Authentication method: Local Pandora FMS por defecto, indica que se realizará usando la base de datos interna de Pandora FMS. Los usuarios tipo superadmin por seguridad siempre se autentican de esta manera, el resto de los tipos de autenticaciones tiene la opción local como respaldo (fallback).
Véase también “Sistema de autenticación con terceros”.
Los siguientes campos son comunes a todas las opciones anteriores:
- Double authentication: Los usuarios puedan elegir si habilitar la autenticación en dos pasos en sus cuentas. Esta funcionalidad necesita que el servidor y los dispositivos móviles tengan una fecha y hora sincronizadas y lo más precisas posibles.
- Session timeout based on: Por defecto activado, verifica si no ha habido actividad por parte del usuario (o tomando en cuenta la fecha y hora del último inicio de sesión), en el período de tiempo establecido en Session timeout (mins) para cerrar sesión. Valores para este último token:
- El valor por defecto es
90minutos. - Cuando se establece este valor a
0para un usuario, Pandora FMS utilizará el valor guardado en la Configuración General, sección autenticación. - Si se desea mantener la sesión sin expiración se debe colocar
-1. Un usuario con sesión iniciada en la Consola web y con una pantalla activa tiene auto refresco y no se considerará inactividad.
Performance
Menú Management → Settings → System Settings → Performance
.
El rendimiento de Pandora FMS se ve afectado por factores varios que deben ser refinados en las siguientes secciones.
Los módulos con intervalos de menos de 300 segundos solamente se conservarán en la base de datos principal durante una semana, y se moverán automáticamente al archivo histórico después de ese tiempo, siempre que esta característica esté habilitada.
Database maintenance status
Muestra el estado del mantenimiento de las bases de datos:
- Pandora_db running in active database: Si
pandora_dbsupera 12 horas sin ejecutar marcará un estado crítico. - Pandora_db running in historical database: Solamente aparece si existe una base de datos de histórico configurada; de igual manera si
pandora_dbsupera 12 horas sin ejecutar sobre la base de datos histórica, se marcará un estado crítico.
Los módulos con intervalos de menos de 300 segundos solamente se conservarán en la base de datos principal durante una semana y se moverán automáticamente al archivo histórico después de ese tiempo, siempre que esta característica esté habilitada.
Database maintenance options
- Max. days before events are deleted: Número máximo de días antes de borrar los eventos, siete por defecto.
- Max. days before traps are deleted: Número máximo de días antes de borrar los traps SNMP, siete por defecto.
- Max. days before audited events are deleted: Número máximo de días antes de borrar los eventos de auditoría, valor por defecto: quince.
- Max. days before string data is deleted: Número máximo de días antes de borrar las cadenas de datos, siete por defecto.
- Max. days before GIS data is deleted: Número máximo de días antes de borrar los datos GIS, siete por defecto.
- Max. days before purge: Número máximo de días antes de borrar datos, 45 por defecto. Esto también especifica el número máximo de días a mantener datos de histórico de inventario.
- Compact data before moving it to history: Los datos pueden ser comprimidos realizando un número de muestreos por hora (Compaction samples per hour) antes de moverlos a la base de datos histórica.
- Max. days before unknown modules are deleted: Número máximo de días antes de borrar los módulos desconocidos excepto si están en una política.
- Max. days before delete not initialized modules: Número máximo de días antes de borrar los módulos no inicializados.
- Max. days before autodisabled agents are deleted: Número de días (por defecto
30) a partir del cual se eliminarán los agentes auto deshabilitados. - Retention period of past special days: Número de días a partir del cual se eliminarán los días especiales que ya han pasado.
- Max. macro data fields: Número de campos que se pueden utilizar para los comandos de alertas.
- Max. days before delete old messages: Número de días a partir del cual se eliminarán los mensajes recibidos.
- Max. days before inventory data is deleted: Número de días a partir del cual se eliminarán los datos de inventario.
- Max. days before disabled agents are deleted: Número de días a partir del cual se eliminarán los agentes deshabilitados (por defecto
0, nunca). - Max. days before policy queue is purged: Se aplica a la gestión de la cola de políticas de monitorización ya aplicadas y que serán borradas al alcanzar el número de días aquí especificados.
Historical database maintenance options
Estos parámetros solamente aparecerán si existe una base de datos de histórico configurada en Pandora FMS.
- Max. days before purge: Número máximo de días (180 por defecto) antes de borrar datos históricos.
- Max. days before events are deleted: Número máximo de días (180 por defecto) antes de borrar los eventos históricos.
- Max. days before string data is deleted: Número máximo de días (180 por defecto) antes de borrar las cadenas de datos históricas.
Others
- Item limit for real-time reports: Campo donde se definen el número de datos máximo que representará la gráfica en tiempo real, valor por defecto: 100.
- Limit of events per query: Para establecer un límite máximo al número de eventos devueltos en una consulta, valor por defecto: 5000.
- Default hours for event view: Campo donde se define el campo horas del filtro por defecto en la vista de eventos. Este campo también afecta al visualizado, conteo y gráficas de los eventos en la vista táctica y su valor predeterminado es ocho horas.
- Use real-time statistics: Habilitar o deshabilitar el uso de estadísticas en tiempo real. Si las estadísticas en tiempo real están deshabilitadas, se definirá en Batch statistics period (secs) el tiempo de refresco (60 segundos por defecto) para las estadísticas.
- Disable unknown status control on software agents modules by default: Por defecto los módulos creados por los Endpoints PFMS vienen desactivados para la detección de estados en desconocido.
- Max. recommended number of files in attachment directory: Número máximo de ficheros que se almacenan en el directorio de adjuntos (
attachment). - Delete not initialized modules: Habilita o deshabilita el borrado de módulos no inicializados.
- Big Operation Step to purge old data: Número de bloques en los que el script
pandora_managedivide un intervalo de tiempo. Un valor mayor implica bloques de tiempo más grandes, lo cual supone realizar más operaciones aunque más ligeras. En sistemas sobrecargados y bases de datos muy grandes puede ser recomendable aumentar este valor aunque el purgado de los datos tome más tiempo.- Small Operation Step to purge old data: Número de filas que
pandora_manage.plprocesa en una sola consulta o query SQL. Esto significa que para cada bloque de tiempo definido por el parámetro Big Operation Step to purgue old data, se purgarán como máximo 1000 registros con cada consulta (usando el valor por defecto). Un valor mayor implica consultas más grandes, lo cual supone realizar menos operaciones aunque más pesadas. En sistemas sobrecargados puede ser recomendable reducir este valor, aunque el purgado de los datos tome más tiempo. El valor por defecto y recomendado es 1000.
- Graph container - Max. Items: Campo donde se define el numero de items máximos en la vista graph container.
- Events response max. execution: Campo donde se define el numero máximo de eventos que pueden realizar la operación masiva de Event Responses.
- Row limit in csv log: Límite de filas para el log en formato CSV.
- SNMP walk binary y SNMP walk binary (fallback): Cuando SNMP bulk walk no es capaz de solicitar V1 SNMP, esta opción se utilizará en su lugar (por defecto
snmpwalk, más lento). - WMI binary: Fichero ejecutable a utilizar en consultas WMI, por defecto
pandorawmic. - Rows limit for SQL report item PDF: Limita por defecto a un máximo de cinco mil líneas para evitar recargar las capacidades de hardware donde sea ejecutado el PFMS server. Si se coloca cero se establece sin límite alguno, utilizar con precaución. En el caso del Command Center se mostrará la suma del valor configurado en cada nodo.
Agent SNMP Interface Wizard defaults
Para completar la configuración SNMP de la sección anterior, bien se pueden establecer los valores predeterminados a utilizar para los diferentes módulos en el SNMP interface wizard.
Visual styles
Menú Management → Settings → System Settings → Visual styles
.
En esta sección se puede configurar todos los elementos visuales de Pandora FMS.
Style
Menú Management → Settings → System Settings → Visual styles
→ Style.
Configuración de estilo para los elementos gráficos:
Desde la versión 784 es posible seleccionar plantillas visuales a nivel de usuario y/o a nivel de grupo y/o a nivel general (en ese orden jerárquico de aplicación). En esta sección se describe a nivel general y dicha interfaz gráfica (que no valores de configuración) es compartida con otros niveles.
Notas importantes:
- Style template: Para añadir nuevos temas debe añadir un fichero CSS en el directorio:
…/pandora_console/include/styles
- Edit custom css: Pandora FMS se instala sin el fichero
custom.css, el cual (en caso de existir) es el último en cargar de todos los ficheros CSS. Para poder cambiar las clases CSS (predeterminadas en la Consola web PFMS) este archivo si no existe será creado automáticamente por un usuario administrador (al hacer clic en el botón) y se mantendrá invariable en cada actualización de versión PFMS. Un uso práctico es redefinir cada clase CSS:
.message-welcome { font-size: 40px; font-weight: bold; color: #4CAF50; text-transform: uppercase; font-family: Arial, sans-serif; }
Producirá el siguiente cambio en el mensaje de bienvenida:
- Status icon set: En el caso de usuarios con daltonismo, estos se pueden reemplazar por otros iconos conceptuales que permitan diferenciar los estados de otra manera.
- Custom favicon: Debe estar en formato
.icoy sus dimensiones en 16 por 16 píxeles para que funcione correctamente. Se pueden añadir iconos para elegir en la carpeta:…/pandora_console/images/custom_favicon
- Custom documentation logo y Custom support logo: Icono para el enlace a la documentación y soporte de la pantalla de inicio de sesión. Si se deja en blanco no se verá ningún icono. La ruta para subir más iconos es:
…/pandora_console/enterprise/images/custom_general_logos/
- Product name y Copyright notice: Por defecto, el nombre del producto es Pandora FMS, sin embargo se le da al usuario la opción de efectuar un rebranding y cambiarlo por otra cadena de texto y así tener una versión personalizada.
- Background opacity % (login): Permite especificar un porcentaje de opacidad (por defecto 30 %) en la pantalla de inicio de sesión.
- Disable helps: Desactiva los iconos de ayuda (enlaces a esta documentación). Los consejos (ayuda rápida) siempre se mantienen.
- Fixed header: El header siempre se muestra, es decir, no se esconde al hacer scroll (desplazamiento vertical de la ventana).
- Automatically hide submenu: Al activar esta opción, se minimiza el menú lateral.
- Random background (login): Si no se tiene un fondo de pantalla configurado para la pantalla de inicio de sesión (véase Custom background logo), al activar esta opción tendrá, de forma aleatoria, uno de varios ficheros gráficos almacenados en:
…/pandora_console/images/backgrounds/random_backgrounds
Los siguientes tokens de configuración alternativa para rebranding quedan almacenados en forma de comentario (comentados) en el fichero config.php
para conservar la configuración en caso de fallo de la base de datos:
// ----------Rebranding-------------------- // Uncomment this lines and add your customs text and paths. // $config["custom_logo_login_alt"] ="login_logo.png"; // $config["custom_splash_login_alt"] = "splash_image_default.png"; // $config["custom_title1_login_alt"] = "WELCOME TO Pandora FMS"; // $config["custom_title2_login_alt"] = "NEXT GENERATION"; // $config["rb_product_name_alt"] = "Pandora FMS"; // $config["custom_docs_url_alt"] = "http://pandorafms.com/manual/"; // $config["custom_support_url_alt"] = "https://support.pandorafms.com";
Behaviour
Menú Management → Settings → System Settings → Visual styles
→ Behaviour.
- Block size for pagination: Campo donde se elige el tamaño de la paginación de elementos (eventos, alertas, etcétera). Valor por defecto: 20.
- Click to display lateral menus: Este parámetro configurará si el menú lateral se despliega cuando se hace clic (botón principal del ratón) en él o cuando se coloca el ratón por encima.
- Paginated module view: Activar paginación en listado de módulos.
- Display data of proc modules in other format: Los datos tipo proc representan estados binarios de un módulo. En la base de datos se recogen como un número, pero también se podrían representar de forma descriptiva con un identificador para cada uno de los dos estados. Activando esta opción se usa esta segunda forma de representación.
- Display text when proc modules are in OK status: Cuando la opción Display data of proc modules in other format está activada, este texto aparece en sustitución del número cuando el módulo tiene un estado correcto.
- Display text when proc modules are in critical status: Cuando la opción Display data of proc modules in other format está activada, este texto aparece en sustitución del número cuando el módulo tiene un estado de fallo.
- Service label font size: Tamaño de fuente predeterminada para los servicios.
- Space between items in Service maps: Distancia (en píxeles) entre dos elementos de los mapas de servicios. Para evitar solapamientos este valor debe ser mayor a 80 píxeles.
- Tabs menu: Por defecto muestra iconos y menú contextual para la vista principal de los agentes en la Consola web. Las otras dos opciones (solamente iconos o solamente menú contextual) si no hay suficiente espacio en pantalla combina ambas opciones.
- Keyboard shortcut filter menu: Permite cambiar el atajo de teclado para los filtros laterales de las vistas, si es el caso. Solamente funciona con letras en minúsculas.
GIS
Menú Management → Settings → System Settings → Visual styles
→ GIS.
- GIS Labels: Activar las etiquetas o labels con el nombre de agente en los mapas GIS. Conviene desactivar esta opción cuando se tienen muchos agentes en un mapa, de esta forma es más legible.
- Default icon in GIS: Conjunto de iconos por defecto para los agentes en los mapas GIS.
Charts
Menú Management → Settings → System Settings → Visual styles
→ Charts.
Configuración de gráficas:
Notas importantes:
- Value to interface graphics: Nombre de las unidades para los gráficos de interfaz, por defecto
Bytes. - Data precision: Número de decimales a mostrar en informes y consolas visuales. Debe estar entre
0y5. - Data precision in graphs: Número de decimales a mostrar en las gráficas. Debe estar entre
0y20. - Number of elements in custom graph: Para limitar la cantidad de leyendas en las gráficas combinadas. Considérese también disminuir el ancho de las leyendas, hacerlas resumidas y lo más cortas posible. Las gráficas combinadas que responde a este token son de tipo:
- Línea.
- Área.
- Barras vertical.
- Barras horizontal.
- Apiladas o stacked.
- Chart fit to content: Existen gráficas cuyos valores son porcentuales y el tope de la gráfica excede el valor máximo cien, puede configurar las gráficas para que dejen de agregar un margen superior proporcional activando esta opción.
- Percentile: Muestra una línea con el percentil indicado en las gráficas. El valor por defecto es 95.
- El parámetro Graph TIP view indica si se visualizarán gráficas TIP:
- None (Ninguna): La opción TIP del setup de la gráficas estará desactivada (opción por defecto).
- All (Todas): La opción TIP del menú de las gráficas estará activado.
- On Boolean graphs (Gráficas booleanas): La opción TIP sólo se activará en el menú de las gráficas de tipo verdadero y falso.
Font and text
Menú Management → Settings → System Settings → Visual styles
→ Font and text.
Configuración de fuentes de letras y texto:
- Graphs font size: Campo donde se elige el tamaño de la fuente usada por PFMS para las gráficas.
- Show unit along with value in reports: Muestra las unidades además del valor del módulo en los informes.
- Truncate agent text at end y Truncate module text at end: Cuando están activados cortan el nombre de los agentes y módulos al final y colocan tres puntos suspensivos (el comportamiento por defecto es cortar a la mitad) para la sección Operation → Monitoring → Views.
- Agent text size: Cuando el nombre del agente es demasiado largo, en algunas secciones de Pandora FMS se trunca el texto mostrando solamente los primeros caracteres (valores por defecto: 18 caracteres cuando es pequeña la fuente y 50 caracteres cuando es tamaño normal).
- Module text size: Cuando el nombre de los módulos es demasiado largo, en algunas secciones de Pandora FMS se trunca el texto mostrando solamente los primeros caracteres (valores por defecto: 25 caracteres cuando es pequeña la fuente y 50 caracteres cuando es tamaño normal).
- Description text size: Cuando la descripción es demasiado larga, en algunas secciones de Pandora FMS se trunca el texto mostrando solamente los primeros caracteres (valor por defecto: 60 caracteres).
- Item title text size: Cuando el título es demasiado largo, en algunas secciones de Pandora FMS se trunca el texto mostrando solamente los primeros caracteres (valor por defecto: 45 caracteres).
Visual consoles
Menú Management → Settings → System Settings → Visual styles
→ Visual consoles.
Configuración de las consolas visuales:
- Default cache expiration: Este apartado indica cada cuanto tiempo borra la caché del estado de los elementos y, por lo tanto, cada cuánto tiempo calcula cada el estado de estos individualmente.
- Default interval for Visual Console to refresh: Este intervalo afectará únicamente a las páginas de las consolas visuales, estableciendo cada cuanto tiempo se refrescarán automáticamente.
- Type of view of visual consoles: Desplegable para indicar si se quiere que se muestren las consolas visuales favoritas en el menú.
- Number of favourite visual consoles to show in the menu: Para evitar solapamiento y ayudar en el rendimiento de la Consola web, con este token se limita el número de consolas favoritas a mostrar en el menú lateral.
- Default line width for the Visual Console: Ancho de la línea en las consolas visuales. Aunque esta opción se puede cambiar dentro de la propia consola visual de forma individual para cada línea, acá se detalla el valor por defecto
2. - Visual console default text margin (em): Por defecto 1 em, permite ampliar o disminuir el margen de etiqueta de texto en los elementos de Consolas visuales que lo utilicen (Static image, etcétera).
- Lock screen orientation when viewing on mobile devices: En la consola móvil impide que la pantalla sea girada de acuerdo al sensor de movimiento.
- Display item frame on alert triggered: Permite ocultar un cuadro de color naranja cuando tienen una alerta disparada en los elementos Static image, Simple value, Icon, Group de las Consolas visuales. Habilitado por defecto.
Reports
Menú Management → Settings → System Settings → Visual styles
→ Reports.
Configuración de informes:
- Show report info with description: Descripción de información de informes personalizados. Se aplica a todos los informes y plantillas por defecto.
- Front page for custom reports: Portada para informes personalizados. Se aplica a todos los informes y plantillas por defecto.
- PDF font size (px): Tamaño de la fuente de texto, en píxeles, para los ficheros PDF.
- HTML font size for SLA (em): Tamaño de la fuente para informes SLA (solamente HTML). Está en una medida relativa llamada em la cual equivale al número de veces el tamaño de la fuente en píxeles elegida.
- Graph image height for HTML reports: Altura en píxeles de gráficas de módulo o gráficas personalizadas en los informes (solamente HTML).
- Interval description: Muestra la descripción del intervalo de tiempo de forma abreviada o no. Una descripción larga (Long) es, por ejemplo “10 horas, 20 minutos, 33 segundos”; uno corto (Short) es “10h 20m 33s”.
El resto de los campos permite elegir logotipo personalizado y modificar la cabecera, pie de página y portada (se pueden incluir macros).
Services
Menú Management → Settings → System Settings → Visual styles
→ Services.
- Number of favorite services to show in the menu: Número máximo (entre
1y25) de servicios favoritos que se pueden mostrar en el submenú respectivo.
Other
Menú Management → Settings → System Settings → Visual styles
→ Other.
Otras configuraciones:
- Show only the name of the group: Se mostrará el nombre del grupo en lugar de mostrar su icono.
- Date format string: Campo donde se define el formato de fecha y hora según lo denota el lenguaje PHP; para agregar el timezone se debe colocar
T. - Show empty groups in group view: Permite visualizar los grupos vacíos en la vista de grupos.
- Visible time of successful notifications: Tiempo a transcurrir para mostrar, en segundos, para las notificaciones.
- Decimal separator: Separador decimal a utilizar en informes.
- Interval values: Aquí se pueden personalizar los valores de tiempo (segundos, minutos, etcétera) que va a tomar el campo Interval en los formularios de Pandora FMS (excepto para la vista de comentarios de eventos).
- Timestamp, time comparison, or compact mode: Define qué fecha y hora se usa, la marca de tiempo del sistema (Timestamp in rollover), una comparación con la base de datos (Rollover comparison) o de manera compacta (Compact mode). Esto es útil cuando la base de datos está en otro sistema diferente de donde se encuentra la consola Web.
- Custom value post processing: Valores de conversión personalizados para el postprocesado. Actualiza una tabla en base de datos para tener conversiones personalizadas de unas unidades a otras. Si por error agrega un valor numérico incorrecto, selecciónelo en la lista Delete custom values y bórrelo con el botón Delete que está a continuación y vuelva a agregar el valor de conversión personalizado.
- Module units: Esta opción permite definir la unidad de los datos que recogerán los módulos.
- CSV divider: Carácter o juego de caracteres con los que se van a separar los datos al exportar a CSV.
- CSV decimal separator: Símbolo a utilizar en el separador decimal al exportar a CSV.
- Data multiplier to use in graphs/data: Valor mediante el que multiplicará los datos mostrados para representarlos en las gráficas. Esto es útil en el caso de que la unidad de valor es bytes; para las demás conversiones utilice Custom value post processing.
- Hide general stats for non admin users in tactical view: En la Vista Táctica, por defecto, se entrega toda la información disponible. Al activar esta opción solamente los usuarios de tipo superadmin seguirán teniendo acceso a toda la información y para el resto de los usuarios será mostrada de manera filtrada.
NetFlow
Menú Management → Settings → System Settings → NetFlow
.
Se debe activar esta funcionalidad mediante el token Enable NetFlow. Para más información consultese el tema “Monitorización de red con NetFlow®”.
IOT Server
Menú Management → Settings → System Settings → IOT Server
.
Se debe activar esta funcionalidad mediante el token Enable IOT Server. La integración Pandora IOT tiene como finalidad supervisar mensajes que se reciben de un servidor broker de MQTT.
sFlow
Menú Management → Settings → System Settings → sFlow
.
Se debe activar esta funcionalidad mediante el token Enable NetFlow y luego ir a esa pestaña y desde allí activar sFlow®. Para más información consultese el tema “Monitorización de red con sFlow®”.
Pandora ITSM
Menú Management → Settings → System Settings → Pandora ITSM
.
Permite habilitar la conexión y comunicación entre Pandora FMS y Pandora ITSM. Al activar el botón Enable Pandora ITSM se podrá configurar para ser utilizado para todos los usuarios (opción por defecto habilitada) o para que cada usuario configure su propia conexión.
Pandora ITSM API settings
Se deberá configurar tanto la conexión entrante para Pandora ITSM y la conexión entrante para Pandora FMS para garantizar una comunicación bidireccional.
- URL to Pandora ITSM setup: Dirección web o dirección IP para conectar con la API de Pandora ITSM con formato similar a:
http://192.168.1.20/XXX/api/v2
- URL connect to API Pandora FMS: URL para conectar con la API de Pandora FMS, por defecto toma la establecida en el token Public URL y sino está establecida tomará la que tenga en
config.php. - Botones Test: Cada uno comprobará las conexión desde Pandora FMS a Pandora ITSM y viceversa.
- Si son exitosas las pruebas de conexión, Pandora ITSM tomará los agentes de PFMS y los convertirá en objetos de inventario y la gestión de incidencias de PITSM estará disponible desde PFMS.
Pandora RC
Menú Management → Settings → System Settings → Pandora RC
.
Habilitando la configuración con el botón Enable Pandora RC se tendrá acceso a la integración con Pandora RC.
Notifications
Menú Management → Settings → System Settings → Notifications
.
En Pandora FMS existe un sistema de notificación y supervisión del estado de la consola y en general del sistema. Puede habilitar las notificaciones siguiendo las instrucciones detalladas en la sección “Gestión de la consola”.
QuickShell
Menú Management → Settings → System Settings → QuickShell
.
Para el correcto funcionamiento de QuickShell será necesario tener instalado el binario de pandora_gotty en /usr/bin/.
Esta funcionalidad se instala por defecto y la única configuración adicional será la de permitir la conexión en el cortafuegos (firewall) que se se tenga instalado y agregar el número de puerto 8080.
Configuración de QuickShell
Se debe colocar la dirección IP o solamente la URL (sin http) de la Consola web PFMS y el número de puerto a utilizar, 8080 por defecto (se debe permitir conexión en el firewall correspondiente).
Se pude habilitar la conexión por medio de SSH (Enable SSH method) y/o Telnet (Enable telnet method). A continuación se puede probar y comprobar la conexión con los botones Test correspondientes.
Al guardar los valores con el botón Update se fuerza la ejecución de QuickShell.
Configuración opcional de QuickShell con métodos seguros
Si se poseen certificados SSL es recomendable cifrar la transmisión de las conexiones para fortalecer la seguridad informática.
Primero se debe haber configurado los valores básicos y comprobar las conexiones normales, sin cifrado alguno.
Luego para proceder a cifrar las comunicaciones (Use SSL correspondientes a SSH y/o Telnet) se debe realizar primero las siguientes configuraciones:
- Se debe contar con certificados SSL en la Consola web de Pandora FMS
- Dichos certificados deben contar con permisos de lectura para el servidor web Apache.
- Añadir las siguientes opciones de TLS/SSL en el fichero
/etc/pandora_gotty/pandora_gotty.conf(sustituya la ruta y nombre de fichero para cada parámetro con los valores a utilizar):
- /etc/pandora_gotty/pandora_gotty.conf
//Pandora GoTTY config file (…) // [bool] Enable TLS/SSL enable_tls = true // [string] Default TLS certificate file path tls_crt_file = "/path/.cert.crt" // [string] Default TLS key file path tls_key_file = "/path/key.key" // [bool] Enable cliente certificate authentication enable_tls_client_auth = false // [string] Certificate file of CA for client certificates tls_ca_crt_file = "/path/ca_cert.ca.crt" (…)
Con todo esto listo, por último se debe habilitar Use SSL en SSH y/o Telnet, guardar con el botón Update y volver a comprobar con los botones Test respectivos.
External tools
Menú Management → Settings → System Settings → External tools
.
En la sección de herramientas externas puede configurar los sonidos de alarma y las rutas de los siguientes ficheros ejecutables:
- Graphviz.
- Snmpget.
- Traceroute.
- Ping.
- Nmap.
- Dig.
Estas utilidades generalmente ya se encuentran instaladas con los sistemas operativos, si es necesario se deben instalar de manera adicional (Dig se instala con apt install dnsutils en Ubuntu y dnf install bind-utils en entornos RHEL y Rocky Linux). Por defecto se utilizan las rutas predeterminadas en el sistema operativo utilizado (aunque no se muestren) y se pueden cambiar en esta sección de la configuración general de PFMS.
Además se podrán definir comandos personalizados utilizando macros para interactuar con los agentes de Pandora FMS. Al añadir la macro _address_ se utilizará la dirección IP del agente al realizar la ejecución.
Welcome tips
Menú Management → Settings → System Settings → Welcome tips
.
Los consejos son mensajes cortos, acompañados o no de un enlace web para obtener más detalles del consejo mostrado al iniciar sesión en la Consola web PFMS. Se puede establecer el idioma de cada uno de ellos y para editarlos cuenta con un filtro que permite buscar por palabra clave en el título de cada consejo.
Cada usuario podrá establecer su propia configuración de usuario con el token Show usage tips at startup.
Mediante la clasificación de Perfiles establecida en PFMS se pueden configurar los consejos de bienvenida en la lista en Profile, según el perfil permitido a cada usuario podrán o no visualizarlos.
- Agréguese una o más imágenes relacionadas siempre y cuando el tamaño de las mismas sea de 464 por 260 pixeles.
- Cada consejo puede estar o no habilitado para ser visualizado.
GIS map connection
Menú Management → Settings → System Settings → QuickShell
.
Se debe activar esta funcionalidad mediante el token Enable GIS features. Toda la documentación sobre los mapas GIS se puede encontrar en el tema “Pandora FMS GIS”.
License
Menú Management → Settings → License.
Una vez se haya instalado Pandora FMS podrá realizar la aplicación de una licencia.
Luego en esta sección podrá conocer el estado de la misma, solicitar una validación (botón Validate) para el caso de la reinstalación de una instancia de Pandora FMS o solicitar una nueva licencia (botón Request new license).
En el botón Show agent usage detail podrá conocer la cantidad total de agentes (con la opción de filtrar por agentes habilitados) así como los subtotales clasificados en tres grandes categorías.
El servidor se instala con una licencia trial válida para un máximo de 100 agentes y un mes de uso. Si se desea expandir esta licencia, contacte con su comercial de confianza o rellene el siguiente formulario de contacto.
Translate string
Menú Management → Settings → Translate String.
Se podrá hacer traducciones personalizadas (columna Customize translation) incluso con variables macro; esta extensión está descrita por completo en la sección Translate string.
Admin tools
Menú Management → Admin tools.
System audit log
Menú Management → Admin tools → System audit log.
Pandora FMS guarda un registro o log de todos los cambios y acciones de importancia producidos en la Consola de Pandora FMS. Puede obtener más información en la sección Log de auditoría.
Demo data
Menú Management → Admin tools → Demo data.
Esta opción permite generar un mínimo de 30 agentes con datos demostrativos y con valores por defecto asignados.
Se debe contar con un Heavy Server habilitado en el entorno para que los datos de los agentes generados se actualicen periódicamente.
Es posible que se tenga que aumentar el valor del parámetro plugin_timeout en la configuración del servidor para que se actualicen todos los datos de los agentes.
Al pulsar en opciones avanzadas (Advanced options) se podrá ajustar los siguientes parámetros:
- Agents interval: Cinco minutos, valor por defecto.
- Generate historical data for all agents: Al estar activado se generarán datos históricos para los agentes a crear, con la cantidad de días especificados en el campo Days of historical data to insert in the agent data (
15días por defecto). - Create services: Permite crear servicios.
- Create network maps: Permite crear mapas de red.
- Create GIS maps: Permite crear mapas de localización geográfica.
- Create custom graphs: Permite crear gráficas personalizadas
- Create reports: Permite crear informes.
- Create visual consoles: Permite crear consolas visuales.
- Create dashboards: Permite crear dashboards.
- Traps target IP: Dirección IP para las SNMP traps (
127.0.0.1por defecto). Todas las SNMP traps de demostración se generan con la versión 1. - Traps community: Comunidad para las SNMP traps (
publicpor defecto). - Tentacle target IP: Dirección IP para envío de datos mediante protocolo Tentacle (
127.0.0.1por defecto). - Tentacle port: Número de puerto para el protocolo Tentacle (
41121por defecto). - Tentacle extra options: Parámetros del protocolo Tentacle.
Al pulsar el botón Create demo data serán introducidas todas las opciones escogidas, mientras se genere el entorno de demo se podrá ver una barra de progreso y el estado de la creación de cada tipo de elemento una vez completado. De acuerdo al número de agentes seleccionados podrá tardar más o menos tiempo.
Posteriormente se podrán eliminar todos estos datos con el botón Delete all demo data.
Links
Menú Management → Admin tools → Links.
Permite agregar, editar o eliminar los enlaces básicos para el funcionamiento de Pandora FMS, así como todos los enlaces que se consideren necesarios para los demás usuarios (menú Operations → Links).
Al instalar PFMS estarán disponibles las siguientes opciones:
- Documentation: Para acceder a estos documentos (
https://pandorafms.com/manual). - Get support: Para reportar y obtener ayuda en cualquier tema relacionado con Pandora FMS (
https://support.pandorafms.com/itsm). Las sugerencias son bienvenidas. - Module library: Enlace esencial para mantener actualizados los elementos de Discovery PFMS y los plugins (
https://marketplace.pandorafms.com/).
Por defecto las descripciones de los enlaces están en inglés, bien se pueden traducir manualmente a su idioma principal en cualquier momento.
Diagnostic info
Menú Management → Admin tools → Diagnostic info.
Herramienta visual que muestra el estado actual del Pandora FMS Server y su Consola web.
Existe la opción de exportar toda la información en un fichero tipo PDF.
Site news
Menú Management → Admin tools → Site news.
Cuando sea necesario suministrar información importante a los usuarios se pueden crear mensajes destinados al grupo de usuarios o a todos los usuarios. Esto se realiza de dos maneras:
- En la vista inicial se agregará una sección News Board con todos los mensajes vigentes, ya que se puede colocar una fecha de vencimiento a cada uno de ellos.
- La otra manera, solamente destinada a los mensajes de mucha importancia, es una ventana modal que aparecerá cuando el usuario inicie sesión en Consola web y cerrará al pulsar el botón OK. Úsese con discreción porque será mostrada tantas veces como inicie sesión el usuario.
Para crear una noticia pulse Add, escriba el asunto o título en Subject, seleccione el grupo que recibirá el anuncio y la fecha límite para ser mostrado. Si selecciona Modal window la noticia se mostrará en una venta emergente que el usuario debe leer y cerrar.
File Manager
Menú Management → Admin tools → File Manager.
Herramienta útil para subir contenidos gráficos en Pandora FMS. Se mostrará inicialmente todo el contenido de la carpeta images dentro de la instalación de Pandora FMS Server.
El tamaño de cada imagen está limitado por el valor especificado en el token Collection size (Bytes)
- Descárguense los archivos que se deseen haciendo clic en el nombre de cada uno de ellos.
- También se podrán borrar algunos ficheros que tengan el icono
, ya que el resto son archivos de sistema utilizados por la Consola PFMS.
- Un directorio solamente podrá ser borrado si está vacío.
- Si desean personalizar las imágenes en las Consolas Visuales, se necesitan cuatro imágenes distintas, una para cada estado, utilizando una nomenclatura especial para dichas imágenes:
| <nombre_imagen>_<estado>.png |
Donde cada estado puede ser:
- <nombre_imagen>_bad.png crítico.
- <nombre_imagen>_ok.png normal.
- <nombre_imagen>_warning.png advertencia.
- <nombre_imagen>.png desconocido.
Para cada elemento listado se dispone de un botón el cual informa su ruta exacta en una ventana emergente.
Si se encuentra en un subdirectorio puede regresar rápidamente al inicio pulsando de nuevo el elemento de menú File manager.
Import from MINI
Menú Management → Admin tools → Import from MINI.
Pandora MINI es una aplicación de escritorio para MS Windows® y Linux® que permite realizar chequeos de red, exploraciones y diagnósticos básicos sin depender de servidores ni configuraciones complejas.
Llegado el momento en que su uso haya llegado al máximo se pueden exportar casi todos sus componentes y ser agregados a Pandora FMS en un fichero con formato JSON y extensión .mini.
En este resumen de agentes y módulos importados se podrá hacer clic en cada uno de ellos y se abrirán en una ventana nueva del navegador web. Dado el caso de existir algún inconveniente en este proceso será notificado por el icono y haciendo clic allí se obtendrán los detalles.
La importación de elementos desde Pandora MINI es también una de las opciones del Asistente General (menú Management → Configuration → General wizard → Task to perform).
DB Schema Check
Menú Management → Admin tools → DB Schema Check.
Esta es una extensión que permite comprobar las diferencias estructurales entre la base de datos establecidas Pandora FMS, y un esquema patrón para comparar posibles errores.
DB Interface
Menú Management → Admin tools → DB Interface.
Permite ejecutar comandos directamente en la base de datos y ver el resultado. Es una herramienta avanzada que sólo debe ser usada por personas que conozcan SQL y el esquema de base de datos de Pandora FMS en suficiente detalle.
DB Backup Manager
Menú Management → Admin tools → DB Backup Manager.
Permite administrar las copias de seguridad de la base de datos, programadas y realizadas mediante una tarea de Consola.
- En el apartado Filters se podrá escoger de la lista desplegable en Path backups la ubicación de los respaldos disponibles. Presione el botón Search para actualizar la lista de respaldos.
Acoustic console setup
Menú Management → Admin tools → Acoustic console setup.
Permite configurar los nuevos sonidos por defecto para las diferentes alarmas de eventos.
API checker
Menú Management → Admin tools → API checker.
El API checker permite llamar y comprobar la API externa versión 1.0 de Pandora FMS.
Consulte la sección API Externa.
Extension manager
Menú Management → Admin tools → Extension manager.
Contiene dos importantes opciones: para mantener las extensiones registradas y para instalar nuevas extensiones.
Extension manager view
Menú Management → Admin tools → Extension manager → Extension manager view.
Las extensiones son una manera de desarrollar nuevas funcionalidad para la Consola web de Pandora FMS, así como plugins. Consulte el tema “Desarrollo de extensiones de consola” para más información.
Nota: La gestión de extensiones de tipo visible adiciona o elimina elementos en el menú lateral izquierdo de la Consola web.
En cada extensión listada se podrá deshabilitar haciendo clic en el icono
correspondiente a cada extensión. Una vez deshabilitada será ubicada al final del listado.
También se podrá borrar una extensión con el botón correspondiente.
Algunas extensiones son de uso esencial en la Consola PFMS. El mismo Extension uploader es una extensión para instalar nuevas extensiones por lo que su borrado eliminará dicha función.
Extension uploader
Menú Management → Admin tools → Extension manager → Extension uploader.
Permite subir (e instalar) una extensión. El fichero a subir debe estar comprimido en formato .zip.
Si la extensión utiliza el componente gpolicies se debe marcar la opción Upload Enterprise extension. Una vez haya elegido el archivo, haga clic en el botón Upload para finalizar el proceso. La nueva extensión será mostrada en el Extension manager view.
System logfiles
Menú Management → Admin tools → Extension manager → System logfiles.
En esta sección se podrá visualizar, limitado al tamaño del token Log size limit in system logs viewer extension, el contenido de los siguientes ficheros:
/var/www/html/pandora_console/log/console.log /var/log/pandora/pandora_server.log /var/log/pandora/pandora_server.error
Import groups with CSV file
Menú Management → Admin tools → Extension manager → Import groups with CSV file.
Consulte la sección Importar grupos desde CSV en el tema «Gestión y administración de la consola».
Resources
Menú Management → Resources.
Operating systems
Menú Management → Resources → Operating systems.
En esta sección se pueden editar o crear nuevos tipos de Sistemas Operativos (SO). Estos grupos son importantes para el aprovisionamiento automático de agentes.
Dado el caso de que se tenga un sistema operativo nuevo, se puede agregar a la lista que viene por defecto al instalar PFMS. Para ello se pulsa en el botón Create OS, se coloca el nombre correspondiente y se escoge un icono de la lista. En caso de tener un icono nuevo en formato JPG, JPEG, PNG o SVG se utiliza el botón Upload icon, se almacena en PFMS y luego se busca y elige por su nombre.
Se finaliza el proceso de creación de un SO con el botón Create.
A partir de la versión 774 PFMS tiene habilitada la funcionalidad de obsolescencia programada, la cual trabaja con inventario para obtener informes con filtros de los dispositivos monitorizados.
Tools
Menú Management → Tools.
Export data
Menú Management → Tools → Export data.
Permite escoger un agente (que puede ser filtrado por grupo) por su nombre y luego seleccionar uno más módulos del mismo.
Por defecto el período de tiempo es de las últimas 24 horas y los formatos disponibles de exportación son:
- Data Table: Un formato especial del lenguaje PHP y que muestra por pantalla el nombre del agente, nombre del módulo, valor del dato y fecha y hora de recolección del dato.
- Average per hour/day: Si el dato es numérico y susceptible de calcular su promedio, se mostrará por pantalla de manera parecida a la opción Data table.
- CSV: Fichero en formato de campos delimitados por comas.
- MS Excel: Fichero de hoja de cálculo, formato para Microsoft Excel®.
File repository
Menú Management → Tools → File repository.
El administrador de repositorio de archivos permite colocar los recursos que se necesiten para los dispositivos a monitorizar cuando se considere oportuno.
En la pestaña Management view seleccione el grupo o los grupos que descargarán ese recurso y explore su almacenamiento local para subir dicho fichero. Si se necesita que sea público este recurso (solamente para quienes conozcan el enlace), márquese la casilla de Public link. En la descripción se puede agregar un máximo de 200 caracteres.
El token Attachment directory define la ubicación del directorio de adjuntos.
Haga clic en el botón Add y espere a que finalice el proceso de subida. Al entrar en la pestaña Operation view, en cada elemento listado:
- Para compartir el enlace público de cada fichero hágase clic en el icono
para copiar el enlace web. - Si otro operador de la misma Consola PFMS está en otro equipo, podrá descargar un recurso haciendo clic en el botón
. - Si ya es innecesario el fichero se puede borrar con el botón
respectivo.





















