Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

3 Ejemplos de preprocesamiento

Descripción general

Esta sección presenta ejemplos de uso de pasos de preprocesamiento para realizar algunas tareas prácticas.

Filtrado de registros del registro de eventos de VMware

Este ejemplo utiliza el paso de preprocesamiento Coincide con expresión regular para filtrar eventos innecesarios del registro de eventos de VMware.

1. En un equipo VMware Hypervisor en funcionamiento, verifique que la métrica vmware.eventlog esté presente y funcionando correctamente. Tenga en cuenta que la métrica del registro de eventos podría estar ya presente en el hipervisor si se ha vinculado una plantilla VMware durante la creación del equipo.

2. En el equipo VMware Hypervisor, cree una métrica dependiente de tipo Log y establezca la métrica del registro de eventos como su métrica principal.

3. En la pestaña Preprocesamiento de la métrica dependiente, haga clic en Añadir para crear un paso de preprocesamiento y seleccione Coincide con expresión regular en el menú desplegable. Luego, especifique uno de los siguientes patrones:

  • Para filtrar todos los eventos del registro:
.* logged in .*
  • Para filtrar líneas que contienen nombres de usuario después de "User":
\bUser\s+\K\S+

Si la expresión regular no coincide, la métrica dependiente se vuelve no soportada con un mensaje de error correspondiente. Para evitar esto, marque la casilla Personalizado en caso de error y seleccione una opción como descartar el valor o establecer uno personalizado. Tenga en cuenta que los valores descartados no se almacenan en la base de datos; como resultado, los disparadores no se evalúan y no se generan datos de tendencias.

Alternativamente, puede utilizar el paso de preprocesamiento Expresión regular para extraer grupos coincidentes y controlar la salida:

  • Para extraer y mostrar todo el evento del registro que contiene "logged in", especifique los siguientes parámetros:
Patrón: .*logged in.*
       Salida: \0
  • Para extraer y mostrar nombres de usuario que siguen a "User":
Patrón: User (.*?)(?=\ )
       Salida: \1

Comprobación del tipo de valor recuperado

Este ejemplo utiliza el paso de preprocesamiento Multiplicador personalizado para comprobar si el tipo de valor de la métrica recuperada es numérico.

En la pestaña Preprocesamiento de una métrica, seleccione el paso de preprocesamiento Multiplicador personalizado y especifique el siguiente parámetro (multiplica el valor recuperado por 1):

1

Si el preprocesamiento falla (por ejemplo, la entrada no es numérica), la métrica se vuelve no soportada con un mensaje de error correspondiente. Para evitar esto, marque la casilla Personalizado en caso de error y seleccione una opción como descartar el valor o establecer uno personalizado. Tenga en cuenta que los valores descartados no se almacenan en la base de datos; como resultado, los disparadores no se evalúan y no se generan datos de tendencias.

Comprobación de valor no soportado

Este ejemplo utiliza el paso de preprocesamiento Comprobar valor no soportado para verificar si no se pudo recuperar el valor de la métrica.

Cuando un proceso poller de Zabbix server/proxy intenta recopilar el valor de una métrica, puede:

  • Devolver un resultado válido.
  • Devolver un resultado que inicialmente parece válido pero que puede volverse no soportado más adelante (por ejemplo, debido a una incompatibilidad de tipo de valor después del preprocesamiento).
  • Devolver un error al recopilar el valor, haciendo que la métrica se vuelva no soportada. Las causas comunes incluyen:
    • Clave de métrica desconocida (para Zabbix agent, Comprobación simple o métricas internas de Zabbix)
    • OID desconocido (agente SNMP), sensor desconocido (agente IPMI) o métrica JMX no encontrada (agente JMX)
    • No se puede leer el archivo de traps (trap SNMP)
    • Script no encontrado (Comprobación externa)
    • URL inexistente (agente HTTP, Navegador)
    • Error de inicio de sesión (agente SSH, agente TELNET)
    • Sintaxis de fórmula no válida (Calculada), error de sintaxis de JavaScript (Script) o SQL no válido (Monitor de base de datos)

Para detectar y manejar errores al recopilar valores de métricas, puede utilizar el paso de preprocesamiento Comprobar valor no soportado. Tenga en cuenta que este paso siempre se ejecuta primero y solo detecta errores que ocurren antes de que comience el preprocesamiento.

En la pestaña Preprocesamiento de una métrica, seleccione el paso de preprocesamiento Comprobar valor no soportado y especifique uno de los siguientes parámetros:

  • Para cualquier error:
Parámetro: any error
  • Para errores que contengan "cannot connect":
Parámetro: error matches
       Patrón: (?i)cannot connect

Luego, utilice la opción Personalizado en caso de fallo para descartar el valor (en este caso, el error), establecer un valor personalizado o devolver un mensaje de error personalizado. Tenga en cuenta que los valores descartados no se almacenan en la base de datos; como resultado, no se evalúan disparadores ni se generan datos de tendencias.