3 Descubrimiento de bajo nivel

Descripción general

El descubrimiento de bajo nivel proporciona una manera de crear automáticamente métricas, iniciadores y gráficos para diferentes entidades en una computadora. Por ejemplo, Zabbix puede comenzar a monitorear automáticamente los sistemas de archivos o las interfaces de red en su máquina, sin la necesidad de crear métricas para cada sistema de archivos o interfaz de red manualmente. Además, es posible configurar Zabbix para eliminar entidades innecesarias automáticamente según los resultados reales de los descubrimientos realizados periódicamente.

Un usuario puede definir sus propios tipos de descubrimiento, siempre que siga un protocolo JSON particular.

La arquitectura general del proceso de descubrimiento es la siguiente.

Primero, un usuario crea una regla de descubrimiento en Recopilación de datos → Plantillas, en la columna Descubrimiento. Una regla de descubrimiento consta de (1) una métrica que descubre las entidades necesarias (por ejemplo, sistemas de archivos o interfaces de red) y (2) prototipos de métricas, iniciadores y gráficos que deben crearse en función del valor de esa métrica.

Una métrica que descubre las entidades necesarias es como una métrica normal usada en otros lugares: el servidor le pregunta a un agente de Zabbix (o cualquier otro tipo de métrica que esté configurado) por un valor de esa métrica, el agente responde con un valor textual. La diferencia es que el valor con el que responde el agente debe contener una lista de entidades descubiertas en formato JSON. Mientras que los detalles de este formato sólo son importantes para los implementadores de comprobaciones de descubrimiento personalizadas, es necesario saber que el valor devuelto contiene una lista de parejas macro → valor. Por ejemplo, la métrica "net.if.discovery" puede devolver dos pares: "{#IFNAME}" → "lo" y "{#IFNAME}" → "eth0".

Estas macros se utilizan en nombres, claves y otros campos del prototipo donde luego se sustituyen con los valores recibidos para crear métricas reales, iniciadores, gráficos o incluso equipos para cada entidad descubierta. Ver la lista completa de opciones para usar Macros LLD.

Cuando el servidor recibe un valor para una métrica de descubrimiento, mira a las parejas macro → valor y para cada par genera métricas reales, iniciadores, y gráficos, basados en sus prototipos. En el ejemplo de arriba con "net.if.discovery" , el servidor generaría un conjunto de métricas, iniciadores y gráficos para la interfaz loopback "lo", y otro conjunto para la interfaz "eth0".

Tenga en cuenta que desde Zabbix 4.2, el formato del JSON devuelto por las reglas de descubrimiento de bajo nivel ha sido modificado. Ya no se espera que el JSON contenga el objeto "datos". El descubrimiento de bajo nivel ahora acepta un JSON normal que contenga una matriz, para admitir nuevas características como el preprocesamiento del valor de la métrica y rutas personalizadas a valores de macro de descubrimiento de bajo nivel en un documento JSON.

