====== Plantillas y componentes ======
{{indexmenu_n>3}}
===== Plantillas y componentes =====
==== Introducción ====
Pandora FMS realiza todas las comprobaciones a través de Módulos, permitiendo procesar diferentes tipos de datos en función del elemento a monitorizar. La lista completa de Módulos predeterminados que contiene Pandora FMS se puede consultar en la sección **Management** → **Resources** → **Module types**.
En Pandora FMS existen diferentes tipos de Módulos, algunos son:
* **async:** Datos asíncronos.
* **generic:** Datos genéricos.
* **keep_alive:** Módulo especial Keep Alive ("//mantener en línea//"), sirve para controlar el estado del último contacto con un Agente.
* **icmp:** Comprobación ICMP (**ping**).
* **snmp:** Comprobación SNMP.
* **tcp:** Comprobación TCP.
* **web:** Comprobación web.
Estos tipos de Módulos //pueden almacenar diferentes tipos de datos//, por ejemplo:
* **data:** Datos numéricos.
* **proc:** Valor booleano, 1 es cierto y 0 falso.
* **string:** Cadena de texto.
* **inc:** Datos incrementales por unidad de tiempo.
* **inc_abs:** Datos incrementales absolutos que muestran solamente el valor incrementado desde la última lectura.
=== Componentes ===
Un componente es un //Módulo genérico// que se puede aplicar repetidamente sobre un Agente, como si fuera una "copia maestra" de un Módulo, generando un Módulo asociado a un Agente. Con esta herramienta se pueden crear y mantener una lista de los componentes más utilizados para aplicarlos a los agentes nuevos.
* **Componentes de red**: Agrupan a todos los módulos de tipo remoto (WMI, TCP, SNMP, ICMP, //plugin//, etcétera).
* **Componentes locales**: Incluyen la definición de los módulos de Agentes software, como "trozos" de texto que se incorporarán al archivo de configuración del Agente (con configuración remota habilitada, versión **Enterprise**) o se pueden cortar y pegar en la configuración de los agentes manualmente (sin configuración remota, versión **Open**).
=== Plantilla de componentes ===
Los componentes de red se pueden agrupar en //plantillas//, de tal manera que se puede aplicar múltiples componentes de red directamente sobre un Agente. Se pueden crear así varios módulos de forma simultánea a través de los componentes de red asociados a una plantilla.
El [[:es:documentation:pandorafms:introduction:02_architecture#servidor_de_reconocimiento|servidor Recon]] aplica los componentes de red asociados a una plantilla sobre los //hosts// detectados, agregando los módulos especificados de forma automática y permitiendo así un despliegue de monitorización automática.
==== Componentes de red ====
Menú **Management** → **Configuration** → **Templates** → **Remote components**.
En esta lista se podrá buscar los componentes ya existentes (filtrando por grupos o por texto de búsqueda libre), ver su configuración en detalles, modificarlos o crear nuevos componentes. Para editar las propiedades de un módulo cualquiera, haga clic sobre su nombre.
Si se modifica la plantilla, sus valores se aplicarán a los módulos que se creen desde ese instante, **no a los que ya estén creados.**
=== Crear componentes de red nuevos ===
Para crear un componente de red, vaya al menú **Configuration** → **Templates** → **Remote components**, y en la parte inferior de la página, en el menú desplegable seleccione un componente de red de los cuatro posibles (Network, Plugin, Wizard o WMI) y pulse el botón **Create**.
//Por ser un componente genérico// algunos parámetros como **snmp community**, **user** o **password** pueden ser diferentes según los agentes a los que le aplique el Módulo posteriormente, en esos casos se pueden dejar en blanco. Si se dispone de una política de usuarios comunes para los sistemas, los módulos se pueden dejar configurados por completo introduciendo nombres de usuarios, contraseñas y otros datos que sean comunes para todos los agentes.
El mismo proceso se realiza para componentes de tipo //plugin//,al seleccionar en la lista **Plugin** en la interfaz aparecerán los campos definidos en las macros de dicho //plugin// seleccionado.
==== Componentes locales ====
Menú **Management** → **Configuration** → **Templates** → **Local components**.
[[https://pandorafms.com/es/precios-de-pandora-fms/?o=dwpfms|{{:wiki:icono-modulo-enterprise.png?nolink&23x23 |Versión Enterprise}}]]Los componentes locales hacen referencia a los componentes que se pueden aplicar a los Agentes Software. Si se dispone de la versión Enterprise de Pandora FMS, estos componentes se pueden aplicar de forma automática a todos los agentes a través de las políticas o de forma manual (uno a uno) en el editor de configuración remota del Agente. Pandora FMS dispone de decenas de módulos locales para aplicar a las políticas y a los agentes de forma automática, ordenados por categorías.
Consulte la [[:es:documentation:pandorafms:complex_environments_and_optimization:02_policy|sección de políticas]] para saber cómo aplicar componentes locales a agentes software de forma remota en su Pandora FMS Enterprise.
La lista de módulos locales ya existentes se pueden filtrar por diversos parámetros (grupo, sistema operativo, consulta de texto libre) y también se puede ver, modificar y crear nuevos componentes. Para editar un módulo cualquiera haga clic en su nombre respectivo.
=== Crear componentes locales nuevos ===
Para crear un componente local nuevo, vaya a la página principal de administración de componentes locales, Menú **Management** → **Configuration** → **Templates** → **Local components** y pulse el botón **Create** en la parte inferior derecha de la página.
Aparecerá la página con el formulario de creación del componente local nuevo. Rellene el formulario con la información antes mencionada y pulse de nuevo el botón **Create** para guardar.
=== Macros de ejecución local ===
Es posible definir macros en los componentes locales. Estas macros serán usadas en el parámetro [[:es:documentation:pandorafms:installation:05_configuration_agents#module_exec|module_exec]] y tendrán la estructura ''_field1_'' , ''_field2_'' … ''_fieldN_''.
Las macros aparecerán en el formulario de edición de Módulos como campos normales, de forma transparente al usuario.
Si un componente de Módulo tiene macros, los datos de configuración estarán ocultos por defecto para simplificar la vista, pero es posible mostrarlos y modificarlos. Si es definida una cadena en el campo **Help**, aparecerá un //tip// junto al campo con esta cadena.
==== Plantillas de módulos ====
Las plantillas de módulos son plantillas que contienen módulos de comprobaciones de red. Estas plantillas, una vez creadas, se pueden aplicar directamente a agentes, evitando tener que añadir los módulos de uno en uno, o bien aplicar las plantillas al realizar una [[:es:documentation:pandorafms:monitoring:04_discovery|tarea de reconocimiento de red]].
Menú **Management** → **Configuration** → **Templates** → **Module templates**.
De la lista pulsar sobre el nombre cualquiera de las plantillas para editarla, hacer clic sobre el icono papelera en la columna de la derecha para borrarla.
Con el botón **Create** se agrega plantilla nueva. Rellene los campos **Name** y [[:es:documentation:pandorafms:management_and_operation:03_templates_and_components#private_enterprise_number|PEN]] y //guarde pulsando el botón// **Create**. Aparecerá el botón **Add components** donde podrá filtrar por grupo, seleccione los componentes necesarios y pulse **OK**. Para finalizar la creación haga clic en el botón **Update**.
=== Aplicar una plantilla de módulos a un Agente ===
Para aplicar una de las plantillas de módulos de monitorización ya existentes, o una creada, se debe ir a la configuración de un agente mediante el menú **Resources** → **Manage agents**. De la lista de agentes, seleccione uno mediante el enlace **Modules** correspondiente. Una vez acceda a esta pantalla, debe pulsar sobre la solapa de las plantillas, **Module templates**, en la parte superior de la página.
Se mostrarán los módulo que ya tiene el Agente y las plantillas de Módulos existentes. Seleccione una plantilla y pulse el botón **Assign**. Automáticamente se añadirán los módulos que contenga esa plantilla. Una vez aplicada la plantilla, puede borrar algunos de los módulos haciendo clic en el icono de papelera, o puede editarlos pulsando sobre el icono de herramienta. //Los Módulos agregados tendrán una descripción automática basada en el nombre de la plantilla//.
No se muestran las plantillas que se han aplicado sobre el agente, solo los módulos que estas contienen.
==== Private Enterprise Number ====
Todos los dispositivos SNMP cuentan con una cadena identificativa (OID), que es única para cada marca y modelo de un dispositivo. Dentro de esas cadenas existe un número que se encuentra en la séptima posición y es el que determina a cual fabricante pertenece el dispositivo.
Este número es el **Private Enterprise Number** ( **PEN** ) de un fabricante y se encuentra registrado en la IANA. Se pueden configurar estos PEN en Pandora FMS para utilizarlos junto con las plantillas de módulos y agregar así monitorización de forma dinámica.
Vaya al menú **Management** → **Configuration** → **Templates** → **Private Enterprise Numbers** para tener acceso a la lista de PEN registrados. Puede editar y/o borrar cada uno de los PEN registrados al hacer clic en los iconos correspondientes de la columna **Options**.
Para registrar un nuevo fabricante, haga clic en el botón **Register manufacturer**. Solo será necesario insertar el PEN correspondiente del fabricante, indicar su nombre y una descripción. De esta manera se agregará al listado ya existente.
En las plantillas de módulos se indicarán uno o varios PEN de manera que cuando se lleve a cabo una tarea de descubrimiento, Pandora FMS sea capaz de obtener el fabricante del dispositivo y agregarle la monitorización adecuada.
==== Componentes de Wizard ====
Dentro de las capacidades del wizard SNMP y el wizard WMI, se encuentran un tipo de componentes remotos llamados //[[:es:documentation:pandorafms:technical_annexes:25_pfms_new_wizard_component|Componentes de wizard]]// .
Estos componentes permiten establecer una configuración base para los módulos que serán generados en los agentes al ejecutar cualquiera de los wizard (SNMP o WMI). Además ofrece la posibilidad de que con un solo componente se puedan generar varios módulos de forma dinámica. Por ejemplo, un componente para escanear las distintas unidades de almacenamiento de un dispositivo o los procesos en ejecución.
Se pueden crear estos componentes desde el menú **Management** → **Configuration** → **Templates** → **Remote components**.
==== Grupos de componentes ====
Para ayudar a ordenar y clasificar los componentes existen los grupos de componentes. Los componentes se asocian en grupos de componentes a la hora de crearlos.
Para ver los grupos de componentes existentes vaya a **Management** → **Resources** → **Component groups**. En pantalla se mostrarán los grupos existentes y su descripción. Se pueden ver los detalles de los grupos pulsando sobre su nombre, borrarlos pulsando sobre icono de papelera a la derecha, en la columna **Action**, y crear nuevos pulsando en el botón inferior **Create**. También puede seleccionar varios por medio de su respectiva casilla de selección y pulsar en el botón **Delete**.
Con el botón **Create** se puede crear un grupo de componentes nuevo. Rellene los campos en el formulario, proporcione un nombre para el grupo y seleccione si tiene un padre dentro de los grupos existentes. Después, pulse de nuevo el botón **Create**. Ahora podrá añadir componentes nuevos a su recién creado grupo de componentes.
[[:es:documentation:start|Volver al Índice de Documentación Pandora FMS]]