3 Descubrimiento de bajo nivel

Descripción general

El descubrimiento de bajo nivel proporciona una manera de crear elementos automáticamente, disparadores y gráficos para diferentes entidades en una computadora. Por ejemplo, Zabbix puede comenzar a monitorear automáticamente los sistemas de archivos o la red interfaces en su máquina, sin la necesidad de crear elementos para cada sistema de archivos o interfaz de red manualmente. Además, es posible para configurar Zabbix para eliminar entidades innecesarias automáticamente según resultados reales del descubrimiento realizado 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 "Configuración" → "Plantillas". → Columna "Descubrimiento". Una regla de descubrimiento consta de (1) un elemento que descubre las entidades necesarias (por ejemplo, sistemas de archivos o redes interfaces) y (2) prototipos de elementos, activadores y gráficos que debe crearse en función del valor de ese artículo.

Un elemento que descubre las entidades necesarias es como un elemento normal. visto en otros lugares: el servidor le pregunta a un agente de Zabbix (o cualquiera que sea el tipo de el elemento está configurado) para un valor de ese elemento, 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 la Los detalles de este formato sólo son importantes para los implementadores de personalizados. comprobaciones de descubrimiento, es necesario saber que el valor devuelto contiene una lista de pares macro → valor. Por ejemplo, artículo "net.if.discovery" puede devolver dos pares: "{#IFNAME}" → "lo" y "{#IFNAME}" → "eth0".

Estas macros se utilizan en nombres, claves y otros campos prototipo donde luego se sustituyen con los valores recibidos para crear real elementos, desencadenantes, gráficos o incluso hosts para cada entidad descubierta. Ver la lista completa de opciones para usar Macros LLD.

Cuando el servidor recibe un valor para un elemento de descubrimiento, mira el macro → pares de valores y para cada par genera elementos reales, desencadenantes, y gráficos, basados en sus prototipos. En el ejemplo con "net.if.discovery" arriba, el servidor generaría un conjunto de elementos, activadores 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 Se han cambiado las reglas de descubrimiento de bajo nivel. Ya no se espera que el JSON contendrá el objeto "datos". El descubrimiento de bajo nivel ahora acepte un JSON normal que contenga una matriz, para admitir nuevos características como el preprocesamiento del valor del artículo 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. Algo nuevo Las comprobaciones de descubrimiento nativas utilizarán la nueva sintaxis sin los "datos". elementos. Cuando se procesa primero un valor de descubrimiento de bajo nivel, la raíz es ubicado (matriz en $. o $.data).

Si bien el elemento "datos" se ha eliminado de todos los elementos nativos relacionados hasta el descubrimiento, para compatibilidad con versiones anteriores, Zabbix seguirá aceptando el Notación JSON con un elemento "datos", aunque se desaconseja su uso. Si el JSON contiene un objeto con un solo elemento de matriz de "datos", entonces extraerá automáticamente el contenido del elemento usando JSONPath $.datos. El descubrimiento de bajo nivel ahora acepta LLD opcional definido por el usuario macros con una ruta personalizada especificada en la sintaxis JSONPath.

::: nota de advertencia Como resultado de los cambios anteriores, los agentes más nuevos no Ya no podrá trabajar con un servidor Zabbix más antiguo. :::

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: Configuración → 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, el elemento integrado o script personalizado para recuperar datos de descubrimiento
• Preprocesamiento: aplica cierto preprocesamiento a los datos descubiertos.
• Macros LLD - permite extraer algunos valores de macro para usar en elementos descubiertos, desencadenantes, etc.
• Filtros - permite filtrar los valores descubiertos
• Anulaciones - permite modificar elementos, activadores, gráficos o host prototipos cuando se aplican a objetos descubiertos específicos

La pestaña Regla de descubrimiento contiene la clave del elemento 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.

::: nota clásica El historial de reglas de descubrimiento no se conserva. :::

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 definidos. Todo el preprocesamiento lo realiza el servidor Zabbix.

Ver también:

• Preprocesamiento detalles
• Pruebas de preprocesamiento

