3 Descubrimiento de bajo nivel

Descripción general

La detección de bajo nivel (LLD) descubre automáticamente entidades (por ejemplo, sistemas de archivos, interfaces de red) en un host y crea los items, triggers y gráficos correspondientes sin necesidad de configuración manual para cada una.

Para usar LLD, se crea una regla de descubrimiento que recopila datos JSON que describen entidades, y prototipos (item, trigger y gráfico) para cada entidad.

El JSON devuelto por la regla debe ser un array de objetos, donde cada objeto representa una entidad descubierta mediante pares clave-valor. Por ejemplo, una regla de descubrimiento con net.if.discovery podría devolver:

[
  {"{#IFNAME}": "lo"},
  {"{#IFNAME}": "eth0"}
]

A continuación, se crea un conjunto correspondiente de items, triggers y gráficos a partir de los prototipos: uno por cada interfaz (lo y eth0).

Si los objetos contienen claves en el formato {#MACRO}, esas macros se usan directamente en los prototipos. Si no es así, o si se requieren macros adicionales/personalizadas, las macros pueden definirse manualmente y asignarse a campos JSON mediante JSONPath.

LLD también puede crear hosts (por ejemplo, para máquinas virtuales descubiertas en un hipervisor) y admite reglas de descubrimiento anidadas para el descubrimiento multinivel.

Las entidades que ya no se descubren pueden deshabilitarse o eliminarse automáticamente.

Configuración del descubrimiento de bajo nivel

Ilustraremos el descubrimiento de bajo nivel con un ejemplo de descubrimiento del sistema de archivos.

Para configurar el descubrimiento, haga lo siguiente:

1. Vaya a Data collection > Templates o Hosts.
2. Haga clic en Discovery en la fila de la template o host correspondiente.

3. Haga clic en Create discovery rule en la esquina superior derecha de la pantalla.
4. Complete el formulario de la regla de descubrimiento con los detalles requeridos.

Regla de descubrimiento

El formulario de la regla de descubrimiento contiene cinco pestañas que representan, de izquierda a derecha, el flujo de datos durante el descubrimiento:

• Regla de descubrimiento: especifique qué item integrado o script personalizado se utilizará para recuperar los datos de descubrimiento.
• Preprocesamiento: aplique algún preprocesamiento a los datos descubiertos.
• Macros LLD: permiten extraer valores de macros para utilizarlos en items descubiertos, triggers, etc.
• Filtros: permiten filtrar los valores descubiertos.
• Anulaciones: permiten modificar items, triggers, gráficos o prototipos de host cuando se aplican a objetos descubiertos específicos.

La pestaña Regla de descubrimiento contiene la clave del item que se utilizará para el descubrimiento, así como algunos atributos generales de la regla de descubrimiento:

Todos los campos de entrada obligatorios están marcados con un asterisco rojo.

Preprocesamiento

La pestaña Preprocesamiento permite definir reglas de transformación que se aplicarán al resultado del descubrimiento. En este paso se pueden realizar una o varias transformaciones. Las transformaciones se ejecutan en el orden en que se definen. Todo el preprocesamiento lo realiza el Zabbix server.

Véase también:

• Detalles del preprocesamiento
• Pruebas de preprocesamiento

Tenga en cuenta que, si la regla de descubrimiento se ha aplicado al host mediante un template, el contenido de esta pestaña es de solo lectura.

Macros personalizadas

La pestaña Macros LLD permite especificar macros personalizadas de descubrimiento de bajo nivel.

Las macros personalizadas son útiles cuando el JSON devuelto no contiene las macros necesarias ya definidas. Por ejemplo:

• La clave nativa vfs.fs.discovery para el descubrimiento de sistemas de archivos devuelve un JSON con algunas macros LLD predefinidas, como {#FSNAME}, {#FSTYPE}. Estas macros se pueden utilizar directamente en los prototipos de item y trigger (consulte las secciones siguientes de esta página); no es necesario definir macros personalizadas;
• El item de agent vfs.fs.get también devuelve un JSON con datos del sistema de archivos, pero sin macros LLD predefinidas. En este caso, puede definir las macros usted mismo y asignarlas a los valores del JSON mediante JSONPath:

Los valores extraídos se pueden utilizar en items, triggers descubiertos, etc. Tenga en cuenta que los valores se extraerán del resultado del descubrimiento y de todos los pasos de preprocesamiento realizados hasta el momento.

Filtro

Se puede utilizar un filtro para generar items, triggers y gráficos reales únicamente para las entidades que coincidan con los criterios. La pestaña Filtros contiene definiciones de filtros de reglas de descubrimiento que permiten filtrar los valores descubiertos:

Por ejemplo, si solo le interesan los sistemas de archivos C:, D: y E:, puede introducir {#FSNAME} en el campo Macro y ^C|^D|^E en el campo Expresión regular.
También es posible filtrar por tipos de sistemas de archivos mediante la macro {#FSTYPE} (por ejemplo, ^ext|^reiserfs) y por tipos de unidad (compatibles únicamente con Windows agent) mediante la macro {#FSDRIVETYPE} (por ejemplo, fixed).

Para probar una expresión regular, puede utilizar grep -E, por ejemplo:

for f in ext2 nfs reiserfs smbfs; 
do echo $f | grep -E '^ext|^reiserfs' || echo "SKIP: $f"; 
done

Anulación

La pestaña Anulaciones permite establecer reglas para modificar la lista de prototipos de item, trigger, gráfico, host y descubrimiento, o sus atributos, para los objetos descubiertos que cumplan determinados criterios.

Las anulaciones (si existen) se muestran en una lista reordenable mediante arrastrar y soltar, y se ejecutan en el orden en que están definidas. Para configurar los detalles de una nueva anulación, haga clic en en el bloque Anulaciones. Para editar una anulación existente, haga clic en su nombre. Se abrirá una ventana emergente que permite editar los detalles de la regla de anulación.

Todos los parámetros obligatorios están marcados con asteriscos rojos.

Configuración de una operación

Para configurar los detalles de una nueva operación, haga clic en en el bloque Operaciones. Para editar una operación existente, haga clic en junto a la operación. Se abrirá una ventana emergente en la que podrá editar los detalles de la operación.

Parámetro			Descripción
Objeto			Hay cinco tipos de objetos disponibles: Prototipo de item Prototipo de trigger Prototipo de gráfico Prototipo de host Prototipo de descubrimiento
Condición			Permite filtrar las entidades a las que debe aplicarse la operación.
	Operador		Operadores compatibles: es igual a: aplicar a este prototipo no es igual a: aplicar a todos los prototipos excepto este contiene: aplicar si el nombre del prototipo contiene esta cadena no contiene: aplicar si el nombre del prototipo no contiene esta cadena coincide: aplicar si el nombre del prototipo coincide con la expresión regular no coincide: aplicar si el nombre del prototipo no coincide con la expresión regular
	Patrón		Una expresión regular o una cadena que buscar.
	Objeto: Prototipo de item
		Crear habilitado	Al marcar la casilla, aparecerán botones que permiten anular la configuración original del prototipo de item: Sí: el item se añadirá en estado habilitado. No: el item se añadirá a una entidad descubierta, pero en estado deshabilitado.
		Descubrir	Al marcar la casilla, aparecerán botones que permiten anular la configuración original del prototipo de item: Sí: el item se añadirá. No: el item no se añadirá.
		Intervalo de actualización	Al marcar la casilla, aparecerán dos opciones que permiten establecer un intervalo diferente para el item: Retraso: intervalo de actualización del item. Se admiten macros de usuario, macros de LLD y sufijos de tiempo (por ejemplo, 30s, 1m, 2h, 1d). La compatibilidad con macros de LLD se restauró en Zabbix 7.4.11. Debe establecerse en 0 si se utiliza Intervalo personalizado. Intervalo personalizado: haga clic en para especificar intervalos flexibles o programados. Para obtener información detallada, consulte Intervalos personalizados.
		Historial	Al marcar la casilla, aparecerán botones que permiten establecer un período de almacenamiento del historial diferente para el item: No almacenar: si se selecciona, el historial no se almacenará. Almacenar hasta: si se selecciona, aparecerá a la derecha un campo de entrada para especificar el período de almacenamiento. Se admiten macros de usuario y macros de LLD. La compatibilidad con macros de LLD se restauró en Zabbix 7.4.11.
		Tendencias	Al marcar la casilla, aparecerán botones que permiten establecer un período de almacenamiento de tendencias diferente para el item: No almacenar: si se selecciona, las tendencias no se almacenarán. Almacenar hasta: si se selecciona, aparecerá a la derecha un campo de entrada para especificar el período de almacenamiento. Se admiten macros de usuario y macros de LLD. La compatibilidad con macros de LLD se restauró en Zabbix 7.4.11.
		Etiquetas	Al marcar la casilla, aparecerá un nuevo bloque que permite especificar pares etiqueta-valor. Se admiten macros de usuario y macros de LLD. Estas etiquetas se añadirán a las etiquetas especificadas en el prototipo de item, incluso si los nombres de las etiquetas coinciden.
	Objeto: Prototipo de trigger
		Crear habilitado	Al marcar la casilla, aparecerán botones que permiten anular la configuración original del prototipo de trigger: Sí: el trigger se añadirá en estado habilitado. No: el trigger se añadirá a una entidad descubierta, pero en estado deshabilitado.
		Descubrir	Al marcar la casilla, aparecerán botones que permiten anular la configuración original del prototipo de trigger: Sí: el trigger se añadirá. No: el trigger no se añadirá.
		Severidad	Al marcar la casilla, aparecerán botones de severidad del trigger que permiten modificar su severidad.
		Etiquetas	Al marcar la casilla, aparecerá un nuevo bloque que permite especificar pares etiqueta-valor. Se admiten macros de usuario y macros de LLD. Estas etiquetas se añadirán a las etiquetas especificadas en el prototipo de trigger, incluso si los nombres de las etiquetas coinciden.
	Objeto: Prototipo de gráfico
		Descubrir	Al marcar la casilla, aparecerán botones que permiten anular la configuración original del prototipo de gráfico: Sí: el gráfico se añadirá. No: el gráfico no se añadirá.
	Objeto: Prototipo de host
		Crear habilitado	Al marcar la casilla, aparecerán botones que permiten anular la configuración original del prototipo de host: Sí: el host se creará en estado habilitado. No: el host se creará en estado deshabilitado.
		Descubrir	Al marcar la casilla, aparecerán botones que permiten anular la configuración original del prototipo de host: Sí: el host se descubrirá. No: el host no se descubrirá.
		Vincular templates	Al marcar la casilla, aparecerá un campo de entrada para especificar templates. Comience a escribir el nombre del template o haga clic en Seleccionar junto al campo y seleccione templates de la lista en una ventana emergente. Los templates de esta anulación se añaden a todos los templates ya vinculados al prototipo de host.
		Etiquetas	Al marcar la casilla, aparecerá un nuevo bloque que permite especificar pares etiqueta-valor. Se admiten macros de usuario y macros de LLD. Estas etiquetas se añadirán a las etiquetas especificadas en el prototipo de host, incluso si los nombres de las etiquetas coinciden.
		Inventario del host	Al marcar la casilla, aparecerán botones que permiten seleccionar un modo de inventario diferente para el prototipo de host: Deshabilitado: no completar el inventario del host Manual: proporcionar los detalles manualmente Automatizado: completar automáticamente los datos del inventario del host según las métricas recopiladas.
	Objeto: Prototipo de descubrimiento
		Crear habilitado	Al marcar la casilla, aparecerán botones que permiten anular la configuración original del prototipo de descubrimiento: Sí: la regla de descubrimiento se añadirá en estado habilitado. No: la regla de descubrimiento se añadirá en estado deshabilitado.
		Descubrir	Al marcar la casilla, aparecerán botones que permiten anular la configuración original del prototipo de descubrimiento: Sí: la regla de descubrimiento se añadirá. No: la regla de descubrimiento no se añadirá.
		Intervalo de actualización	Al marcar la casilla, aparecerán dos opciones que permiten establecer un intervalo diferente para la regla de descubrimiento: Retraso: intervalo de actualización de la regla. Se admiten macros de usuario, macros de LLD y sufijos de tiempo (por ejemplo, 30s, 1m, 2h, 1d). Debe establecerse en 0 si se utiliza Intervalo personalizado. Intervalo personalizado: haga clic en para especificar intervalos flexibles o programados. Para obtener información detallada, consulte Intervalos personalizados.

Botones del formulario

Los botones situados en la parte inferior del formulario permiten realizar varias operaciones.

	Añadir una regla de descubrimiento. Este botón solo está disponible para las reglas de descubrimiento nuevas.
	Actualizar las propiedades de una regla de descubrimiento. Este botón solo está disponible para las reglas de descubrimiento existentes.
	Crear otra regla de descubrimiento basada en las propiedades de la regla de descubrimiento actual.
	Realizar inmediatamente el descubrimiento según la regla de descubrimiento. La regla de descubrimiento debe existir previamente. Consulte más detalles. Nota: al realizar el descubrimiento inmediatamente, la caché de configuración no se actualiza, por lo que el resultado no reflejará los cambios más recientes en la configuración de la regla de descubrimiento.
	Probar la configuración de la regla de descubrimiento. Utilice este botón para verificar los ajustes de configuración (como la conectividad y la corrección de los parámetros) sin aplicar permanentemente ningún cambio.
	Eliminar la regla de descubrimiento.
	Cancelar la edición de las propiedades de la regla de descubrimiento.

Entidades descubiertas

Las siguientes capturas de pantalla ilustran cómo se ven los items, triggers y gráficos descubiertos en la configuración del host. Las entidades descubiertas están precedidas por un enlace naranja a la regla de descubrimiento de la que provienen.

Tenga en cuenta que las entidades descubiertas no se crearán en caso de que ya existan entidades con los mismos criterios de unicidad, por ejemplo, un item con la misma clave o un gráfico con el mismo nombre. En este caso, se muestra un mensaje de error en el frontend indicando que la regla de descubrimiento de bajo nivel no pudo crear ciertas entidades. Sin embargo, la propia regla de descubrimiento no se volverá no soportada porque alguna entidad no pudo ser creada y tuvo que ser omitida. La regla de descubrimiento continuará creando/actualizando otras entidades.

Si una entidad descubierta (host, sistema de archivos, interfaz, etc.) deja de ser descubierta (o ya no pasa el filtro), las entidades que se crearon en base a ella pueden ser deshabilitadas automáticamente y eventualmente eliminadas.

Los recursos perdidos pueden ser deshabilitados automáticamente según el valor del parámetro Deshabilitar recursos perdidos. Esto afecta a los hosts, items y triggers perdidos.

Los recursos perdidos pueden ser eliminados automáticamente según el valor del parámetro Eliminar recursos perdidos. Esto afecta a los hosts, grupos de hosts, items, triggers y gráficos perdidos.

Cuando las entidades descubiertas pasan a estar 'Ya no descubiertas', se muestra un indicador de tiempo de vida en la lista de entidades. Mueva el puntero del ratón sobre él y se mostrará un mensaje que indica los detalles de su estado.

Si las entidades fueron marcadas para su eliminación, pero no se eliminaron en el momento esperado (regla de descubrimiento o host del item deshabilitado), se eliminarán la próxima vez que se procese la regla de descubrimiento.

Las entidades que contienen otras entidades, que están marcadas para su eliminación, no se actualizarán si se cambian a nivel de la regla de descubrimiento. Por ejemplo, los triggers basados en LLD no se actualizarán si contienen items que están marcados para su eliminación.

Otros tipos de descubrimiento

Más detalles y procedimientos sobre otros tipos de descubrimiento listos para usar están disponibles en las siguientes secciones:

• descubrimiento de interfaces de red
• descubrimiento de CPUs y núcleos de CPU
• descubrimiento de OIDs SNMP
• descubrimiento de objetos JMX;
• descubrimiento usando consultas SQL ODBC
• descubrimiento de servicios de Windows
• descubrimiento de interfaces de host en Zabbix

Para más detalles sobre el formato JSON para items de descubrimiento y un ejemplo de cómo implementar su propio descubridor de sistemas de archivos como un script Perl, consulte creación de reglas LLD personalizadas.