Las claves de descubrimiento integradas se han actualizado para devolver una serie de filas LLD en la raíz del documento JSON. Zabbix extraerá automáticamente una macro y valor si un campo de matriz usa la sintaxis {#MACRO} como clave. Cualquier nueva comprobación de descubrimiento nativa utilizarán la nueva sintaxis sin los elementos "data". Cuando se procesa primero un valor de descubrimiento de bajo nivel, la raíz es ubicada (matriz en $. o $.data).

Si bien el elemento "data" se ha eliminado de todos las métricas nativas relacionadas al descubrimiento, por compatibilidad con versiones anteriores, Zabbix seguirá aceptando la notación JSON con un elemento "data", aunque se desaconseja su uso. Si el JSON contiene un objeto con un solo elemento de matriz de "data", entonces extraerá automáticamente el contenido del elemento usando JSONPath $.data. El descubrimiento de bajo nivel ahora acepta macros LLD definidas por el usuario opcionales con una ruta personalizada especificada en la sintaxis JSONPath.

Ver también: Entidades descubiertas

Configuración del descubrimiento de bajo nivel

Ilustraremos el descubrimiento de bajo nivel basándonos en un ejemplo de descubrimiento de sistemas de archivos.

Para configurar el descubrimiento, haga lo siguiente:

• Vaya a: Recopilación de datos → Plantillas o Equipos
• Haga clic en Descubrimiento en la fila de una plantilla/equipo apropiado

• Haga clic en Crear regla de descubrimiento en la esquina superior derecha de la pantalla
• Complete el formulario de la regla de descubrimiento con los detalles requeridos.

Regla de descubrimiento

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

• Regla de descubrimiento - especifica, lo más importante, la métrica integrada o script personalizado para recuperar los datos de descubrimiento
• Preprocesamiento: aplica cierto preprocesamiento a los datos descubiertos.
• Macros LLD - permite extraer algunos valores de macro para usar en las métricas descubiertas, iniciadores, etc.
• Filtros - permite filtrar los valores descubiertos
• Anulaciones - permite modificar los prototipos de métricas, iniciadores, gráficos o equipos cuando se aplican a objetos descubiertos específicos

La pestaña Regla de descubrimiento contiene la clave de la métrica que se utilizará para el descubrimiento. (así como algunos atributos generales de las reglas de descubrimiento):

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

Preprocesamiento

La pestaña Preprocesamiento permite definir las reglas de transformación que se aplicarán al resultado del descubrimiento. Son posibles una o varias transformaciones en este paso. Las transformaciones se ejecutan en el orden en que están definidas. Todo el preprocesamiento lo realiza el servidor Zabbix.

Ver también:

• Detalles del preprocesamiento
• Pruebas de preprocesamiento

Tenga en cuenta que si la regla de descubrimiento se ha aplicado al equipo a través de plantilla, el contenido de esta pestaña es de solo lectura.

Macros personalizadas

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

Las macros personalizadas son útiles en los casos en que el JSON devuelto no tiene las macros requeridas ya definidas. Así por ejemplo:

• La clave nativa vfs.fs.discovery para el descubrimiento del sistema de archivos devuelve un JSON con algunas macros LLD predefinidas como {#FSNAME}, {#FSTYPE}. Estas macros se pueden utilizar directamente en prototipos de métricas e iniciadores (ver secciones siguientes de la página) ; no se requiere definir macros personalizadas;
• La métrica del agente vfs.fs.get también devuelve un JSON con los datis dek sistema de archivos, pero sin macros LLD predefinidas. En este caso usted puede definir las macros usted mismo y asignarlas a los valores en el JSON usando JSONPath:

Los valores extraídos se pueden utilizar en métricas descubiertas, iniciadores, etc. Tenga en cuenta que los valores se extraerán del resultado del descubrimiento y de cualquiera de los pasos de preprocesamiento hasta el momento.

Filtro

Se puede utilizar un filtro para generar métricas, iniciadores y gráficos reales solamente para las entidades que cumplan los criterios. La pestaña Filtros contiene las definiciones de filtros de las reglas de descubrimiento que permiten filtrar valores de descubrimiento:

Anular

La pestaña Anular permite establecer reglas para modificar la lista de métricas, iniciadores, gráficos y prototipos de equipos o sus atributos para objetos descubiertos que cumplen los criterios dados.

Las anulaciones (si las hay) se muestran en una lista reordenable de arrastrar y soltar y son ejecutados en el orden en que están definidos. Para configurar los detalles de una nueva anulación, haga clic en bloquear Anulaciones. Para editar una anulación existente, haga clic en el nombre de la anulación. Se abrirá una ventana emergente que permitirá editar los detalles de la regla de anulación.

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

Configurando una operación

Para configurar los detalles de una nueva operación, haga clic en bloquear Operaciones. Para editar una operación existente, haga clic en junto a la operación. Aparecerá una ventana emergente donde puede editar los detalles de la operación.

Botones de formulario

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

Entidades descubiertas

Las capturas de pantalla siguientes ilustran cómo las métricas, los iniciadores y los gráficos descubiertos se ven en la configuración del equipo. Las entidades descubiertas están prefijadas con un enlace naranja a una regla de descubrimiento de la que provienen.

Tenga en cuenta que las entidades descubiertas no se crearán en caso de que haya entidades ya existentes con los mismos criterios de unicidad, por ejemplo, una métrica con la misma clave o gráfico con el mismo nombre. En este caso se muestra un mensaje de error en la interfaz de que la regla de descubrimiento de bajo nivel no pudo crear ciertas entidades. La regla del descubrimiento, sin embargo, no quedará sin soporte porque alguna entidad no pueda ser creada y haya tenido que ser omitida. La regla de descubrimiento continuará creando/actualizando otras entidades.

Las métricas (de manera similar, iniciadores y gráficos) creadas por una regla de descubrimiento de bajo nivel se eliminarán automáticamente si una entidad descubierta (sistema de archivos, interfaz, etc) deja de estar descubierto (o ya no pasa el filtro). En este caso se eliminarán las métricas, iniciadores y gráficos después de que pasen los días definidos en el campo Período de conservación de recursos perdidos.

Cuando las entidades descubiertas pasan a ser 'Ya no descubiertas', se muestra un indicador de "tiempo de vida" en la lista de elementos. Mueva el puntero del mouse sobre él. y se mostrará un mensaje indicando cuantos días faltan para que la métrica se elimine.

Si las entidades se marcaron para su eliminación, pero no se eliminaron en el tiempo esperado (regla de descubrimiento deshabilitada o métrica de equipo), serán eliminadas la próxima vez que se procese la regla de descubrimiento.

Las entidades que contengan otras entidades, que estén marcadas para su eliminación, no se actualizarán si se modifican en el nivel de la regla de descubrimiento. Por ejemplo, los iniciadores basados en LLD no se actualizarán si contienen métricas marcadas para su eliminación.

Otros tipos de descubrimiento

Más detalles e instrucciones sobre otros tipos de descubrimientos listos para usar están disponibles en las siguientes secciones:

• descubrimiento de interfaces de red;
• descubrimiento de CPU y núcleos CPU;
• descubrimiento de SNMP OID;
• descubrimiento de objetos JMX;
• descubrimiento usando consultas ODBC SQL;
• descubrimiento de servicios Windows;
• descubrimiento de interfaces del equipo en Zabbix.

Para obtener más detalles sobre el formato JSON para elementos de descubrimiento y un ejemplo de cómo implementar su propio descubridor de sistema de archivos con un script Perl, consulte creando reglas LLD personalizadas.