Documentation
Table of Contents
3 Descubrimiento de bajo nivel
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô 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, Áú»¢¶Ä²© 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 Áú»¢¶Ä²© 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 Áú»¢¶Ä²© (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 Áú»¢¶Ä²© 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. Áú»¢¶Ä²© ±ð³æ³Ù°ù²¹±ð°ù¨¢ 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, Áú»¢¶Ä²© 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 ±ð³æ³Ù°ù²¹±ð°ù¨¢ 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.
Como resultado de los cambios anteriores, los agentes m¨¢s nuevos ya no podr¨¢n trabajar con un servidor Áú»¢¶Ä²© m¨¢s antiguo.
Ver tambi¨¦n: Entidades descubiertas
°ä´Ç²Ô´Ú¾±²µ³Ü°ù²¹³¦¾±¨®²Ô 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 incorporada 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 m¨¦tricas descubiertas, iniciadores, etc.
- Filtros - permite filtrar los valores descubiertos
- Reemplazo: permite modificar m¨¦tricas, iniciadores, gr¨¢ficos o prototipos de 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 de reglas de descubrimiento generales):
Todos los campos de entrada obligatorios est¨¢n marcados con un asterisco rojo.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|
| Nombre | Nombre de la regla de descubrimiento. |
| Tipo | El tipo de verificaci¨®n para realizar el descubrimiento. En este ejemplo estamos usando un tipo de m¨¦trica Agente Áú»¢¶Ä²©. La regla de descubrimiento tambi¨¦n puede ser una m¨¦trica dependiente, dependiendo de una m¨¦trica normal. No puede depender de otra regla de descubrimiento. Para una m¨¦trica dependiente, seleccione el tipo respectivo (²Ñ¨¦³Ù°ù¾±³¦²¹ dependiente) y especifique la m¨¦trica maestra en el campo '²Ñ¨¦³Ù°ù¾±³¦²¹ maestra'. La m¨¦trica maestra debe existir. |
| Clave | Ingrese la clave de la m¨¦trica de descubrimiento (hasta 2048 caracteres). Por ejemplo, puede usar la clave de la m¨¦trica incorporada "vfs.fs.discovery" para devolver un JSON con la lista de sistemas de archivos presentes en la computadora, sus tipos y opciones de montaje. Tenga en cuenta que otra opci¨®n para el descubrimiento del sistema de archivos es utilizar los resultados del descubrimiento mediante la clave del agente "vfs.fs.get" (consulte ejemplo). |
| Intervalo de actualizaci¨®n | Este campo especifica con qu¨¦ frecuencia Áú»¢¶Ä²© realiza el descubrimiento. Al principio, cuando est¨¦ configurando el descubrimiento del sistema de archivos, es posible que desee configurarlo en un intervalo peque?o, pero una vez que sepa que funciona, puede configurarlo en 30 minutos o m¨¢s, porque los sistemas de archivos generalmente no cambian con mucha frecuencia. . Se admiten sufijos de tiempo, p. 30s, 1m, 2h, 1d. Las macros de usuario est¨¢n soportadas. Nota: El intervalo de actualizaci¨®n solo se puede establecer en '0' si existen intervalos personalizados con un valor distinto de cero. Si se establece en '0' y existe un intervalo personalizado (flexible o programado) con un valor distinto de cero, la m¨¦trica se sondear¨¢ durante la duraci¨®n del intervalo personalizado. Las nuevas reglas de descubrimiento se verificar¨¢n dentro de los 60 segundos de su creaci¨®n. , a menos que tengan un intervalo de actualizaci¨®n programado o flexible y el Intervalo de actualizaci¨®n est¨¦ establecido en 0. Tenga en cuenta que para una regla de descubrimiento existente, el descubrimiento se puede realizar inmediatamente presionando el ²ú´Ç³Ù¨®²Ô Ejecutar ahora. |
| Intervalos personalizados | Puedes crear reglas personalizadas para comprobar la m¨¦trica: Flexible: crea una excepci¨®n al Intervalo de actualizaci¨®n (intervalo con diferente frecuencia) ±Ê°ù´Ç²µ°ù²¹³¾²¹³¦¾±¨®²Ô: crea un cronograma de sondeo personalizado. Para obtener informaci¨®n detallada, consulte Intervalos personalizados. |
| Tiempo de espera | Establezca el tiempo de espera de verificaci¨®n de descubrimiento. Seleccione la opci¨®n de tiempo de espera: Global: se usa el tiempo de espera global/proxy (se muestra en el campo Tiempo de espera atenuado); Anular: se usa el tiempo de espera personalizado (establecido en el * Campo de tiempo de espera; rango permitido: 1 - 600 s). Sufijos de tiempo, p.e. Se admiten 30 s, 1 m y macros de usuario. Hacer clic en el enlace Tiempos de espera* le permite configurar tiempos de espera de proxy o global tiempos de espera (si no se utiliza un proxy). Tenga en cuenta que el enlace Tiempos de espera es visible solo para usuarios de tipo Super administrador con permisos para ´¡»å³¾¾±²Ô¾±²õ³Ù°ù²¹³¦¾±¨®²Ô ¡ú General o ´¡»å³¾¾±²Ô¾±²õ³Ù°ù²¹³¦¾±¨®²Ô ¡ú Proxies secciones de interfaz. |
| Eliminar recursos perdidos | Especifique qu¨¦ tan pronto se eliminar¨¢ la entidad descubierta una vez que su estado de descubrimiento sea "Ya no descubierto": Nunca: no se eliminar¨¢; Inmediatamente: se eliminar¨¢ eliminado inmediatamente; ¶Ù±ð²õ±è³Ü¨¦²õ: se eliminar¨¢ despu¨¦s del per¨ªodo de tiempo especificado. El valor debe ser mayor que el valor de Desactivar recursos perdidos. Se admiten sufijos de tiempo, p. 2h, 1d. Macros de usuario son compatibles. Nota: No se recomienda usar "Inmediatamente", ya que simplemente editar incorrectamente el filtro puede terminar en el entidad que se elimina con todos los datos hist¨®ricos. Tenga en cuenta que los recursos desactivados manualmente no se eliminar¨¢n mediante el descubrimiento de bajo nivel. |
| Deshabilitar recursos perdidos | Especifique qu¨¦ tan pronto se deshabilitar¨¢ la entidad descubierta una vez que su estado de descubrimiento sea "Ya no descubierto": Nunca: no se deshabilitar¨¢; Inmediatamente: se deshabilitado inmediatamente; ¶Ù±ð²õ±è³Ü¨¦²õ: se deshabilitar¨¢ despu¨¦s del per¨ªodo de tiempo especificado. El valor debe ser mayor que el intervalo de actualizaci¨®n de la regla de descubrimiento. Tenga en cuenta que los recursos deshabilitados autom¨¢ticamente se habilitar¨¢n nuevamente si se vuelven a descubrir mediante un descubrimiento de bajo nivel. Los recursos deshabilitados manualmente no se habilitar¨¢n nuevamente si se vuelven a descubrir. Este campo no se muestra si Eliminar recursos perdidos est¨¢ configurado en "Inmediatamente". Sufijos de tiempo son soportado, p.e. 2h, 1d. Se admiten macros de usuario. |
| ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô | Ingrese una descripci¨®n. |
| Habilitado | Si est¨¢ marcado, la regla ser¨¢ procesada. |
El historial de reglas de descubrimiento no se conserva.
Preprocesamiento
La pesta?a Preprocesamiento permite definir reglas de transformaci¨®n para aplicar al resultado del descubrimiento. En este paso son posibles una o varias transformaciones. Las transformaciones se ejecutan en el orden en el que se definen. Todo el preprocesamiento lo realiza el servidor Áú»¢¶Ä²©.
Ver tambi¨¦n:
| Tipo | ||
|---|---|---|
| °Õ°ù²¹²Ô²õ´Ú´Ç°ù³¾²¹³¦¾±¨®²Ô | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô | |
| Texto | ||
| Expresi¨®n regular | Hacer coincidir el valor recibido con la expresi¨®n regular <±è²¹³Ù°ù¨®²Ô> y reemplazar el valor con el <salida> extra¨ªdo. La expresi¨®n regular admite la extracci¨®n de un m¨¢ximo de 10 grupos capturados con la secuencia \N. ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Çs: ±è²¹³Ù°ù¨®²Ô - expresi¨®n regular salida - plantilla de formato de salida. Una secuencia de escape \N (donde N=1¡9) se reemplaza con el grupo N coincidente. Una secuencia de escape \0 se reemplaza con el texto coincidente. Si marca la casilla de verificaci¨®n Personalizar en caso de error, es posible especificar opciones de manejo de errores personalizadas: ya sea para descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. |
|
| Reemplazar | Buscar la cadena de b¨²squeda y reemplazarla con otra (o nada). Se reemplazar¨¢n todas las apariciones de la cadena de b¨²squeda. ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Çs: cadena de b¨²squeda: la cadena que se buscar¨¢ y reemplazar¨¢, distingue entre may¨²sculas y min¨²sculas (obligatorio) reemplazo: la cadena con la que se reemplazar¨¢ la cadena de b¨²squeda. 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, retornos de carro y tabulaciones se realiza autom¨¢ticamente durante el descubrimiento de bajo nivel. |
|
| Datos estructurados | ||
| JSONPath | Extraer valor o fragmento de datos JSON usando funcionalidad JSONPath. Si marca la casilla de verificaci¨®n Personalizado en caso de error, es posible especificar opciones de manejo de errores personalizadas: descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. |
|
| XML XPath | Extraer valor o fragmento de datos XML usando la funcionalidad XPath. Para que esta opci¨®n funcione, el servidor Áú»¢¶Ä²© debe estar compilado con soporte para libxml. Ejemplos: number(/document/item/value) ±ð³æ³Ù°ù²¹±ð°ù¨¢ 10 de <document><item><value>10</value></item></document>number(/document/item/@attribute) ±ð³æ³Ù°ù²¹±ð°ù¨¢ 10 de <document><item attribute="10"></item></document>/document/item ±ð³æ³Ù°ù²¹±ð°ù¨¢ <item><value>10</value></item> de <document><item><value>10</value></item></document>Tenga en cuenta que los espacios de nombres no son compatibles. Si marca la casilla de verificaci¨®n Personalizar en caso de error, es posible especificar opciones de manejo de errores personalizadas: ya sea para descartar el valor o para establecer un valor especificado. o establecer un mensaje de error espec¨ªfico. |
|
| CSV a JSON | Convertir datos de archivo CSV a formato JSON. Para obtener m¨¢s informaci¨®n, consulte: Preprocesamiento de CSV a JSON. |
|
| XML a JSON | Convertir datos en formato XML a JSON. Para obtener m¨¢s informaci¨®n, consulte: Reglas de serializaci¨®n. Si marca la casilla de verificaci¨®n Personalizar en caso de error, es posible especificar opciones de manejo de errores personalizadas: ya sea para descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. |
|
| SNMP | ||
| Valor de SNMP walk | Extraer valor por el nombre OID/MIB especificado y aplicar opciones de formato: Sin cambios - devuelve Hex-STRING como una cadena hexadecimal sin escape; UTF-8 de Hex-STRING - convierte Hex-STRING en una cadena UTF-8; MAC de Hex-STRING - convierte Hex-STRING en una cadena de direcci¨®n MAC (que tendr¨¢ ' ' reemplazado por ':');Entero de BITS - convierte los primeros 8 bytes de una cadena de bits expresada como una secuencia de caracteres hexadecimales (p. ej., "1A 2B 3C 4D") en un entero sin signo de 64 bits. En cadenas de bits de m¨¢s de 8 bytes, se ignorar¨¢n los bytes consecuentes. Si marca la casilla de verificaci¨®n Personalizar en caso de error, es posible especificar opciones de manejo de errores personalizadas: ya sea para descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. |
|
| SNMP walk a JSON | Convierte valores SNMP a JSON. Especifique un nombre de campo en JSON y la ruta de OID de SNMP correspondiente. Los valores de campo se completar¨¢n con valores en la ruta de OID de SNMP especificada. Puede usar este paso de preprocesamiento para descubrimiento de OID de SNMP. Hay opciones de formato de valor similares a las del paso valor de SNMP walk. Si marca la casilla de verificaci¨®n Personalizar en caso de error, es posible especificar opciones de manejo de errores personalizadas: ya sea para descartar el valor ue, establezca un valor especificado o establezca un mensaje de error especificado. |
|
| Valor obtenido de SNMP | Aplicar opciones de formato al valor obtenido de SNMP: UTF-8 de Hex-STRING - convierte Hex-STRING en cadena UTF-8; MAC de Hex-STRING - convierte Hex-STRING en cadena de direcci¨®n MAC (que tendr¨¢ ' ' reemplazado por ':');Entero de BITS - convierte los primeros 8 bytes de una cadena de bits expresada como una secuencia de caracteres hexadecimales (p. ej. "1A 2B 3C 4D") en un entero sin signo de 64 bits. En cadenas de bits de m¨¢s de 8 bytes, se ignorar¨¢n los bytes consecuentes. Si marca la casilla de verificaci¨®n Personalizar en caso de error, es posible especificar opciones de manejo de errores personalizadas: ya sea para descartar el valor, establecer un valor especificado o establecer un mensaje de error especificado. |
|
| Scripts personalizados | ||
| JavaScript | Ingrese el c¨®digo JavaScript en el editor modal que se abre al hacer clic en el campo de par¨¢metros o en el ¨ªcono de l¨¢piz que se encuentra junto a ¨¦l. 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 |
|
| ³Õ²¹±ô¾±»å²¹³¦¾±¨®²Ô | ||
| No coincide con la expresi¨®n regular | Especifique una expresi¨®n regular con la que no debe coincidir un valor. Por ejemplo, Error:(.*?)\.Si marca la casilla de verificaci¨®n Personalizar en caso de error, es posible especificar opciones de manejo de errores personalizadas: ya sea para descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. |
|
| Verificar si hay un error en JSON | Verifique si hay un mensaje de error a nivel de aplicaci¨®n ubicado en JSONPath. Detener el procesamiento si se realiz¨® correctamente y el mensaje no est¨¢ vac¨ªo; de lo contrario, continuar con el procesamiento con el valor que hab¨ªa antes de este paso de preprocesamiento. Tenga en cuenta que estos errores de servicio externo se informan al usuario tal como est¨¢n, sin agregar informaci¨®n del paso de preprocesamiento. Por ejemplo, $.errors. Si se recibe un JSON como {"errors": "e1"}, no se ejecutar¨¢ el siguiente paso de preprocesamiento.Si marca la casilla de verificaci¨®n Personalizar en caso de error, es posible especificar opciones de manejo de errores personalizadas: ya sea para descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. |
|
| Verificar si hay un error en XML | Verificar si hay un mensaje de error a nivel de aplicaci¨®n ubicado en Xpath. Detener el procesamiento si se realiz¨® correctamente y el mensaje no est¨¢ vac¨ªo; de lo contrario, continuar con el procesamiento con el valor que hab¨ªa antes de este paso de preprocesamiento. Tenga en cuenta que estos errores de servicio externo se informan al usuario tal como est¨¢n, sin agregar informaci¨®n del paso de preprocesamiento. No se informar¨¢ ning¨²n error en caso de que no se pueda analizar XML no v¨¢lido. Si marca la casilla de verificaci¨®n Personalizado en caso de error, es posible especificar opciones de manejo de errores personalizadas: ya sea para descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. |
|
| Coincide con expresi¨®n regular | Especifique una expresi¨®n regular con la que debe coincidir un valor. Si marca la casilla de verificaci¨®n Personalizado en caso de error, es posible especificar opciones de manejo de errores personalizadas: ya sea para descartar el valor, establecer un valor espec¨ªfico o establecer un mensaje de error espec¨ªfico. |
|
| ³¢¾±³¾¾±³Ù²¹³¦¾±¨®²Ô | ||
| Descartar sin cambios con latido | Descarte 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 (p. ej., 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 una m¨¦trica de descubrimiento. P. ej., 1 m. Si se pasa texto id¨¦ntico a esta regla dos veces en 60 segundos, se descartar¨¢.Nota: Cambiar los prototipos de m¨¦tricas no restablece la limitaci¨®n. La limitaci¨®n se restablece solo cuando se cambian los pasos de preprocesamiento. |
|
| Prometheus | ||
| Prometheus a JSON | Convertir 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 equipo a trav¨¦s de una 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 los que el JSON devuelto no tiene las macros requeridas ya definidas. Por ejemplo:
La clave nativa
vfs.fs.discoverypara el descubrimiento del sistema de archivos devuelve un JSON con algunas macros LLD predefinidas, como {#FSNAME}, {#FSTYPE}. Estas macros se pueden usar directamente en m¨¦tricas, prototipos de iniciadores (consulte las secciones posteriores de la p¨¢gina); no es necesario definir macros personalizadas;La m¨¦trica del agente
vfs.fs.gettambi¨¦n devuelve un JSON con datos del sistema de archivos, pero sin ninguna macro LLD predefinida. En este caso, puede definir las macros usted mismo y asignarlas a los valores en JSON mediante JSONPath:
Los valores extra¨ªdos se pueden utilizar en m¨¦tricas descubiertas, iniciadores, etc. Tenga en cuenta que los valores se ±ð³æ³Ù°ù²¹±ð°ù¨¢n del resultado del descubrimiento y de cualquier paso de preprocesamiento realizado hasta el momento.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|
| Macro LLD | Nombre de la macro de descubrimiento de bajo nivel, utilizando la siguiente sintaxis: {#MACRO}. |
| JSONPath | Ruta que se utiliza para extraer el valor de la macro LLD de una fila LLD, utilizando la sintaxis JSONPath. Los valores extra¨ªdos del JSON devuelto se utilizan para reemplazar las macros LLD en los campos de prototipo de m¨¦trica, iniciador, etc. JSONPath se puede especificar utilizando la notaci¨®n de punto o la notaci¨®n de corchetes. La notaci¨®n entre corchetes se debe utilizar en el caso de caracteres especiales y Unicode, como $['unicode + special chars #1']['unicode + special chars #2'].Por ejemplo, $.foo ±ð³æ³Ù°ù²¹±ð°ù¨¢ "bar" y "baz" de este JSON: [{"foo": "bar"}, {"foo": "baz"}]Tenga en cuenta que $.foo ±ð³æ³Ù°ù²¹±ð°ù¨¢ "bar" y "baz" tambi¨¦n de este JSON: {"data":[{"foo": "bar"}, {"foo": "baz"}]} porque un ¨²nico objeto "data" se procesa autom¨¢ticamente (para compatibilidad con versiones anteriores con la implementaci¨®n de descubrimiento de bajo nivel en versiones de Áú»¢¶Ä²© anteriores a 4.2). |
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:
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|
| Tipo de c¨¢lculo | Las siguientes opciones para calcular los filtros est¨¢n disponibles: Y - se deben pasar todos los filtros; O - suficiente si se pasa un filtro; Y/O - utiliza Y con diferentes nombres de macro y O con el mismo nombre de macro; Expresi¨®n personalizada - ofrece la posibilidad de definir un c¨¢lculo personalizado de filtros. La f¨®rmula debe incluir todos los filtros de la lista. Limitado a 255 s¨ªmbolos. |
| Filtros | Los siguientes operadores de condici¨®n de filtro est¨¢n disponibles: coincide, no coincide, existe, no existe. Los operadores coincide y no coincide esperan un (PCRE). Por ejemplo, si solo est¨¢ interesado en los sistemas de archivos C:, D: y E:, puede colocar {#FSNAME} en "Macro" y "^C|^D|^E" normal. expresi¨®n en los campos de texto "Expresi¨®n regular". Tambi¨¦n es posible filtrar por tipos de sistema de archivos usando la macro {#FSTYPE} (por ejemplo, "^ext|^reiserfs") y por tipos de unidades (compatibles solo con el agente de Windows) usando la macro {#FSDRIVETYPE} (por ejemplo, " fijo"). Puede ingresar una expresi¨®n regular o hacer referencia a una expresi¨®n regular en el campo "Expresi¨®n regular". Para probar una expresi¨®n regular, puede usar "grep - E", por ejemplo: para f en ext2 nfs reiserfs smbfs; hacer eco $f | grep -E '^ext|^reiserfs' || echo "SALTAR: $f"; done Los operadores Existe y no existe permiten filtrar entidades seg¨²n la presencia o ausencia de la macro LLD especificada en la respuesta. Tenga en cuenta que si una macro del falta el filtro en la respuesta, la entidad encontrada se ignorar¨¢, a menos que se especifique una condici¨®n "no existe" para esta macro. Se mostrar¨¢ una advertencia si la ausencia de una macro afecta el resultado de la expresi¨®n . Por ejemplo, si falta {#B} en: {#A} coincide con 1 y {#B} coincide con 2 - dar¨¢ una advertencia {#A} coincide con 1 o {#B} coincide con 2 - sin previo aviso |
Un error o una errata en la expresi¨®n regular utilizada en la regla LLD (por ejemplo, una expresi¨®n regular de "Sistemas de archivos para descubrimiento" incorrecta ) puede causar la eliminaci¨®n de miles de configuraciones de m¨¦tricas, valores hist¨®ricos y eventos para muchos equipos.
La base de datos Áú»¢¶Ä²© en MySQL debe crearse con distinci¨®n entre may¨²sculas y min¨²sculas si los nombres de los sistemas de archivos que difieren s¨®lo en may¨²sculas y min¨²sculas deben ser descubiertos correctamente.
Reemplazar
La pesta?a Reemplazar permite establecer reglas para modificar la lista de m¨¦tricas, iniciadores, gr¨¢ficos y prototipos de equipos o sus atributos para los objetos descubiertos que cumplen los criterios dados.
Los reemplazos (si los 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 un nuevo reemplazo, haga clic en el bloque 
Reemplazos. Para editar un reemplazo existente, haga clic en el nombre del reemplazo. Se abrir¨¢ una ventana emergente que permitir¨¢ editar los detalles de la regla de reemplazo.
Todos los par¨¢metros obligatorios est¨¢n marcados con asteriscos rojos.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|
| Nombre | Un nombre de reemplazo ¨²nico (seg¨²n la regla LLD). |
| Si el filtro coincide | Define si se deben procesar los siguientes reemplazo cuando se cumplan las condiciones del filtro: Continuar reemplazos: se procesar¨¢n los reemplazos posteriores. Detener procesamiento: operaciones anteriores ( si corresponde) y se ejecutar¨¢ este reemplazo, los reemplazos posteriores se ignorar¨¢n para las filas LLD coincidentes. |
| Filtros | Determina a qu¨¦ entidades descubiertas se debe aplicar el reemplazo. Los filtros de reemplazo se procesan despu¨¦s de la regla de descubrimiento filtros y tienen la misma funcionalidad. |
| Operaciones | Las operaciones de anulaci¨®n se muestran con estos detalles: °ä´Ç²Ô»å¾±³¦¾±¨®²Ô: un tipo de objeto (prototipo de elemento/prototipo de activador/prototipo de gr¨¢fico/prototipo de host) y una condici¨®n que se debe cumplir (es igual/no es igual /contiene/no contiene/coincide/no coincide) ´¡³¦³¦¾±¨®²Ô: se muestran enlaces para editar y eliminar una operaci¨®n. |
Configurando una operaci¨®n
Para configurar los detalles de una nueva operaci¨®n, haga clic en el bloque 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.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô | ||
|---|---|---|---|
| Objeto | Hay cuatro tipos de objetos disponibles: Prototipo de m¨¦trica Prototipo de iniciador Prototipo de gr¨¢fico Prototipo de equipo |
||
| °ä´Ç²Ô»å¾±³¦¾±¨®²Ô | Permite filtrar entidades a las que se debe aplicar la operaci¨®n. | ||
| Operador | Operadores admitidos: es igual a: se aplica a este prototipo no es igual a: se aplica a todos los prototipos, excepto este contiene: se aplica, 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 no coincide - aplicar si el nombre del prototipo no coincide con la expresi¨®n regular |
||
| ±Ê²¹³Ù°ù¨®²Ô | Una expresi¨®n regular o una cadena para buscar. | ||
| Objeto: Prototipo de m¨¦trica | |||
| Crear habilitado | Cuando la casilla de verificaci¨®n est¨¦ marcada, aparecer¨¢n los botones que permitir¨¢n anular la configuraci¨®n original del prototipo de la m¨¦trica: ³§¨ª: la m¨¦trica se agregar¨¢ en un estado habilitado. No: La m¨¦trica se agregar¨¢ a una entidad descubierta pero en un estado deshabilitado. |
||
| Descubrir | Cuando la casilla de verificaci¨®n est¨¦ marcada, aparecer¨¢n los botones que permitir¨¢n anular la configuraci¨®n original del prototipo de la m¨¦trica: ³§¨ª: la m¨¦trica se agregar¨¢. No: la m¨¦trica no se agregar¨¢. |
||
| Intervalo de actualizaci¨®n | Cuando la casilla de verificaci¨®n est¨¦ marcada, aparecer¨¢n dos opciones que permitir¨¢n establecer diferentes intervalos para la m¨¦trica: Retraso - Intervalo de actualizaci¨®n de la m¨¦trica. Se admiten las macros de usuario y los sufijos de tiempo (por ejemplo, 30 s, 1 m, 2 h, 1 d). Debe establecerse en 0 si se utiliza Intervalo personalizado. Intervalo personalizado: haga clic en para especificar intervalos flexibles de programaci¨®n. Para obtener informaci¨®n detallada, consulte Intervalos personalizados. |
||
| Per¨ªodo de almacenamiento del historial | Cuando la casilla de verificaci¨®n est¨¦ marcada, aparecer¨¢n los botones que permitir¨¢n establecer diferentes per¨ªodos de almacenamiento del historial para la m¨¦trica: No conservar el historial: si se selecciona, el historial no ser almacenado. Per¨ªodo de almacenamiento: si se selecciona, aparecer¨¢ un campo de entrada para especificar el per¨ªodo de almacenamiento a la derecha. Se admiten las macros de usuario y las macros LLD. |
||
| Per¨ªodo de almacenamiento de tendencias | Cuando se marca la casilla de verificaci¨®n, aparecer¨¢n los botones que permitir¨¢n establecer diferentes per¨ªodos de almacenamiento de tendencias para la m¨¦trica: No conservar tendencias - si se selecciona, las tendencias no ser¨¢n almacenadas. Per¨ªodo de almacenamiento: si se selecciona, aparecer¨¢ un campo de entrada para especificar el per¨ªodo de almacenamiento a la derecha. Se admiten las macros de usuario y las macros LLD. |
||
| Etiquetas | Cuando se marca la casilla de verificaci¨®n, aparecer¨¢ un nuevo bloque que permitir¨¢ especificar pares de etiqueta-valor. Estas etiquetas se agregar¨¢n a las etiquetas especificadas en el prototipo de la m¨¦trica, incluso si en la etiqueta los nombres coinciden. |
||
| Objeto: Prototipo de iniciador | |||
| Crear habilitado | Cuando la casilla de verificaci¨®n est¨¦ marcada, aparecer¨¢n los botones que permitir¨¢n anular la configuraci¨®n original del prototipo del iniciador: ³§¨ª: el iniciador se agregar¨¢ en un estado habilitado. No: el El iniciador se agregar¨¢ a una entidad descubierta, pero en un estado deshabilitado. |
||
| Descubrir | Cuando la casilla de verificaci¨®n est¨¦ marcada, aparecer¨¢n los botones que permitir¨¢n anular la configuraci¨®n original del prototipo del iniciador: ³§¨ª: se agregar¨¢ el iniciador. No: el iniciador no se agregar¨¢. |
||
| Gravedad | Cuando la casilla de verificaci¨®n est¨¢ marcada, aparecer¨¢n botones de gravedad del iniciador que permitir¨¢n modificar la gravedad del iniciador. | ||
| Etiquetas | Cuando se marca la casilla de verificaci¨®n, aparecer¨¢ un nuevo bloque que permitir¨¢ especificar pares de etiqueta-valor. Estas etiquetas se agregar¨¢n a las etiquetas especificadas en el prototipo del iniciador, incluso si en la etiqueta los nombres coinciden. |
||
| Objeto: Prototipo de gr¨¢fico | |||
| Descubrir | Cuando se marca la casilla de verificaci¨®n, aparecer¨¢n los botones que permitir¨¢n anular la configuraci¨®n original del prototipo del gr¨¢fico: ³§¨ª: se agregar¨¢ el gr¨¢fico. No: no se agregar¨¢ el gr¨¢fico . |
||
| Objeto: Prototipo de equipo | |||
| Crear habilitado | Cuando la casilla de verificaci¨®n est¨¦ marcada, aparecer¨¢n los botones que permitir¨¢n anular la configuraci¨®n original del prototipo del equipo: ³§¨ª: el equipo se crear¨¢ en un estado habilitado. No - el El equipo se crear¨¢ en un estado deshabilitado. |
||
| Descubrir | Cuando la casilla de verificaci¨®n est¨¦ marcada, aparecer¨¢n los botones que permitir¨¢n anular la configuraci¨®n original del prototipo del equipo: ³§¨ª: se descubrir¨¢ el equipo. No: el equipo no ser¨¢ descubierto. |
||
| Plantillas de enlaces | Cuando se marca la casilla de verificaci¨®n, aparecer¨¢ un campo de entrada para especificar plantillas. Comience a escribir el nombre de la plantilla o haga clic en Seleccionar junto al campo y seleccione plantillas de la lista en una ventana emergente. Todas las plantillas vinculadas a un prototipo de host ser¨¢n reemplazadas por plantillas de esta anulaci¨®n. |
||
| Etiquetas | Cuando se marca la casilla de verificaci¨®n, aparecer¨¢ un nuevo bloque que permitir¨¢ especificar pares de etiqueta-valor. Estas etiquetas se agregar¨¢n a las etiquetas especificadas en el prototipo del equipo, incluso si en la etiqueta los nombres coinciden. |
||
| Inventario de equipo | Cuando la casilla de verificaci¨®n est¨¦ marcada, aparecer¨¢n los botones que permitir¨¢n seleccionar los diferentes modos de inventario para el prototipo de equipo: Desactivado - no completar el inventario de equipos Manual - proporcionar detalles manualmente Automatizado - completar autom¨¢ticamente los datos del inventario de equipos seg¨²n las m¨¦tricas recopiladas. |
||
Botones de formulario
Los botones en la parte inferior del formulario permiten realizar varias operaciones.
 |
Agregar una regla de descubrimiento. Este ²ú´Ç³Ù¨®²Ô s¨®lo est¨¢ disponible para nuevas reglas de descubrimiento. |
 |
Actualizar las propiedades de una regla de descubrimiento. Este ²ú´Ç³Ù¨®²Ô s¨®lo est¨¢ disponible para reglas de descubrimiento existentes. |
 |
Crear otra regla de descubrimiento basada en las propiedades de la regla de descubrimiento actual. |
 |
Realizar el descubrimiento seg¨²n la regla de descubrimiento inmediatamente. La regla de descubrimiento ya debe existir. Consulte m¨¢s detalles. Tenga en cuenta que cuando se realiza el descubrimiento inmediatamente, la cach¨¦ de configuraci¨®n no se actualiza, por lo que el resultado no reflejar¨¢ cambios muy recientes en la configuraci¨®n de la regla de descubrimiento. |
 |
Eliminar la regla de descubrimiento. |
 |
Cancelar la edici¨®n de las propiedades de la regla de descubrimiento. |
Entidades descubiertas
Las capturas de pantalla siguientes ilustran c¨®mo las m¨¦tricas descubiertas, los iniciadores y los gr¨¢ficos se ven en la configuraci¨®n del equipo. Las entidades descubiertas van 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 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 indicando que el nivel m¨¢s bajo de la regla de descubrimiento no pudo crear ciertas entidades. La regla del descubrimiento sin embargo, no quedar¨¢ sin soporte porque alguna entidad no pueda ser creada y tuvo que ser omitida. La regla de descubrimiento continuar¨¢ creando/actualizando otras entidades.
Si una entidad descubierta (equipo, 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 desactivarse autom¨¢ticamente y eventualmente eliminarse.
Los recursos perdidos pueden desactivarse autom¨¢ticamente seg¨²n el valor del par¨¢metro Desactivar recursos perdidos. Esto afecta a los equipos, m¨¦tricas e iniciadores perdidos.
Los recursos perdidos se pueden eliminar autom¨¢ticamente seg¨²n el valor del par¨¢metro Eliminar recursos perdidos. Esto afecta a los hosts perdidos, a los grupos de equipos, a las m¨¦tricas, a los iniciadores y a los gr¨¢ficos.
Cuando las entidades descubiertas pasan a ser 'No descubiertas m¨¢s', se muestra en la lista de entidades un indicador de tiempo de existencia. Mueva el puntero del mouse sobre ¨¦l. y se mostrar¨¢ un mensaje indicando los detalles de su estado.
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 equipos), 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 actualiza si se modifica en el nivel de la regla de descubrimiento. Por ejemplo, los iniciadores basados en LLD no se actualizar¨¢n si contienen m¨¦tricas marcados para su eliminaci¨®n.
Otros tipos de descubrimiento
M¨¢s detalles e instrucciones sobre otros tipos de descubrimientos listos para usar est¨¢n en disponible 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 ODBC SQL;
- descubrimiento de servicios Windows;
- descubrimiento de interfaces de equipo en Áú»¢¶Ä²©.
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 la creaci¨®n de reglas LLD personalizadas.