|Tipo|<|<| |-|----------|------------------------------------ ----| | |Transformación|Descripción| |Texto|<|<| |<|Expresión regular|Haga coincidir el valor recibido con la expresión regular <patrón> y reemplace el valor con la <salida> extraída. La expresión regular admite la extracción de un máximo de 10 grupos capturados con la secuencia \N.
Parámetros:
patrón - expresión regular
salida - plantilla de formato de salida. Una secuencia de escape \N (donde N=1…9) se reemplaza con el enésimo grupo coincidente. Una secuencia de escape \0 se reemplaza con el texto coincidente.
Si marca la casilla de verificación Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor específico o establecer un mensaje de error especificado.| |^|Reemplazar|Busque la cadena de búsqueda y reemplácela con otra (o nada). Se reemplazarán todas las apariciones de la cadena de búsqueda.
Parámetros:
cadena de búsqueda: la cadena para buscar y reemplazar, distingue entre mayúsculas y minúsculas (obligatorio)
reemplazo: la cadena para reemplace la cadena de búsqueda con. La cadena de reemplazo también puede estar vacía, lo que permite eliminar la cadena de búsqueda cuando se encuentre.
Es posible utilizar secuencias de escape para buscar o reemplazar saltos de línea, retornos de carro, tabulaciones y espacios "\n \r \ t\s"; La barra invertida se puede escapar como "\\" y las secuencias de escape se pueden escapar como "\\n". El escape de saltos de línea, retorno de carro y tabulaciones se realiza automáticamente durante el descubrimiento de bajo nivel.
Compatible desde 5.0.0.| |Datos estructurados|<|<| |<|JSONPath|Extraiga valor o fragmento de datos JSON utilizando funcionalidad JSONPath.
Si marca la casilla de verificación Personalizado en caso de error, es posible especificar opciones de manejo de errores: descartar el valor, establecer un valor específico o establecer un mensaje de error específico.| |<|XML XPath|Extraiga valor o fragmento de datos XML usando la funcionalidad XPath.
Para que esta opción funcione, el servidor Zabbix debe estar compilado con soporte libxml.
Ejemplos:
number(/document /item/value) extraerá 10 de <document><item><value>10</value></item></document>
number(/document/item/@attribute) extraerá 10 de <document><item atributo="10"></item></document>
/document/item extraerá <item><valor>10</valor ></item> de <document><item><value>10</value></item></document>
Tenga en cuenta que los espacios de nombres no son compatibles.
Soportados desde 4.4.0.
Si marca la casilla de verificación Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor específico o establecer un mensaje de error específico.| |<|CSV a JSON|Convierta los datos del archivo CSV al formato JSON.
Para obtener más información, consulte: Preprocesamiento de CSV a JSON.
Compatible desde 4.4.0.| |^|XML a JSON|Convierta datos en formato XML a JSON.
Para obtener más información, consulte: Reglas de serialización.
Si marca la casilla de verificación Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor específico o establecer un mensaje de error específico.| |Scripts personalizados|<|<| |<|JavaScript|Ingrese el código JavaScript en el bloque que aparece al hacer clic en el campo de parámetro o en el ícono de lápiz.
Tenga en cuenta que la longitud de JavaScript disponible depende de la base de datos utilizada.
Para obtener más información, consulte: Preprocesamiento de Javascript| |Validación|<|<| |<|No coincide con la expresión regular|Especifique una expresión regular con la que un valor no debe coincidir.
Por ej. Error:(.*?)\.
Si marca la casilla de verificación Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor específico o establecer un valor específico. mensaje de error.| |^|Compruebe si hay errores en JSON|Compruebe si hay un mensaje de error a nivel de aplicación ubicado en JSONPath. Detenga el procesamiento si tuvo éxito y el mensaje no está vacío; de lo contrario, continúe procesando con el valor que estaba antes de este paso de preprocesamiento. Tenga en cuenta que estos errores de servicios externos se informan al usuario tal cual, sin agregar información del paso de preprocesamiento.
P. $.errores. Si se recibe un JSON como {"errors":"e1"}, no se ejecutará el siguiente paso de preprocesamiento.
Si marca la casilla de verificación Personalizado en caso de error, es posible especificar un manejo de errores personalizado opciones: descartar el valor, establecer un valor específico o establecer un mensaje de error específico.| |^|Compruebe si hay errores en XML|Compruebe si hay un mensaje de error a nivel de aplicación ubicado en xpath. Detenga el procesamiento si tuvo éxito y el mensaje no está vacío; de lo contrario, continúe procesando con el valor que estaba antes de este paso de preprocesamiento. Tenga en cuenta que estos errores de servicios externos se informan al usuario tal como están, sin agregar información sobre los pasos de preprocesamiento.
No se informará ningún error en caso de no poder analizar XML no válido.
Compatible desde 4.4.0.
Si marque la casilla de verificación Personalizado en caso de error, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor específico o establecer un mensaje de error específico.| |Aceleración|<|<| |<|Descartar sin cambios con latido|Descartar un valor si no ha cambiado dentro del período de tiempo definido (en segundos).
Se admiten valores enteros positivos para especificar los segundos (mínimo - 1 segundo). En este campo se pueden utilizar sufijos de tiempo (por ejemplo, 30 s, 1 m, 2 h, 1 d). En este campo se pueden utilizar macros de usuario y macros de descubrimiento de bajo nivel.
Solo se puede especificar una opción de limitación para un elemento de descubrimiento.
P. 1 millón. Si se pasa texto idéntico a esta regla dos veces en 60 segundos, se descartará.
Nota: Cambiar los prototipos de elementos no restablece la limitación. La limitación se restablece sólo cuando se cambian los pasos de preprocesamiento.| |Prometeo|<|<| |<|Prometheus a JSON|Convierta las métricas de Prometheus requeridas a JSON.
Consulte Comprobaciones de Prometheus para obtener más detalles.|

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

Macros personalizadas

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

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 en prototipos de items y activadores. (ver secciones siguientes de la página) directamente; definiendo costumbre no se necesitan macros;
• El item del agente vfs.fs.get también devuelve un JSON con sistema de archivos datos, pero sin macros LLD predefinidas. En este caso usted puede definir las macros usted mismo y asignarlas a los valores en el JSON usando Ruta JSON:

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

Filtro

Se puede utilizar un filtro para generar elementos, activadores y gráficos reales únicamente. para entidades que cumplan los criterios. La pestaña Filtros contiene Definiciones de filtros de reglas de descubrimiento que permiten filtrar valores de descubrimiento:

::: nota de advertencia Un error o una errata en la expresión regular utilizada en la regla LLD (por ejemplo, un "Sistemas de archivos para descubrimiento" incorrecto expresión regular) puede causar la eliminación de miles de configuraciones elementos, valores históricos y eventos para muchos anfitriones. :::

::: nota importante La base de datos Zabbix en MySQL debe crearse como distingue entre mayúsculas y minúsculas si se van a utilizar nombres de sistemas de archivos que difieren sólo en mayúsculas y minúsculas. descubierto correctamente. :::

Override

The Override tab allows setting rules to modify the list of item, trigger, graph and host prototypes or their attributes for discovered objects that meet given criteria.

Overrides (if any) are displayed in a reorderable drag-and-drop list and executed in the order in which they are defined.  To configure details of a new override, click on in the Overrides block. To edit an existing override, click on the override name. A popup window will open allowing to edit the override rule details.

All mandatory parameters are marked with red asterisks.

Configuring an operation

To configure details of a new operation, click on in the Operations block. To edit an existing operation, click on next to the operation. A popup window where you can edit the operation details will open.

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 los elementos descubiertos, los desencadenantes y Los gráficos se ven en la configuración del host. Las entidades descubiertas son con el prefijo de 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 Por ejemplo, un elemento con la misma clave o gráfico con el mismo nombre. Un error En este caso se muestra un mensaje en la interfaz de que el nivel bajo La regla de descubrimiento no pudo crear ciertas entidades. La regla del descubrimiento sin embargo, no quedará sin apoyo porque alguna entidad no pueda ser creado y tuvo que ser omitido. La regla de descubrimiento continuará crear/actualizar otras entidades.

Elementos (de manera similar, desencadenantes y gráficos) creados por un descubrimiento de bajo nivel La regla se eliminará automáticamente si se descubre una entidad (sistema de archivos, interfaz, etc) deja de ser descubierto (o no pasa el filtro ya no). En este caso se eliminarán los elementos, disparadores 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 'No descubiertas más', toda una vida El indicador se muestra en la lista de elementos. Mueva el puntero del mouse sobre él. y se mostrará un mensaje indicando cuantos días faltan para el elemento se elimina.

Si las entidades se marcaron para su eliminación, pero no se eliminaron en el tiempo esperado (regla de descubrimiento deshabilitada o host de elementos), serán se eliminará 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 actualiza si se modifica en el nivel de la regla de descubrimiento. Por ejemplo, Los activadores basados en LLD no se actualizarán si contienen elementos marcados 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 de CPU;
• descubrimiento de SNMP OID;
• descubrimiento de objetos JMX;
• descubrimiento usando consultas SQL de ODBC;
• descubrimiento de servicios Windows;
• descubrimiento de interfaces de equipos en Zabbix.

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